sysconfig man page on DigitalUNIX

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
DigitalUNIX logo
[printable version]

sysconfig(8)							  sysconfig(8)

       sysconfig - Maintains the kernel subsystem configuration

       /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

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

       Configures the specified subsystem by initializing its attribute values
       and, possibly, loading it into the kernel.  Display the attribute  set‐
       tings in the /etc/sysconfigtab file for the specified subsystem.	 Spec‐
       ifies that the operation be performed on	 system	 hostname.   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.
       Queries	the  mode for the specified subsystems. A subsystem's mode can
       be static or dynamic. If you omit the subsystem	name,  sysconfig  dis‐
       plays  the  mode	 of  all the configured subsystems.  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 Queries attribute values
       for the configured subsystem specified  by  subsys.  If	you  omit  the
       attribute  list, values of all the specified subsystem's attributes are
       displayed.  Queries information about attributes of the configured sub‐
       system specified 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,  respec‐
       tively.	 If  you  omit	the  attribute	list,  information  about  all
       attributes in the specified subsystem is displayed.   Reconfigures  the
       specified  subsystem.   You  must supply the subsys argument and one or
       more attrib=value arguments when you use this option.  Queries the sub‐
       system  state  for  the specified subsystems. If you omit the subsystem
       name, sysconfig displays the state of all  the  configured  subsystems.
       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.  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 symbols from dynamically linked modules.

       The sysconfig command is used to query or modify the  kernel  subsystem
       configuration.  Use this command to add subsystems to your running ker‐
       nel, reconfigure subsystems already in the kernel, ask for  information
       about (query) subsystems in the kernel, and unconfigure and remove sub‐
       systems from the kernel.

       A subset of kernel subsystems can be managed using the  sysconfig  com‐
       mand.   This  command  allows you to add and remove loadable subsystems
       from the running kernel.	 It also allows you to	modify	the  value  of
       subsystem attributes if the subsystem supports run-time modifications.

       You  can	 also use the dxkerneltuner application to modify the value of
       subsystem attributes.   This  application  provides  a  graphical  user
       interface  for tuning kernel subsystems. For more information, see dxk‐

       There is a sys_attrs* reference page for	 many  commonly-tuned  subsys‐
       tems,  such  as	sys_attrs_vm(5).   These  reference  pages define each
       attribute, describe the impact of changing it, and provide a definitive
       list  of	 supported  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 operation 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 dis‐
       plays 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) opera‐
       tions, 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  sub‐
       system  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) ref‐
       erence 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 com‐
       mand 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 attributes from the kernel and displays those values  on  your
       local  display.	When you use the -Q option, the sysconfig command dis‐
       plays the following information about either each attribute in the sub‐
       system  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 com‐
       mand. 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 con‐
       figured 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  configured	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
	      unconfigured  but	 cannot	 be unloaded.  Unloaded (not available
	      for use)

	      This state applies only to loadable subsystems, which are	 auto‐
	      matically	 unloaded  from	 the  kernel when you unconfigure them
	      with the sysconfig -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	 load‐
       able  subsystem	that supports run-time unconfiguration.	 If you uncon‐
       figure a loadable subsystem, that subsystem is also unloaded  from  the

   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  con‐
       figure, reconfigure, query attributes, query subsystem state, or uncon‐
       figure 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, recon‐
       figure, 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 uncon‐
       figuration 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)  ref‐
       erence  page  for  more	information about the cfgmgr.auth file and its

   Configuring Trucluster Server Members
       In a TruCluster Server environment,  the	 sysconfig  command  uses  the
       cluster interconnect to send requests to reconfigure, query attributes,
       and query subsystem states of kernel subsystems	on  different  cluster
       members.	 The  sysconfig	 command  receives  output from these commands
       across the cluster interconnect. The cluster interconnect is  not  used
       for the sysconfig configure and unconfigure commands.

       Using  the  cluster  interconnect for these commands allows querying or
       modification attributes on members that are hung or on members that  do
       not have an external interface between cluster members.

   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 charac‐
       ters. For example: # sysconfig  -q  subsys1 attr1\[0\] attr2 attr3

       When both -i and a subscript are specified, the subscript takes	prece‐
       dence.  However, when no subscript is specified, the -i applies provid‐
       ing the attribute is an array attribute.

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

       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.   Specified operation
       failed. If you specify multiple attributes in a single sysconfig opera‐
       tion,  a one is only returned if the sysconfig operation fails on every

       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.	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  ker‐
	      nel. If the subsystem is loadable, it is also loaded in response
	      to this command.	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 salmon.  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  salmon  is	modified.   The	 -v  option causes the
	      sysconfig command to display debugging information, which may be
	      displayed	 to  the  console.  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

       The configuration management server command path The kernel load server
       daemon command path The configuration management authorization database
       The configuration database

       Commands:  autosysconfig(8),   cfgmgr(8),   dxkerneltuner(8),   syscon‐
       figdb(8), kloadsrv(8)

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

       Misc: sys_attrs(5)

       System Administration


List of man pages available for DigitalUNIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
Vote for polarhome
Free Shell Accounts :: the biggest list on the net