sysconfigdb - Manage the subsystem configuration database
/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
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 subsystem
attributes specified in the input file with the subsystem
attributes in the target file. If you do not specify a
subsys argument, all subsystem entries in the input file
are merged. The /etc/sysconfigtab file is the default target
file. Removes the subsystem 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/sysconfigtab
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.
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.
The sysconfigdb command is used to manage the /etc/sysconfigtab
subsystem 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
table_mgr.stanza that defines the attributes for a subsystem
named table_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 configuration database, enter the following
commands: # sysconfigdb -a -f table_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 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
Always use the sysconfigdb command to modify the
/etc/sysconfigtab database as it automatically updates the
in-memory copy of the database. 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-memory configuration database is not updated.
See sys_attrs(5) for information on attribute values.
You must be the root user to execute the commmand when the
/etc/sysconfigtab file is the target file and the operation
will modify it.
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 table_mgr.stanza file for the table_mgr_1 subsystem.
The command updates the in-memory copy of
the subsystem configuration database to match the
modified /etc/sysconfigtab file. To merge information
in a stanza-formatted file with the
/etc/sysconfigtab 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 table_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 database 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 subsystem configuration database. To
delete the entry for a subsystem 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 inmemory
copy of the subsystem configuration database
to match the modified /etc/sysconfigtab file.
The subsystem configuration database
Commands: cfgmgr(8) sysconfig(8)
Files: sysconfigtab(4), stanza(4)
Misc: sys_attrs(5)
sysconfigdb(8)
[ Back ] | 