 |
Index for
Section 8 |
|
 |
Alphabetical
listing for S |
|
 |
Bottom of
page |
|
sysconfig(8)
NAME
sysconfig - 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
-c subsys (configure)
Configures the specified subsystem by initializing its attribute values
and, possibly, loading it into the kernel.
-d subsys (display)
Display the attribute settings in the /etc/sysconfigtab file for the
specified subsystem.
-h hostname
Specifies that the operation be performed on system hostname.
-i index
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.
-m [subsys]... (mode query)
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.
-o opcode subsys [attrib=value] (operation code)
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
-q [subsys] [attribute]... (query attribute)
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.
-Q [subsys] [attribute]... (query attribute information)
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.
-r subsys attrib=value [attrib=value]... (reconfigure)
Reconfigures the specified subsystem. You must supply the subsys
argument and one or more attrib=value arguments when you use this
option.
-s [subsys]... (subsysten state)
Queries the subsystem state for the specified subsystems. If you omit
the subsystem name, sysconfig displays the state of all the configured
subsystems.
-u subsys (unconfigure)
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.
-v (verbose)
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 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 us a sys_attrs* reference page for many commonly-tuned 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
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
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
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
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
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
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
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
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
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.
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 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.
EXIT STATUS
0 (Zero)
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.
1 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.
EXAMPLES
1. 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.
2. 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.
3. 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.
4. 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.
5. 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
/sbin/cfgmgr
The configuration management server command path
/sbin/kloadsrv
The kernel load server daemon command path
/etc/cfgmgr.auth
The configuration management authorization database
/etc/sysconfigtab
The configuration database
SEE ALSO
Commands: autosysconfig(8), cfgmgr(8), dxkerneltuner(8), sysconfigdb(8),
kloadsrv(8)
Files: sysconfigtab(4), cfgmgr.auth(4)
Misc: sys_attrs(5)
System Administration
|
Index for
Section 8 |
|
|
Alphabetical
listing for S |
|
 |
Top of
page |
|