lsattr(1M) — ADMINISTRATOR COMMANDS
NAME
lsattr − list information about the system tunable parameters that a module includes
SYNOPSIS
/usr/sbin/lsattr {−D[-O] | -E[-O] | - F format} [-H] -l name [-a attribute]...
/usr/sbin/lsattr − R -l name -a attribute [-H]
/usr/sbin/lsattr -h
DESCRIPTION
lsattr displays system tunable parameters, the current values of those parameters, the default or factory value settings for those parameters, suggested parameter value ranges, parameter descriptions, and a flag that indicates if you can safely modify the values of the parameters.
You must specify one of these options:
-D displays the parameter name, its default value, its description, and the tunable flag.
This option can not be used along with the -E, -F, or -R options.
-E displays the parameter name, its current value, its description, and the tunable flag.
This option can not be used along with the-D, -F, or -R options.
-F format displays the parameter information in a format that you specify.
format is a list, contained within quote marks, of column names separated from each other by spaces or by non-alphanumeric characters.
Valid column names are parameter, value, default, description, and tunable.
The output is displayed in columns separated by white space.
This option can not be used with the -D, -E, or -R options.
-R displays the range of suggested value limits.
Other options are:
-a parameter displays information for the parameters specified by parameter. You can specify multiple parameters with a single -a option. When you do so, you must separate the parameters with spaces and enclose all of the parameters within quote marks.
Alternatively, you can use multiple -a options to specify multiple parameters.
This option is required when you specify the -R option.
-H displays headings above the column output. This option is ignored whenever it is used with the -O or the -R option.
-h displays the command usage message.
-l specifies the module whose parameters are to be displayed. This is a required option.
-O displays parameter information in a list of items that are separated from each other by colons.
The first line of the output begins with the # character and displays the parameter names.
The second line of the output displays the parameter values that you specified with the -E or -D option.
This option can only be used if you have also specified the -D or the -E option.
EXAMPLES
If you wished to list the current values for the msg module, you would enter the following:
ls -l msg -E
You would see a display similar to the following:
MSGMAP 100 size of the message segments control map true MSGMAX 2048 max size of a message true MSGMNB 4096 max length of a message queue true MSGMNI 50 max # of system message ids true MSGSSZ 8 size (in bytes) of a message segment true MSGTQL 40 # of system message headers true MSGSEG 1024 # of system message segments true
If you used the -O option, you would see a display similar to the following:
#MSGMAP:MSGMAX:MSGMNB:MSGMNI:MSGSSZ:MSGTQL:MSGSEG 100:2048:4096:50:8:40:1024
If you wished to list the default values for the msg module, you would enter the following:
lsattr -l msg -D
You would see a display similar to the following:
MSGMAP 100 size of the message segments control map true MSGMAX 2048 max size of a message true MSGMNB 4096 max length of a message queue true MSGMNI 50 max # of system message ids true MSGSSZ 8 size (in bytes) of a message segment true MSGTQL 40 # of system message headers true MSGSEG 1024 # of system message segments true
If you wished to list the current value of the NPROC tunable parameter for the
kernel module, you would enter the following:
lsattr -E -l kernel -a NPROC
You would see a display similar to the following:
NPROC 800 # of process table entries true
If you wished to list the suggested range of values for the kernel module’s NPROC tunable parameter, you would enter the following:
lsattr -R -l kernel -a NPROC
You would see a display similar to the following:
50..5000(+1)
The format of the range string is:
"min value..max value(increment)"
Other possible range strings are:
"not applicable" or ""
min value and max value are one of the following:
parameter is any valid parameter name. The value of the parameter name is the suggested minimum or maximum value. parameter can also be used in an arithmetic expression (e.g., must be twice NPROC: NPROC∗2).
UNKNOWN_MIN
indicates that no suggested minimum value currently exists.
UNKNOWN_MAX
indicates that no suggested maximum value currently exists.
~x is an approximate minimum or maximum value.
x is a recommended minimum or maximum value.
increment must be in the following form:
(+x) increments by x. (x can be the token UNKNOWN.)
(∗x) increments by multiples of x.
(^x) increments in powers of x.
NOTES
The values that lsattr displays are those currently stored in the master files. These displayed values may not indicate the current values in the kernel until you use buildsys to rebuild the kernel and then reboot the system.
The parameter ranges that are displayed are the suggested value limits for each parameter and may not indicate the absolute values limits for the parameters. The maximum value limits for the parameters can be affected by other parameters and by machine configurations.
The tunable column indicates whether you can safely change a parameter’s value. Neither the system nor any system utilities prevent you from entering values outside the absolute ranges.