Unix‎ > ‎Solaris‎ > ‎Solaris man pages‎ > ‎1m‎ > ‎

sysidconfig


NAME
     sysidconfig - execute system configuration applications,  or
     define set of system configuration applications

SYNOPSIS
     sysidconfig   [-lv]   [-a application]    [-b basedir]    [-
     r application]

DESCRIPTION
     Invoked without any options, the  sysidconfig  program  exe-
     cutes a list of applications. An application on this list is
     referred to as a "system configuration  application."  Every
     application  on  this  list  will be passed one command-line
     argument, -c. This flag will cause the system  configuration
     application  to  perform its configuration function. Without
     options, sysidconfig  should  only  be  invoked  by  startup
     scripts,  which  occurs  during the initial installation and
     during a reconfigure reboot.

     All applications on the list will be executed, if  possible.
     All  activity  taken by the sysidconfig program is logged in
     the sysidconfig log file, /var/log/sysidconfig.log.  If  one
     or  more  of  the  applications  on  the list are either not
     present at execution time, are not  executable,  or  execute
     but  return a failure code upon completion, then that infor-
     mation will be logged as well. Successful completion of  the
     program can be assumed if no error message is present in the
     log file. Programs are executed sequentially, with only  one
     configuration application active at a time.

     Executed with the -l, -a, or  -r  options,  the  sysidconfig
     program allows the super-user to list the defined configura-
     tion applications, and to add items to or remove items  from
     that  list. Running sysidconfig with options is the only way
     to view or manipulate the list. Only the super-user can exe-
     cute the sysidconfig program with options.

     The -b and -v options change the  behavior  of  sysidconfig,
     and  can  be  used  with  or  without  the list manipulation
     options discussed above. The -b basedir option  is  used  to
     specify  a  reference root directory other than the default,
     /. The -v option duplicates the log file output on stdout.

     By default, no SPARC based applications exist on this  list.
     However, the x86 based systems are delivered with one appli-
     cation,  kdmconfig(1M),  on  the  list.  kdmconfig  is   not
     delivered on SPARC based systems.

     This application is an extension of the sysidtool(1M)  suite
     of  programs. It is executed during initial installation and
     during a reconfigure reboot, before the  window  system  has
     been  started.  Graphical  User Interface (GUI) applications
     will not execute successfully if they are added to the  list
     of configuration applications via sysidconfig -a.

     This program is referenced, but not fully described, in  the
     sysidtool(1M) manual page.

OPTIONS
     The valid options are:

     -a application  Add the named application  to  the  list  of
                     defined   applications.  When  next  invoked
                     without arguments, sysidconfig will run this
                     newly added application after all previously
                     defined applications. application must be  a
                     fully   qualified  path  name  that  is  not
                     currently on the  list  of  applications  to
                     execute.



     -b basedir      Specify an alternate base  directory  (/  is
                     defined  as the default base directory if no
                     other is specified). The specified directory
                     is  used  as the root directory when adding,
                     listing, removing, or  executing  configura-
                     tion applications. The log file where infor-
                     mation is recorded is in /var/log,  relative
                     to  the  specified basedir. In the log file,
                     the basedir is not noted.  This  means,  for
                     example,  that  if the super-user on a disk-
                     less client's server executes:


                     sysidconfig -b /export/root/client -a /sbin/someapp


                     then the diskless client client  would  have
                     /sbin/someapp   executed   upon  reconfigure
                     reboot. The diskless client's log file would
                     note   that  /sbin/someapp  was  added,  not
                     /export/root/client/sbin/someapp.


                     Note -  The root file  system  of  any  non-
                             global  zones must not be referenced
                             with the -b option. Doing  so  might
                             damage  the  global zone's file sys-
                             tem, might compromise  the  security
                             of the global zone, and might damage
                             the non-global zone's  file  system.
                             See zones(5).

     -l              List  defined  configuration   applications.
                     Applications will be executed one at a time,
                     in the order shown in the list.



     -r application  Remove the named application from  the  list
                     of defined applications. application must be
                     a fully qualified path name and it  must  be
                     on the existing list of applications to exe-
                     cute.



     -v              Verbose mode. This option echoes all  infor-
                     mation  sent to the log file to stdout. Such
                     information includes  timestamp  information
                     about  when  the  program  was executed, the
                     names of applications  being  executed,  and
                     results of those executions.



RETURN VALUES
     The sysidconfig program will return 0 if it  completes  suc-
     cessfully.

     When executed with the -r or -a options, error conditions or
     warnings will be reported on stderr. If the requested action
     completes successfully, an exit code of 0 will be returned.

ERRORS
     EPERM    The program was executed by a user other  than  the
              super-user.



     EINVAL   Option -l, -a, or -r  was  passed  and  the  action
              could not be completed successfully.



FILES
     /var/log/sysidconfig.log        sysidconfig log file



ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:


     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWadmap                   |
    |_____________________________|_____________________________|


SEE ALSO
     sys-unconfig(1M), sysidtool(1M), attributes(5)

  x86 Only
     kdmconfig(1M)

DIAGNOSTICS
     When run without options, a log of the sysidconfig program's
     activity can be found in /var/log/sysidconfig.log. This file
     contains a timestamp  log  of  each  program  executed,  its
     resulting  stderr  output, and its exit code. If an applica-
     tion in the list was not found or is  not  executable,  that
     will also be noted.










Man pages from Solaris 10 Update 8. See docs.sun.com and www.oracle.com for further documentation and Solaris information.
Comments