unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

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



sysconfig(8)							 sysconfig(8)



NAME

  sysconfig - Maintains	the kernel subsystem configuration

SYNOPSIS

  /sbin/sysconfig [-h hostname]	[-v] { -c  | -d	 | -u  } subsys

  /sbin/sysconfig [-h hostname]	[-i index] [-v]	{ -m  |	-s  } [subsys]...

  /sbin/sysconfig [-h hostname]	[-v] -o	opcode subsys [attr=value]

  /sbin/sysconfig [-h hostname]	[-i index] [-v]	{ -q  |	-Q  } subsys [attri-
  bute]...

  /sbin/sysconfig [-h hostname]	[-i index] [-v]	-r  subsys attrib=value
  [attrib=value]...

OPTIONS

  -c subsys (configure)
      Configures the specified subsystem by initializing its attribute values
      and, possibly, loading it	into the kernel.

  -d subsys (display)
      Display the attribute settings in	the /etc/sysconfigtab file for the
      specified	subsystem.

  -h hostname
      Specifies	that the operation be performed	on system hostname.

  -i index
      Specifies	the index to be	used for querying or reconfiguring indexed
      attributes. This option can be used with the -m, -s, -q, -Q, or -r
      options.

  -m [subsys]... (mode query)
      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.

  -o opcode subsys [attrib=value] (operation code)
      Perform a	system-defined operation corresponding to the specified
      operation	code (opcode). The opcode function must	be implemented for
      the specified subststem. Optionally, pass	an attribute and value as
      input data. For example:
	   # sysconfig -o proc 101 maxusers=512

  -q [subsys] [attribute]... (query attribute)
      Queries attribute	values for the configured subsystem specified by sub-
      sys. If you omit the attribute list, values of all the specified
      subsystem's attributes are displayed.

  -Q [subsys] [attribute]... (query attribute information)
      Queries information about	attributes of the configured subsystem speci-
      fied by subsys. 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 speci-
      fied subsystem is	displayed.

  -r subsys attrib=value [attrib=value]... (reconfigure)
      Reconfigures the specified subsystem.  You must supply the subsys	argu-
      ment and one or more attrib=value	arguments when you use this option.

  -s [subsys]... (subsysten state)
      Queries the subsystem state for the specified subsystems.	If you omit
      the subsystem name, sysconfig displays the state of all the configured
      subsystems.

  -u subsys (unconfigure)
      Unconfigures and,	if the subsystem is loadable, unloads the specified
      subsystem	from the kernel. You must specify the subsys argument when
      you use this option.

  -v (verbose)
      This option displays debugging information from the cfgmgr server	and
      the kloadsrv. The	kloadsrv loader	output is sent to /dev/console.	 This
      information can be used to determine the names of	any unresolved sym-
      bols from	dynamically linked modules.

DESCRIPTION

  The sysconfig	command	is used	to query or modify the kernel subsystem	con-
  figuration. 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 run-
  ning kernel.	It also	allows you to modify the value of subsystem attri-
  butes	if the subsystem supports run-time modifications.

  You can also use the dxkerneltuner application to modify the value of	sub-
  system attributes.  This application provides	a graphical user interface
  for tuning kernel subsystems.	For more information, see dxkerneltuner(8).

  There	us a sys_attrs*	reference page for many	commonly-tuned subsystems,
  such as sys_attrs_vm(5).  These reference pages define each attribute,
  describe the impact of changing it, and provide a definitive list of sup-
  ported values. See sys_attrs(5) for a	complete list of sys_attrs* reference
  pages.

  Subset Specification


  The first argument to	the sysconfig command is the subsys argument.  The
  subsys argument names	the subsystem on which you want	to perform the opera-
  tion specified by one	of the required	options, such as the -c	(configure)
  option or the	-q (query attributes) option. The subsys argument is required
  for all options except -s and	-m.  If	you omit subsys	when you use one of
  these	options, the sysconfig command displays	information about all loaded
  subsystems.





  Attribute Lists


  The attribute	list arguments specify attribute names and, depending on the
  operation, attribute values. For the -r (reconfigure)	option,	the attribute
  list 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) and query attribute information (-Q)	operations,
  the attr-list	has the	following format:

  attribute1 attribute2...

  The attribute	list argument is required when you use the -r option and is
  options with the -q and -Q option.  Any attribute list specified with	other
  options is ignored by	the sysconfig command.

  Configuring Subsystems


  When you configure a subsystem using the -c option, 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. Use
  the sysconfigdb command to control the contents of the /etc/sysconfigtab
  file.	See the	sysconfigdb(8) reference page for more information.

  Modifying Subsystem Attributes


  If you want to modify	the value of a subsystem attribute, you	use the	-r
  (reconfigure)	option.	When you use the -r option, 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.

  Querying Subsystem Attributes


  To get information about subsystem attributes, use either the	-q option or
  the -Q option.  You can specify an attribute list with both these options.
  When you use the -q option, the sysconfig command reads the value of attri-
  butes	from the kernel	and displays those values on your local	display. When
  you use the -Q option, the sysconfig command displays	the following infor-
  mation about either each attribute in	the subsystem or, if specified,	each
  attribute in the attr-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.



  Query	Subsystem Mode


  Use the -m option to determine whether a subsystem supports being added and
  removed from the kernel using	the sysconfig -c or sysconfig -u command. The
  -m option 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 subsys argument, the sysconfig command displays
  this information for all loaded and configured subsystems.

  Query	Subsystem State


  Use the -s option to get information about the state of subsystems. This
  option provides a list of the	subsystems that	are currently loaded and con-
  figured into the kernel.  If you specify subsys, 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 unconfig-
       ured but	cannot be unloaded.

    +  Unloaded	(not available for use)

       This state applies only to loadable subsystems, which are automati-
       cally unloaded from the kernel when you unconfigure them	with the sys-
       config -u command.

  Unconfigure Subsets


  Subsystems that are not being	used can be unconfigured using the -u option.
  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 subsys-
  tem, that subsystem is also unloaded from the	kernel.

  Configuring Remote Systems


  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
  option. The sysconfig	command	uses the socket	to send	the configure, recon-
  figure, 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 informa-
  tion about the cfgmgr.auth file and its format.




  Array	Attributes


  Because the square bracket ([	and ]) characters have special meaning to the
  UNIX shell, when you try to query or reconfigure individual array elements
  from the shell command line, you must	escape these two characters. For
  example:

       # sysconfig  -q	subsys1	attr1\[0\] attr2 attr3

  When both -i and a subscript are specified, the subscript takes precedence.
  However, when	no subscript is	specified, the -i applies providing the
  attribute is an array	attribute.

  The command sysconfig	-Q cannot be used to query an individual array ele-
  ment.

EXIT STATUS

  0 (Zero)
      Specified	operation completed successfully. If you specify multiple
      attributes in a single sysconfig operation, a zero is returned if	at
      least one	attribute operation is successful.

  1   Specified	operation failed. If you specify multiple attributes in	a
      single sysconfig operation, a one	is only	returned if the	sysconfig
      operation	fails on every attribute.

EXAMPLES

   1.  To display all the subsystems configured	in the local kernel, enter
       the following command:
	    # sysconfig	-s

       Used without arguments, the -s option displays information about	the
       state of	all subsystems on the local system.

   2.  To configure a subsystem	into the kernel, use the -c option, 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	com-
       mand.

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

   4.  To reconfigure an attribute, use	the -r option:
	    # 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 sal-
       mon is modified.	 The -v	option causes the sysconfig command to
       display debugging information, which may	be displayed to	the console.

   5.  To display the current settings of attributes in	the /etc/sysconfigtab
       file, use the -d	option as follows:
	    # sysconfig	-d generic
	    generic:
	    memberid = 0
	    new_vers_high = 1441151880873377792
	    new_vers_low = 15044






FILES

  /sbin/cfgmgr
      The configuration	management server command path

  /sbin/kloadsrv
      The kernel load server daemon command path

  /etc/cfgmgr.auth
      The configuration	management authorization database

  /etc/sysconfigtab
      The configuration	database

SEE ALSO

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

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

  Misc:	sys_attrs(5)

  System Administration