Content-type: text/html Man page of sysconfig

sysconfig

Section: Maintenance Commands (8)
Index Return to Main Contents
 

NAME

sysconfig - Maintains the kernel subsystem configuration  

SYNOPSIS

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

FLAGS

Configures the specified subsystem by initializing its attribute values and, possibly, loading it into the kernel. Specifies that the operation be performed on system hostname. Specifies 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. 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. 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 subsystem-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 loadable, unloads the specified subsystem from the kernel. Displays debugging information from the cfgmgr server and the kloadsrv loader (verbose flag).  

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(8X).)

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.
 

RETURN VALUES

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

FILES

The configuration management server command path The kernel load server daemon command path The configuration management authorization database The configuration database  

RELATED INFORMATION

Commands: autosysconfig(8), cfgmgr(8), dxkerneltuner(8X), sysconfigdb(8), kloadsrv(8)

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

System Administration

delim off


 

Index

NAME
SYNOPSIS
FLAGS
DESCRIPTION
EXAMPLES
RETURN VALUES
FILES
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:40:27 GMT, October 02, 2010