LCTL-FIND_PARAM(8)

NAME
lctl-find_param - search for parameters matching patterns

SYNOPSIS
lctl find_param [--color|-c auto|always|never] [--links|-l] [--no-links|-L] [--merge|-m] [--no-merge|-M] [--module|-o] [--path|-p] PATTERN1 [PATTERN2 ...]

DESCRIPTION
Search recursively for parameter names matching the given PATTERN(s). The patterns use extended regular expressions. This command is equivalent to 'lctl list_param -R "*" | grep -E PATTERN | xargs lctl get_param'

OPTIONS
The various options supported by lctl find_param are listed and explained below:

-c, --color=auto|always|never
    Use one of auto|always|never as the rule of when to apply color. The default is auto which will display color only when the output is to a terminal.

-l ,  --links
    Follow symlinks while searching for parameters. (enabled by default)

-L ,  --no-links
    Do not follow symlinks while searching for parameters.

-m ,  --merge
    Merge all parameters that have the same name such that only one will be shown. Enabled by default.

-M ,  --no-merge
    Do not merge parameters. All parameters will be shown, regardless if they are duplicates or not. Duplicate parameters will be printed in yellow.

-n ,  --no-name
    Print only the parameter value of the matched parameter name. This may be confusing as the parameters will not be identified as to which ones matched the given pattern and can appear in any order.

-N ,  --only-name
    Print only matched parameter names and not the values. This option is equivalent to 'lctl list_param -R "*" | grep -E PATTERN' which is useful to avoid printing copies of the same parameter when their values are different like many of the '.stats' parameters.

-o, --module
    Include modules params in the parameter search path, meaning that matching module parameters will be shown along side with Lustre parameters.

-p ,  --path
    Print the parameter path instead of the parameter name.

EXAMPLES
Find parameters without needing the full path:
    # lctl find_param -N brw
    obdfilter.testfs-OST0000.brw_size
    obdfilter.testfs-OST0001.brw_size
    osd-ldiskfs.testfs-MDT0000.brw_stats
    osd-ldiskfs.testfs-OST0000.brw_stats
    osd-ldiskfs.testfs-OST0001.brw_stats

Use regular expressions to find parameters:
    # lctl find_param -N [a-zA-Z0-9]{16}.*stats
    ldlm.namespaces.testfs-MDT0000-mdc-ffff8bc577dce000.pool.stats
    ldlm.namespaces.testfs-OST0000-osc-ffff8bc577dce000.pool.stats
    ldlm.namespaces.testfs-OST0001-osc-ffff8bc577dce000.pool.stats
    llite.testfs-ffff8bc577dce000.stats_track_gid
    llite.testfs-ffff8bc577dce000.stats_track_pid
    llite.testfs-ffff8bc577dce000.stats_track_ppid
    llite.testfs-ffff8bc577dce000.extents_stats
    llite.testfs-ffff8bc577dce000.extents_stats_per_process
    llite.testfs-ffff8bc577dce000.offset_stats
    llite.testfs-ffff8bc577dce000.read_ahead_stats
    llite.testfs-ffff8bc577dce000.statahead_stats
    llite.testfs-ffff8bc577dce000.stats
    llite.testfs-ffff8bc577dce000.unstable_stats
    lmv.testfs-clilmv-ffff8bc577dce000.md_stats
    mdc.testfs-MDT0000-mdc-ffff8bc577dce000.stats
    mdc.testfs-MDT0000-mdc-ffff8bc577dce000.batch_stats
    mdc.testfs-MDT0000-mdc-ffff8bc577dce000.md_stats
    mdc.testfs-MDT0000-mdc-ffff8bc577dce000.mdc_stats
    mdc.testfs-MDT0000-mdc-ffff8bc577dce000.rpc_stats
    mdc.testfs-MDT0000-mdc-ffff8bc577dce000.unstable_stats
    osc.testfs-OST0000-osc-ffff8bc577dce000.stats
    osc.testfs-OST0000-osc-ffff8bc577dce000.osc_stats
    osc.testfs-OST0000-osc-ffff8bc577dce000.rpc_stats
    osc.testfs-OST0000-osc-ffff8bc577dce000.unstable_stats
    osc.testfs-OST0001-osc-ffff8bc577dce000.stats
    osc.testfs-OST0001-osc-ffff8bc577dce000.osc_stats
    osc.testfs-OST0001-osc-ffff8bc577dce000.rpc_stats
    osc.testfs-OST0001-osc-ffff8bc577dce000.unstable_stats

lctl find_param will only search the parameter name, not the value:
    # lctl get_param debug_path
    debug_path=/tmp/lustre-log

    # lctl find_param lustre | grep debug_path

AVAILABILITY
lctl find_param is part of the lustre(7) filesystem package since release 2.17.0

SEE ALSO
lfs(1), lustre(7), lctl-get_param(8), lctl-list_param(8), lctl-set_param(8)