sysidconfig
Maintenance Commands sysidconfig(1M)NAME
sysidconfig - execute system configuration applications, or define set of system configuration applicationsSYNOPSIS
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 confi- guration 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 execute 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 IA 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 confi- guration applications. The log file where information 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 diskless 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. -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 execute. -v Verbose mode. This option echoes all information sent to the log file to stdout. Such information includes timestamp information about when the program was exe- cuted, 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 fileATTRIBUTES
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) IA 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. SunOS 5.8 Last change: 12 Feb 1997 3