sysconfig(8) System Manager's Manual sysconfig(8)
sysconfig - Maintains the kernel subsystem configuration
/sbin/sysconfig [-h hostname] [-i index] [-o opcode] [-v] -c | -d | -m | -q | -Q | -r | -s | -u [subsystem-name] [attribute-list]
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. Speci-
fies the index to be used for querying or reconfiguring indexed attributes. 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
system-defined 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 val-
ues for the configured subsystem specified by subsystem-name. If you omit attribute-list, values of all the specified subsystem's
attributes are displayed. Queries information about attributes of the configured subsystem specified by subsystem-name. 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 sub-
system-name argument and the attribute-list argument when you use this flag. 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 load-
able, unloads the specified subsystem from the kernel. (Verbose) This flag 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 sym-
bols from dynamically linked modules.
The sysconfig command is used to query or modify the kernel subsystem configuration. You 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, so long as the subsystem supports run-time modi-
fications. (You can also use the dxkerneltuner application to modify the value of subsystem attributes. This application provides a win-
dow interface to tuning kernel subsystems. For more information, see dxkerneltuner(8).)
The first argument to the sysconfig command is the subsystem-name argument. The subsystem-name argument names the subsystem on which you
want to perform the operation specified by one of the required flags, such as the -c (configure) flag or the -q (query attributes) flag.
The subsystem-name argument is required for all flags except -s and -m. If you omit subsystem-name when you use one of these flags, the
sysconfig command displays information about all loaded subsystems.
The attribute-list argument lists attribute names and, depending on the operation, attribute values. For reconfigure operations (-r), the
attribute-list argument has the following format:
You cannot include spaces between the attribute name, the equal sign (=), and the value.
For query attribute (-q) operations, the attribute-list has the following format:
The attribute-list argument is required when you use the -r flag and is options with the -q flag. Any attribute-list specifies with other
flags is ignored by the sysconfig command.
When you configure a subsystem using the -c flag, 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. (You control the contents of the /etc/sysconfigtab file with the sysconfigdb command. See the sysconfigdb(8) reference
page for more information.)
If you want to modify the value of a subsystem attribute, you use the -r (reconfigure) flag. When you use the -r flag, the sysconfig com-
mand 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.
To get information about subsystem attributes, use either the -q flag or the -Q flag. You can specify an attribute list with both these
flags. When you use the -q flag, the sysconfig command reads the value of attributes from the kernel and displays those values on your
local display. When you use the -Q flag, the sysconfig command displays the following information about either each attribute in the sub-
system or, if specified, each attribute in the attribute-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
Use the -m flag to determine whether a subsystem supports being added and removed from the kernel using the sysconfig -c or sysconfig -u
command. The -m flag 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 subsystem-
name argument, the sysconfig command displays this information for all loaded and configured subsystems.
To get information about the state of subsystems, use the -s flag. This flag provides a list of the subsystems that are currently loaded
and configured into the kernel. If you specify subsystem-name, 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
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.
Subsystems that are not being used can be unconfigured using the -u flag. 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.
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 flag. 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
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, reconfigura-
tion, 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.
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 attr2 attr3
When both -i and a subscript are specified, the subscript takes precedence. However, when no subscript is specified, the -i applies pro-
viding the attribute is an array attribute.
The command sysconfig -Q cannot be used to query an individual array element.
The following list shows examples of using the sysconfig command: To display all the subsystems configured in the local kernel, enter the
# sysconfig -s
Used without arguments, the -s flag displays information about the state of all subsystems on the local system. To configure a sub-
system into the kernel, use the -c flag, 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 flag:
# 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 flag causes the sysconfig command to display debugging information, which may be displayed to the con-
sole. 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 sysconfig program returns zero after successful completion of the specified operation. If an operation fails, the program returns one.
If you specify multiple attributes in a single sysconfig operation, a zero is returned if at least one attribute operation is successful.
A one is only returned if the sysconfig operation fails on every attribute.
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)
System Administration delim off