*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> sysconfig (8)              



NAME    [Toc]    [Back]

       sysconfig - Maintains the kernel subsystem configuration

SYNOPSIS    [Toc]    [Back]

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

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

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

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

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

OPTIONS    [Toc]    [Back]

       Configures the specified  subsystem  by  initializing  its
       attribute  values  and, possibly, loading it into the kernel.
  Display the attribute settings in  the  /etc/sysconfigtab
  file  for the specified subsystem.  Specifies 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 displays the
       mode of all the configured subsystems.  Perform a  systemdefined
 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 subsystem 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,
       respectively. 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 subsystem
       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.

DESCRIPTION    [Toc]    [Back]

       The sysconfig command is used to query or modify the  kernel
  subsystem configuration. 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 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 dxkerneltuner(8).

       There  is  a  sys_attrs* reference page for many commonlytuned
 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  supported
       values.   See   sys_attrs(5)   for   a  complete  list  of
       sys_attrs* reference pages.

   Subset Specification    [Toc]    [Back]
       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  displays information about all loaded subsystems.

   Attribute Lists    [Toc]    [Back]
       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

       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    [Toc]    [Back]
       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    [Toc]    [Back]
       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    [Toc]    [Back]
       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 displays the following information 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    [Toc]    [Back]
       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

   Query Subsystem State    [Toc]    [Back]
       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 automatically unloaded  from  the  kernel
              when  you  unconfigure  them  with the sysconfig -u

   Unconfigure Subsets    [Toc]    [Back]
       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  subsystem,  that subsystem is also unloaded from
       the kernel.

   Configuring Remote Systems    [Toc]    [Back]
       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,
       reconfigure,  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 information about  the
       cfgmgr.auth file and its format.

   Configuring Trucluster Server Members    [Toc]    [Back]
       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

       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    [Toc]    [Back]
       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

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

EXIT STATUS    [Toc]    [Back]

       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 operation, a one
       is only returned if the sysconfig operation fails on every

EXAMPLES    [Toc]    [Back]

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

              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

FILES    [Toc]    [Back]

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

SEE ALSO    [Toc]    [Back]

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

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

       Misc: sys_attrs(5)

       System Administration

[ Back ]
 Similar pages
Name OS Title
sys_attrs Tru64 introduction to kernel subsystem attributes used for configuration and tuning
autosysconfig Tru64 Maintains the list of dynamic kernel subsystems that are automatically configured
kreg Tru64 Maintains the system file that registers kernel layered products
sysconfigdb Tru64 Manage the subsystem configuration database
sys_attrs_ipc Tru64 attributes for the ipc kernel subsystem
audit_setup Tru64 Audit subsystem configuration graphical interface (Enhanced Security)
auditconfig Tru64 Audit subsystem configuration graphical interface (Enhanced Security)
kmpath HP-UX retrieve kernel name and associated kernel configuration information
mbuf FreeBSD memory management in the kernel IPC subsystem
sys_attrs_cm Tru64 system attributes for the cm kernel subsystem
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service