System Administration Commands sysidconfig(1M)
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.
SunOS 5.11 Last change: 6 Apr 2005 1
System Administration Commands sysidconfig(1M)
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. applica-
tion 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 execut-
ing configuration 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.
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 system, might compromise the
SunOS 5.11 Last change: 6 Apr 2005 2
System Administration Commands sysidconfig(1M)
security of the global zone, and might
damage the non-global zone's file sys-
tem. 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
execute.
-v Verbose mode. This option echoes all
information sent to the log file to
stdout. Such information includes times-
tamp information about when the program
was executed, the names of applications
being executed, and results of those exe-
cutions.
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.
ERORS
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
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
SunOS 5.11 Last change: 6 Apr 2005 3
System Administration Commands sysidconfig(1M)
ATRIBUTE TYPE ATRIBUTE 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.
SunOS 5.11 Last change: 6 Apr 2005 4
|
