NAME

sysconfig − Maintains the kernel subsystem configuration

SYNOPSIS

/sbin/sysconfig [-h hostname] [-i index] [-v] -c | -q | -r | -s | -u [subsystem-name] [attribute-list]

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.  You can manage any dynamically configurable subsystem using this command.  Note that both static and loadable subsystems can be dynamically configurable. 

A static subsystem is one that is linked with the kernel at build time.  Once the kernel is built, this type of subsystem cannot be added to the kernel or removed from the kernel. 

A loadable subsystem is one that can be added to or removed from the kernel without rebuilding the kernel. 

Both static and loadable subsystems can be dynamically configurable:

       •For a static subsystem, dynamically configurable means that subsystem attributes can be modified without rebuilding the kernel.  This type of subsystem can also answer queries about the value of its attributes and be unconfigured when not in use (however, it cannot be unloaded). 

       •For a loadable subsystem, configurable means that the subsystem is added to the kernel at configuration time, can be modified without rebuilding the kernel, and is removed from the kernel when it is unconfigured.  This type of subsystem can also answer queries about its attributes. 

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 an operation (one of configure, reconfigure, query attributes, query subsystem state, or unconfigure).  The subsystem-name argument is required for all operations except query subsystem state.  If you omit subsystem-name when you request the query subsystem state operation, the state of all subsystems is displayed. 

The attribute-list argument lists attribute names and, depending on the operation, attribute values. For reconfigure operations, 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 operations, the attribute-list has the following format:

attribute1 attribute2...

The attribute-list argument is required for reconfigure operations.  It is optional for query attribute operations.  For configure, query subsystem state, and unconfigure operations, any attribute list specified is ignored. 

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 the -q flag.  You can specify an attribute list.  When you use this flag, the sysconfig command reads the value of attributes from the kernel and displays those values on your local display. 

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. 

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 both static and loadable subsystems.  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. 

FLAGS

-cConfigures the specified subsystem by initializing its attribute values and, possibly, loading it into the kernel. 

-h hostnameSpecifies that the operation be performed on system hostname. 

-i indexSpecifies the index to be used for querying or reconfiguring indexed attributes. 

-qQueries 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. 

-rReconfigures the specified subsystem.  You must supply the subsystem-name argument and the attribute-list argument when you use this flag. 

-sQueries the subsystem state for the specified subsystems. If you omit the subsystem name, sysconfig displays the state of all the configured subsystems. 

-uUnconfigures and, if the subsystem is loadable, unloads the specified subsystem from the kernel. 

-vDisplays debugging information from the cfgmgr server and the kloadsrv loader (verbose flag). 

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. 

RETURN VALUES

The sysconfig program returns zero after successful completion of the specified operation.  If an operation fails, the program returns one. 

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:  cfgmgr(8), sysconfigdb(8), kloadsrv(8)

Files:  sysconfigtab(4), cfgmgr.auth(4)

System Administration