unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



sysconfigdb(8)						       sysconfigdb(8)



NAME

  sysconfigdb -	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

  -a  Adds the specified subsystem entry to the	target file.

  -d  Deletes the specified subsystem entry from the target file.

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

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

  -m  Merges subsystem attributes specified in the input file with the sub-
      system 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.

  -r  Removes the subsystem entries specified in the input file	from the tar-
      get 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.

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

  -t target
      Specifies	the target file	for the	operation. If you do not specify this
      option, the default target file is the /etc/sysconfigtab file.

  -u  Replaces a subsystem entry in the	target file with the subsystem entry
      specified	in the input file.






OPERANDS

  subsys
      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 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 confi-
  guration 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 subsys-
  tem 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.

RESTRICTIONS

  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.

EXAMPLES

  The following	list shows examples of using the sysconfigdb command:

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

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

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

   4.  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 in-memory	copy of	the subsystem
       configuration database to match the modified /etc/sysconfigtab file.

FILES

  /etc/sysconfigtab
      The subsystem configuration database

SEE ALSO

  Commands: cfgmgr(8) sysconfig(8)

  Files: sysconfigtab(4), stanza(4)

  Misc:	sys_attrs(5)