1sysidconfig(1M) System Administration Commands sysidconfig(1M)
2
6 sysidconfig - execute system configuration applications, or define set
7 of system configuration applications
8
10 sysidconfig [-lv] [-a application] [-b basedir]
11 [-r application]
12
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 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 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 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 By default, no SPARC based applications exist on this list.
51 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 This program is referenced, but not fully described, in the sysid‐
61 tool(1M) manual page.
62
64 The valid options are:
65 -a application
67 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 -b basedir
76 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 sysidconfig -b /export/root/client -a /sbin/someapp
86 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 Note -
93 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 -l
101 List defined configuration applications. Applications will be exe‐
103 cuted one at a time, in the order shown in the list.
104 -r application
107 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 -v
114 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
122 The sysidconfig program will return 0 if it completes successfully.
123 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
130 EPERM
131 The program was executed by a user other than the super-user.
133 EINVAL
136 Option -l, -a, or -r was passed and the action could not be com‐
138 pleted successfully.
139
142 /var/log/sysidconfig.log
143 sysidconfig log file
145
148 See attributes(5) for descriptions of the following attributes:
149 ┌─────────────────────────────┬─────────────────────────────┐
154 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
155 ├─────────────────────────────┼─────────────────────────────┤
156 │Availability │SUNWadmap │
157 └─────────────────────────────┴─────────────────────────────┘
158
160 sys-unconfig(1M), sysidtool(1M), attributes(5)
161
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.
168SunOS 5.11 23 Jun 2009 sysidconfig(1M)