sysconfig - Maintains the kernel subsystem configuration
/sbin/sysconfig [-h hostname] [-v] { -c | -d | -u }
subsys
/sbin/sysconfig [-h hostname] [-i index] [-v] { -m | -s
} [subsys]...
/sbin/sysconfig [-h hostname] [-v] -o opcode subsys
[attr=value]
/sbin/sysconfig [-h hostname] [-i index] [-v] { -q | -Q
} subsys [attribute]...
/sbin/sysconfig [-h hostname] [-i index] [-v] -r subsys
attrib=value [attrib=value]...
Configures the specified subsystem by initializing its
attribute values and, possibly, loading it into the kernel.
Display the attribute settings in the /etc/sysconfigtab
file for the specified subsystem. Specifies that
the operation be performed on system hostname. Specifies
the index to be used for querying or reconfiguring indexed
attributes. This option can be used with the -m, -s, -q,
-Q, or -r options. Queries the mode for the specified
subsystems. A subsystem's mode can be static or dynamic.
If you omit the subsystem name, sysconfig displays the
mode of all the configured subsystems. Perform a systemdefined
operation corresponding to the specified operation
code (opcode). The opcode function must be implemented for
the specified subststem. Optionally, pass an attribute and
value as input data. For example: # sysconfig -o proc 101
maxusers=512 Queries attribute values for the configured
subsystem specified by subsys. If you omit the attribute
list, values of all the specified subsystem's attributes
are displayed. Queries information about attributes of
the configured subsystem specified by subsys. The information
includes the attribute data type, the operations supported,
and the minimum and maximum values allowed for the
attribute. Note that the minimum and maximum values means
length and size for attributes of char and binary types,
respectively. If you omit the attribute list, information
about all attributes in the specified subsystem is displayed.
Reconfigures the specified subsystem. You must
supply the subsys argument and one or more attrib=value
arguments when you use this option. Queries the subsystem
state for the specified subsystems. If you omit the subsystem
name, sysconfig displays the state of all the configured
subsystems. Unconfigures and, if the subsystem is
loadable, unloads the specified subsystem from the kernel.
You must specify the subsys argument when you use this
option. This option displays debugging information from
the cfgmgr server and the kloadsrv. The kloadsrv loader
output is sent to /dev/console. This information can be
used to determine the names of any unresolved symbols from
dynamically linked modules.
The sysconfig command is used to query or modify the kernel
subsystem configuration. Use this command to add subsystems
to your running kernel, reconfigure subsystems
already in the kernel, ask for information about (query)
subsystems in the kernel, and unconfigure and remove subsystems
from the kernel.
A subset of kernel subsystems can be managed using the
sysconfig command. This command allows you to add and
remove loadable subsystems from the running kernel. It
also allows you to modify the value of subsystem
attributes if the subsystem supports run-time modifications.
You can also use the dxkerneltuner application to modify
the value of subsystem attributes. This application provides
a graphical user interface for tuning kernel subsystems.
For more information, see dxkerneltuner(8).
There is a sys_attrs* reference page for many commonlytuned
subsystems, such as sys_attrs_vm(5). These reference
pages define each attribute, describe the impact of
changing it, and provide a definitive list of supported
values. See sys_attrs(5) for a complete list of
sys_attrs* reference pages.
Subset Specification [Toc] [Back]
The first argument to the sysconfig command is the subsys
argument. The subsys argument names the subsystem on
which you want to perform the operation specified by one
of the required options, such as the -c (configure) option
or the -q (query attributes) option. The subsys argument
is required for all options except -s and -m. If you omit
subsys when you use one of these options, the sysconfig
command displays information about all loaded subsystems.
Attribute Lists [Toc] [Back]
The attribute list arguments specify attribute names and,
depending on the operation, attribute values. For the -r
(reconfigure) option, the attribute list has the following
format:
attribute1=value1 attribute2=value2...
You cannot include spaces between the attribute name, the
equal sign (=), and the value.
For query attribute (-q) and query attribute information
(-Q) operations, the attr-list has the following format:
attribute1 attribute2...
The attribute list argument is required when you use the
-r option and is options with the -q and -Q option. Any
attribute list specified with other options is ignored by
the sysconfig command.
Configuring Subsystems [Toc] [Back]
When you configure a subsystem using the -c option, you
make that subsystem available for use. If the subsystem
is loadable, the sysconfig command loads the subsystem and
then initializes the value of its attributes. The command
reads information from an in-memory copy of the
/etc/sysconfigtab file to determine the initial value of
attributes. Attributes that are omitted from the
/etc/sysconfigtab file are given their default value. Use
the sysconfigdb command to control the contents of the
/etc/sysconfigtab file. See the sysconfigdb(8) reference
page for more information.
Modifying Subsystem Attributes [Toc] [Back]
If you want to modify the value of a subsystem attribute,
you use the -r (reconfigure) option. When you use the -r
option, the sysconfig command modifies the named
attributes by storing the value you specify in them. The
modifications take effect immediately. To store the
attribute values so that they are used the next time the
subsystem is configured, you must modify the /etc/sysconfigtab
file. Use the sysconfigdb command to modify the
/etc/sysconfigtab file, as described on the sysconfigdb(8)
reference page.
Querying Subsystem Attributes [Toc] [Back]
To get information about subsystem attributes, use either
the -q option or the -Q option. You can specify an
attribute list with both these options. When you use the
-q option, the sysconfig command reads the value of
attributes from the kernel and displays those values on
your local display. When you use the -Q option, the
sysconfig command displays the following information about
either each attribute in the subsystem or, if specified,
each attribute in the attr-list: Attribute datatype.
Operations supported by the attribute. This information
indicates, for example, whether you can reconfigure the
attribute using the sysconfig -r command. Minimum and
maximum allowed attribute value.
Query Subsystem Mode [Toc] [Back]
Use the -m option to determine whether a subsystem supports
being added and removed from the kernel using the
sysconfig -c or sysconfig -u command. The -m option displays
the subsystem name and indicates whether that subsystem
is static (you must rebuild the kernel to add or
remove it from the kernel) or dynamic (you can load and
unload it from the kernel using the sysconfig command).
If you omit the subsys argument, the sysconfig command
displays this information for all loaded and configured
subsystems.
Query Subsystem State [Toc] [Back]
Use the -s option to get information about the state of
subsystems. This option provides a list of the subsystems
that are currently loaded and configured into the kernel.
If you specify subsys, the command displays information
about the state of that subsystem. Each subsystem can
have one of three states: Loaded and configured (available
for use) Loaded and unconfigured (not available for use,
but still loaded)
This state applies only to static subsystems, which
can be unconfigured but cannot be unloaded.
Unloaded (not available for use)
This state applies only to loadable subsystems,
which are automatically unloaded from the kernel
when you unconfigure them with the sysconfig -u
command.
Unconfigure Subsets [Toc] [Back]
Subsystems that are not being used can be unconfigured
using the -u option. Unconfiguring subsystems can help
save kernel memory, making it available for other uses.
You can unconfigure any static or loadable subsystem that
supports run-time unconfiguration. If you unconfigure a
loadable subsystem, that subsystem is also unloaded from
the kernel.
Configuring Remote Systems [Toc] [Back]
When you issue the sysconfig command, it opens a communications
socket to a cfgmgr configuration management server
on the target system. The target system can be your local
system or a remote system specified by the -h option. The
sysconfig command uses the socket to send the configure,
reconfigure, query attributes, query subsystem state, or
unconfigure request. The sysconfig command receives output
from the cfgmgr.
You can use the sysconfig command to display the value of
attributes on any system, local or remote. However, if
you want to configure, reconfigure, or unconfigure a subsystem,
you must be authorized to modify the kernel configuration
on the target host. By default, the superuser
(root login) can configure, reconfigure, or unconfigure
the subsystems on the local host. To allow configuration,
reconfiguration, or unconfiguration on a remote host, the
file /etc/cfgmgr.auth must exist. This file lists each
host that is allowed to configure, reconfigure, or unconfigure
subsystems on the local host. See the cfgmgr.auth(4) reference page for more information about the
cfgmgr.auth file and its format.
Configuring Trucluster Server Members [Toc] [Back]
In a TruCluster Server environment, the sysconfig command
uses the cluster interconnect to send requests to reconfigure,
query attributes, and query subsystem states of
kernel subsystems on different cluster members. The
sysconfig command receives output from these commands
across the cluster interconnect. The cluster interconnect
is not used for the sysconfig configure and unconfigure
commands.
Using the cluster interconnect for these commands allows
querying or modification attributes on members that are
hung or on members that do not have an external interface
between cluster members.
Array Attributes [Toc] [Back]
Because the square bracket ([ and ]) characters have special
meaning to the UNIX shell, when you try to query or
reconfigure individual array elements from the shell command
line, you must escape these two characters. For example:
# sysconfig -q subsys1 attr1\[0\] attr2 attr3
When both -i and a subscript are specified, the subscript
takes precedence. However, when no subscript is specified,
the -i applies providing the attribute is an array
attribute.
The command sysconfig -Q cannot be used to query an individual
array element.
Specified operation completed successfully. If you specify
multiple attributes in a single sysconfig operation, a
zero is returned if at least one attribute operation is
successful. Specified operation failed. If you specify
multiple attributes in a single sysconfig operation, a one
is only returned if the sysconfig operation fails on every
attribute.
To display all the subsystems configured in the local kernel,
enter the following command: # sysconfig -s
Used without arguments, the -s option displays
information about the state of all subsystems on
the local system. To configure a subsystem into
the kernel, use the -c option, as shown: # sysconfig
-c cmftest
This command configures a subsystem named cmftest
into the kernel. If the subsystem is loadable, it
is also loaded in response to this command. To
query a subsystem on a remote host, issue a command
such as the following one: # sysconfig -h salmon -q
ipc
This command displays information about the ipc
subsystem on host salmon. To reconfigure an
attribute, use the -r option: # sysconfig -h salmon
-r cmftest maxlen=255 -v
This command modifies the cmftest subsystem by setting
its maxlen attribute equal to 255. The
cmftest subsystem on the remote host salmon is modified.
The -v option causes the sysconfig command
to display debugging information, which may be displayed
to the console. To display the current settings
of attributes in the /etc/sysconfigtab file,
use the -d option as follows: # sysconfig -d
generic generic: memberid = 0 new_vers_high =
1441151880873377792 new_vers_low = 15044
The configuration management server command path The kernel
load server daemon command path The configuration management
authorization database The configuration database
Commands: autosysconfig(8), cfgmgr(8), dxkerneltuner(8),
sysconfigdb(8), kloadsrv(8)
Files: sysconfigtab(4), cfgmgr.auth(4)
Misc: sys_attrs(5)
System Administration
sysconfig(8)
[ Back ] |
