 |
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] [-i index] [-o opcode] [-v] -c | -d | -m | -q
| -Q | -r | -s | -u [subsystem-name] [attribute-list]
FLAGS
-c Configures the specified subsystem by initializing its attribute
values and, possibly, loading it into the kernel.
-d 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.
-m 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 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 Queries attribute values for the configured subsystem specified
by subsystem-name. If you omit attribute-list, values of all the
specified subsystem's attributes are displayed.
-Q 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.
-r Reconfigures the specified subsystem. You must supply the
subsystem-name argument and the attribute-list argument when you
use this flag.
-s Queries the subsystem state for the specified subsystems. If you
omit the subsystem name, sysconfig displays the state of all the
configured subsystems.
-u Unconfigures and, if the subsystem is loadable, unloads the
specified subsystem from the kernel.
-v (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 symbols from dynamically linked
modules.
DESCRIPTION
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 modifications. (You
can also use the dxkerneltuner application to modify the value of subsystem
attributes. This application provides a window 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:
attribute1=value1 attribute2=value2...
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:
attribute1 attribute2...
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 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.
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 subsystem 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 value.
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 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.
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 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.
EXAMPLES
The following list shows examples of using the sysconfig command:
· To display all the subsystems configured in the local kernel, enter
the following command:
# sysconfig -s
Used without arguments, the -s flag displays information about the
state of all subsystems on the local system.
· To configure a subsystem 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 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
RETURN VALUES
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.
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
RELATED INFORMATION
Commands: autosysconfig(8), cfgmgr(8), dxkerneltuner(8), sysconfigdb(8),
kloadsrv(8)
Files: sysconfigtab(4), cfgmgr.auth(4)
System Administration
|
Index for
Section 8 |
|
|
Alphabetical
listing for S |
|
 |
Top of
page |
|