sysconfigdb(8)sysconfigdb(8)NAMEsysconfigdb - Manage the subsystem configuration database
SYNOPSIS
/sbin/sysconfigdb {-a | -u } [-t target] -f file subsys
/sbin/sysconfigdb -d [-t target] subsys
/sbin/sysconfigdb -l [-t target] [subsys...]
/sbin/sysconfigdb {-m | -r } [-t target] -f file [subsys]
/sbin/sysconfigdb -s
OPTIONS
Adds the specified subsystem entry to the target file. Deletes the
specified subsystem entry from the target file. Specifies the input
file, a stanza-formatted file that contains entries for one or more
subsystems. The default target file is the /etc/sysconfigtab file.
Specify another target file by using the -t target option. Lists the
specified subsystem entries in the target file. If you do not specify
subsys arguments, all subsystem entries in the target file are listed.
The /etc/sysconfigtab file is the default target file. Merges subsys‐
tem attributes specified in the input file with the subsystem
attributes in the target file. If you do not specify a subsys argu‐
ment, all subsystem entries in the input file are merged. The
/etc/sysconfigtab file is the default target file. Removes the subsys‐
tem entries specified in the input file from the target file. The only
entries removed are those which have attribute names and values that
exactly match those in the input file. If you do not specify a subsys
argument, all subsystem entries in the input file with exactly-matching
attributes are removed from the target file. The /etc/sysconfigtab file
is the default target database file. Synchronizes the /etc/syscon‐
figtab file and the in-memory configuration database by updating the
in-memory database so that it matches the /etc/sysconfigtab file.
Specifies the target file for the operation. If you do not specify this
option, the default target file is the /etc/sysconfigtab file.
Replaces a subsystem entry in the target file with the subsystem entry
specified in the input file.
OPERANDS
Sepecifies a subsystem that contains the attributes you want to modify.
The subsystem name and attributes are in a stanza-formatted input file.
Specify only one subsystem name when you add (-a), delete (-d),
or replace (-u) a subsystem.
For other options, if you do not specify a subsystem name the
operation is attempted for all of the subsystems and attributes
specified in the input file.
DESCRIPTION
The sysconfigdb command is used to manage the /etc/sysconfigtab subsys‐
tem configuration database. However, it can also be used to maintain
any text file that has the same format as the /etc/sysconfigtab file.
The file being managed by the sysconfigdb command is called the target
file. By default, the target file is the /etc/sysconfigtab file.
To specify another file as a target file, use the -t target option.
To modify a target file, create an input stanza-formatted file, as
described in stanza(4). This stanza file contains the name of one or
more subsystems, each with a list of attributes and their values.
When the target file is the /etc/sysconfigtab file, modifications you
make to it are automatically synchronized into the in-memory subsystem
configuration database. However, the subsystems are unchanged until
the next time they are configured.
When the target file is another file, there is no synchronization with
the in-memory subsystem configuration database.
For example, suppose you create the following file named ta‐
ble_mgr.stanza that defines the attributes for a subsystem named ta‐
ble_mgr_1 and a subsystem named tbl_mgr_2:
table_mgr_1:
size = 10
name = Ten Element Table tbl_mgr_2: size = 5
name = Five Element Table
To add the contents of this file to the /etc/sysconfigtab database and
to have those modifications synchronized with the in-memory configura‐
tion database, enter the following commands: # sysconfigdb-a -f ta‐
ble_mgr.stanza table_mgr_1 # sysconfigdb-a-f table_mgr.stanza
tbl_mgr_2
The above example does not change the value of attributes in the run‐
ning kernel. To modify the value of attributes in the running kernel
you must do one of the following: Use the sysconfig -r command Uncon‐
figure and reconfigure the subsystem that contains the attribute value
Reboot your system
Always use the sysconfigdb command to modify the /etc/sysconfigtab
database as it automatically updates the in-memory copy of the data‐
base. This ensures that the kernel has immediate access to any
changes. The file is also automatically merged during an update
installation and changes will be merged into the new system.
To add the contents of the file table_mgr.stanza to another text file
named /etc/sampleconfigdb, enter the following command: # sysconfigdb-a -t /etc/sampleconfigdb -f table_mgr.stanza
Because the output file is not the /etc/sysconfigtab file, the in-mem‐
ory configuration database is not updated.
See sys_attrs(5) for information on attribute values.
RESTRICTIONS
You must be the root user to execute the commmand when the /etc/syscon‐
figtab file is the target file and the operation will modify it.
EXAMPLES
The following list shows examples of using the sysconfigdb command: To
replace an existing entry in the /etc/sysconfigtab file, use the -u
option:
# sysconfigdb-u -f table_mgr.stanza table_mgr_1
The above command replaces the table_mgr_1 entry in the
/etc/sysconfigtab file with the information in the ta‐
ble_mgr.stanza file for the table_mgr_1 subsystem. The command
updates the in-memory copy of the subsystem configuration data‐
base to match the modified /etc/sysconfigtab file. To merge
information in a stanza-formatted file with the /etc/syscon‐
figtab file, use the -m option:
# sysconfigdb-m -f table_mgr.stanza tbl_mgr_2
The above command merges the tbl_mgr_2 information from the ta‐
ble_mgr.stanza file with the information already in the
tbl_mgr_2 entry in the /etc/sysconfigtab file. The command
updates the in-memory copy of the subsystem configuration data‐
base to match the modified /etc/sysconfigtab file. To list the
entry for a subsystem in the /etc/sysconfigtab file, use the -l
option:
# sysconfigdb-l table_mgr_1 table_mgr_1:
size = 10
name = Ten Element Table
The above command does not update the in-memory copy of the sub‐
system configuration database. To delete the entry for a sub‐
system from the /etc/sysconfigtab file, use the -d option:
# sysconfigdb-d table_mgr_1
The above command deletes the table_mgr_1 entry from the
/etc/sysconfigtab file and updates the in-memory copy of the
subsystem configuration database to match the modified
/etc/sysconfigtab file.
FILES
The subsystem configuration database
SEE ALSO
Commands: cfgmgr(8)sysconfig(8)
Files: sysconfigtab(4), stanza(4)
Misc: sys_attrs(5)sysconfigdb(8)