1sysidconfig(1M)         System Administration Commands         sysidconfig(1M)
2
3
4

NAME

6       sysidconfig  - execute system configuration applications, or define set
7       of system configuration applications
8

SYNOPSIS

10       sysidconfig [-lv] [-a application] [-b basedir]
11            [-r application]
12
13

DESCRIPTION

15       Invoked without any options, the sysidconfig program executes a list of
16       applications.  An  application on this list is referred to as a "system
17       configuration application." Every application  on  this  list  will  be
18       passed  one  command-line argument, -c. This flag will cause the system
19       configuration application to perform its configuration function.  With‐
20       out  options,  sysidconfig  should  only be invoked by startup scripts,
21       which occurs during the initial installation and during  a  reconfigure
22       reboot.
23
24
25       All  applications on the list will be executed, if possible. All activ‐
26       ity taken by the sysidconfig program is logged in the  sysidconfig  log
27       file,  /var/log/sysidconfig.log.  If one or more of the applications on
28       the list are either not present at execution time, are not  executable,
29       or  execute but return a failure code upon completion, then that infor‐
30       mation will be logged as well. Successful completion of the program can
31       be assumed if no error message is present in the log file. Programs are
32       executed sequentially, with only one configuration  application  active
33       at a time.
34
35
36       Executed with the -l, -a, or -r options, the sysidconfig program allows
37       the super-user to list the defined configuration applications,  and  to
38       add  items  to or remove items from that list. Running sysidconfig with
39       options is the only way to view or manipulate the list. Only the super-
40       user can execute the sysidconfig program with options.
41
42
43       The  -b  and  -v options change the behavior of sysidconfig, and can be
44       used with or without the list manipulation options discussed above. The
45       -b  basedir  option is used to specify a reference root directory other
46       than the default, /. The -v option duplicates the log  file  output  on
47       stdout.
48
49
50       By default, no SPARC based applications exist on this list.
51
52
53       This  application  is  an  extension of the sysidtool(1M) suite of pro‐
54       grams. It is executed during initial installation and during  a  recon‐
55       figure  reboot,  before  the  window system has been started. Graphical
56       User Interface (GUI) applications will not execute successfully if they
57       are added to the list of configuration applications via sysidconfig -a.
58
59
60       This  program  is  referenced,  but  not fully described, in the sysid‐
61       tool(1M) manual page.
62

OPTIONS

64       The valid options are:
65
66       -a application
67
68           Add the named application to the list of defined applications. When
69           next  invoked  without  arguments,  sysidconfig will run this newly
70           added application after all previously defined applications. appli‐
71           cation must be a fully qualified path name that is not currently on
72           the list of applications to execute.
73
74
75       -b basedir
76
77           Specify an alternate base directory (/ is defined  as  the  default
78           base  directory  if no other is specified). The specified directory
79           is used as the root directory when adding,  listing,  removing,  or
80           executing  configuration  applications. The log file where informa‐
81           tion is recorded is in /var/log, relative to the specified basedir.
82           In the log file, the basedir is not noted. This means, for example,
83           that if the super-user on a diskless client's server executes:
84
85             sysidconfig -b /export/root/client -a /sbin/someapp
86
87
88           then the diskless client client would have  /sbin/someapp  executed
89           upon  reconfigure reboot. The diskless client's log file would note
90           that /sbin/someapp was added, not /export/root/client/sbin/someapp.
91
92           Note -
93
94             The root file system of any non-global zones must not  be  refer‐
95             enced with the -b option. Doing so might damage the global zone's
96             file system, might compromise the security of  the  global  zone,
97             and might damage the non-global zone's file system. See zones(5).
98
99
100       -l
101
102           List  defined configuration applications. Applications will be exe‐
103           cuted one at a time, in the order shown in the list.
104
105
106       -r application
107
108           Remove the named application from the list of defined applications.
109           application  must  be a fully qualified path name and it must be on
110           the existing list of applications to execute.
111
112
113       -v
114
115           Verbose mode. This option echoes all information sent  to  the  log
116           file  to  stdout.  Such  information includes timestamp information
117           about when the program was  executed,  the  names  of  applications
118           being executed, and results of those executions.
119
120

RETURN VALUES

122       The sysidconfig program will return 0 if it completes successfully.
123
124
125       When  executed  with the -r or -a options, error conditions or warnings
126       will be reported on stderr. If the requested action completes  success‐
127       fully, an exit code of 0 will be returned.
128

ERRORS

130       EPERM
131
132           The program was executed by a user other than the super-user.
133
134
135       EINVAL
136
137           Option  -l,  -a,  or -r was passed and the action could not be com‐
138           pleted successfully.
139
140

FILES

142       /var/log/sysidconfig.log
143
144           sysidconfig log file
145
146

ATTRIBUTES

148       See attributes(5) for descriptions of the following attributes:
149
150
151
152
153       ┌─────────────────────────────┬─────────────────────────────┐
154       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
155       ├─────────────────────────────┼─────────────────────────────┤
156       │Availability                 │SUNWadmap                    │
157       └─────────────────────────────┴─────────────────────────────┘
158

SEE ALSO

160       sys-unconfig(1M), sysidtool(1M), attributes(5)
161

DIAGNOSTICS

163       When run without options, a log of the sysidconfig  program's  activity
164       can  be  found  in /var/log/sysidconfig.log. This file contains a time‐
165       stamp log of each program executed, its resulting  stderr  output,  and
166       its  exit  code.  If an application in the list was not found or is not
167       executable, that will also be noted.
168
169
170
171SunOS 5.11                        23 Jun 2009                  sysidconfig(1M)
Impressum