sysconfig(8)sysconfig(8)NAMEsysconfig - Maintains the kernel subsystem configuration
SYNOPSIS
/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]...
OPTIONS
Configures the specified subsystem by initializing its attribute values
and, possibly, loading it into the kernel. Display the attribute set‐
tings in the /etc/sysconfigtab file for the specified subsystem. Spec‐
ifies 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 dis‐
plays 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 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 sub‐
system 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, respec‐
tively. 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 sub‐
system 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.
DESCRIPTION
The sysconfig command is used to query or modify the kernel subsystem
configuration. Use this command to add subsystems to your running ker‐
nel, reconfigure subsystems already in the kernel, ask for information
about (query) subsystems in the kernel, and unconfigure and remove sub‐
systems from the kernel.
A subset of kernel subsystems can be managed using the sysconfig com‐
mand. 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 dxk‐
erneltuner(8).
There is a sys_attrs* reference page for many commonly-tuned subsys‐
tems, 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
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 dis‐
plays information about all loaded subsystems.
Attribute Lists
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) opera‐
tions, 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
When you configure a subsystem using the -c option, you make that sub‐
system 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) ref‐
erence page for more information.
Modifying Subsystem Attributes
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 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.
Querying Subsystem Attributes
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 dis‐
plays the following information about either each attribute in the sub‐
system 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
Use the -m option to determine whether a subsystem supports being added
and removed from the kernel using the sysconfig-c or sysconfig-u com‐
mand. 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 con‐
figured subsystems.
Query Subsystem State
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 auto‐
matically unloaded from the kernel when you unconfigure them
with the sysconfig-u command.
Unconfigure Subsets
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 load‐
able subsystem that supports run-time unconfiguration. If you uncon‐
figure a loadable subsystem, that subsystem is also unloaded from the
kernel.
Configuring Remote Systems
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 con‐
figure, reconfigure, query attributes, query subsystem state, or uncon‐
figure 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, recon‐
figure, 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 uncon‐
figuration 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) ref‐
erence page for more information about the cfgmgr.auth file and its
format.
Configuring Trucluster Server Members
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
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 charac‐
ters. For example: # sysconfig-q subsys1 attr1\[0\] attr2 attr3
When both -i and a subscript are specified, the subscript takes prece‐
dence. However, when no subscript is specified, the -i applies provid‐
ing the attribute is an array attribute.
The command sysconfig-Q cannot be used to query an individual array
element.
EXIT STATUS
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 opera‐
tion, a one is only returned if the sysconfig operation fails on every
attribute.
EXAMPLES
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 ker‐
nel. 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
FILES
The configuration management server command path The kernel load server
daemon command path The configuration management authorization database
The configuration database
SEE ALSO
Commands: autosysconfig(8), cfgmgr(8), dxkerneltuner(8), syscon‐
figdb(8), kloadsrv(8)
Files: sysconfigtab(4), cfgmgr.auth(4)
Misc: sys_attrs(5)
System Administration
sysconfig(8)
