NAME

sysconfigdb − Maintains the subsystem configuration database

SYNOPSIS

/sbin/sysconfigdb [-a | -d | -l | -s | -u] [-f file] [subsystem-name]

DESCRIPTION

The sysconfigdb command is used to maintain and manage the /etc/sysconfigtab subsystem configuration database.  The subsystem-name argument names the subsystem that you want to manage. 

To modify the /etc/sysconfigtab database, you create a stanza-formatted file.  (See stanza(4) for information on creating a stanza-formatted file.)  The file contains the name of the subsystem and a list of attributes and their values. To move the contents of the file into the /etc/sysconfigtab database, you issue the sysconfigdb command with the appropriate flag and subsystem name.  For example, suppose you create the following file named table_mgr.stanza that defines the attributes for a subsystem named table_mgr:

table_mgr:
            size = 10
            name = Ten Element Table

To add the contents of this file to the /etc/sysconfigtab database, issue the following command:

# sysconfigdb -a -f table_mgr.stanza table_mgr

This command also updates the in-memory copy of the /etc/sysconfigtab database.  The in-memory copy of the database is the one that the kernel uses to configure kernel subsystems. 

However, this command does not change the value of attributes in the running kernel.  To modify the value of attributes in the running kernel you must do one of the following:

       •Use the sysconfig -r command

       •Unconfigure and reconfigure the subsystem that contains the attribute value

       •Reboot your system

You should always use the sysconfigdb command to modify the /etc/sysconfigtab database.  If you use a text editor to modify /etc/sysconfigtab, you must subsequently use the sysconfigdb -s command to update the in-memory copy of the database.  Otherwise, the kernel has no access to changes you make to the database. 

FLAGS

-aAdds the specified subsystem stanza entry in the file specified with the -f flag to the subsystem configuration database. 

-dDeletes the specified subsystem entry from the configuration database. 

-f fileSpecifies the file containing the specified subsystem’s stanza entry.  This flag is used with the -a and -u flags. 

-lLists the specified subsystem entry in the configuration database. If you omit subsystem-name, all subsystem entries are listed. 

-sSynchronizes the /etc/sysconfigtab file and the in-memory configuration database by updating the in-memory database so that it matches the /etc/sysconfigtab file. 

-uUpdates the specified subsystem’s configuration database entry with the file named in the -f flag. 

EXAMPLES

The following list shows examples of using the sysconfigdb command:

       •To update an existing entry in the system configuration database, use the -u flag:

# sysconfigdb -u -f table_mgr.stanza table_mgr

This command updates the table_mgr entry with the information in the table_mgr.stanza file.  The in-memory copy of the subsystem configuration database is also updated.  However, the table_mgr subsystem is unchanged.  The new values are passed to the subsystem the next time the subsystem is configured. 

       •To list the entry for a subsystem in the database, use the -l flag:

# sysconfigdb -l table_mgr

table_mgr:
              size = 15
              name = Fifteen Element Table

       •To delete the entry for a subsystem from the database, use the -d flag:

# sysconfigdb -d table_mgr

FILES

/etc/sysconfigtab
The subsystem configuration database

RELATED INFORMATION

Commands:  cfgmgr(8) sysconfig(8)

Files:  sysconfigtab(4), stanza(4)