README
1#
2# CDDL HEADER START
3#
4# The contents of this file are subject to the terms of the
5# Common Development and Distribution License, Version 1.0 only
6# (the "License"). You may not use this file except in compliance
7# with the License.
8#
9# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
10# or http://www.opensolaris.org/os/licensing.
11# See the License for the specific language governing permissions
12# and limitations under the License.
13#
14# When distributing Covered Code, include this CDDL HEADER in each
15# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
16# If applicable, add the following below this CDDL HEADER, with the
17# fields enclosed by brackets "[]" replaced with your own identifying
18# information: Portions Copyright [yyyy] [name of copyright owner]
19#
20# CDDL HEADER END
21#
22
23Copyright 2004 Sun Microsystems, Inc. All rights reserved.
24Use is subject to license terms.
25
26NOTE: This directory contains legacy initialization and termination
27scripts for managing services. The preferred method of service
28management is via the Service Management Facility; to read more about
29SMF, consult smf(7).
30
31File names in rc?.d directories are of the form [SK]nn<init.d filename>
32where 'S' means start this job, 'K' means kill this job, and 'nn' is the
33relative sequence number for killing or starting the job. When
34executing each script in one of the /etc/rc[S0-6] directories, the
35/sbin/rc[S0-6] script passes a single argument. It passes the argument
36'stop' for scripts prefixed with 'K' and the argument 'start' for
37scripts prefixed with 'S'. There is no harm in applying the same
38sequence number to multiple scripts. In this case the order of
39execution is deterministic but unspecified. It is recommended that
40scripts be hard-linked from the same file stored in /etc/init.d/.
41
42On earlier Solaris releases, a script named with a suffix of '.sh' would
43be sourced, allowing scripts to modify the environment of other scripts
44executed later. This behavior is no longer supported; for altering the
45environment in which services are run, refer to the SMF documentation.
46
47Legacy services are reported by the default svcs(1) output, and (where
48appropriate) the utility's '-p' option. This reporting assumes a
49behavior as described above, such that each 'S' script has a suitable
50matching 'K' script, and they are both hard linked to a script in
51/etc/init.d/. If this is not the case, legacy service reporting may not
52operate accurately; under all circumstances, the scripts are always
53executed as described above.
54
55The run-levels operate as follows:
56
57s/S
58
59 Read /etc/rcS.d/README for details. This run-level corresponds to
60 the milestone svc:/milestone/single-user:default.
61
620/5/6
63
64 All /etc/rc0.d/K* scripts are run, followed by all /etc/rc0.d/S*
65 scripts. The S* scripts should only be used for cleanup during
66 shutdown.
67
681
69
70 If the system was in a higher run-level, all /etc/rc1.d/K* scripts
71 are run. Regardless of the previous run-level, all /etc/rc1.d/S*
72 scripts are run.
73
742
75
76 Read /etc/rc2.d/README for details. This run-level corresponds to
77 the milestone svc:/milestone/multi-user:default.
78
793
80
81 Read /etc/rc3.d/README for details. This run-level corresponds to
82 the milestone svc:/milestone/multi-user-server:default.
83
84
README.rc2
1#
2# CDDL HEADER START
3#
4# The contents of this file are subject to the terms of the
5# Common Development and Distribution License, Version 1.0 only
6# (the "License"). You may not use this file except in compliance
7# with the License.
8#
9# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
10# or http://www.opensolaris.org/os/licensing.
11# See the License for the specific language governing permissions
12# and limitations under the License.
13#
14# When distributing Covered Code, include this CDDL HEADER in each
15# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
16# If applicable, add the following below this CDDL HEADER, with the
17# fields enclosed by brackets "[]" replaced with your own identifying
18# information: Portions Copyright [yyyy] [name of copyright owner]
19#
20# CDDL HEADER END
21#
22
23Copyright 2004 Sun Microsystems, Inc. All rights reserved.
24Use is subject to license terms.
25
26NOTE: This directory contains legacy initialization and termination
27scripts for managing services. The preferred method of service
28management is via the Service Management Facility; to read more about
29SMF, consult smf(7).
30
31For a general discussion of the mechanism used to invoke these scripts
32see the file /etc/init.d/README.
33
34After all its dependencies have been satisfied, the start method of the
35SMF major milestone "svc:/milestone/multi-user:default" executes each
36'S' script within /etc/rc2.d/ with the argument 'start'. All start
37scripts in the directory /etc/rcS.d/ will have been run as part of the
38earlier single user milestone. Any warnings, errors, or output from the
39scripts in /etc/rc2.d/ are logged to the file:
40
41/var/svc/log/milestone-multi-user:default.log
42
43If the system is changing from a higher run-level (for example, through
44an invocation of "init 2"), SMF executes all 'K' scripts within
45/etc/rc2.d/ with the argument 'stop'. Any warnings, errors, or output
46from these scripts are logged to the file:
47
48/var/svc/log/rc2.log
49
50Scripts in /etc/rc2.d/ may assume the following:
51
52 Temporary directories have been cleaned as appropriate.
53
54 The system is a fully configured NFS client, and all NFS
55 file systems are mounted. The name service, if any, is running.
56 The system logger is running. Cron is running.
57
58For a full list of services brought online before scripts are run, see
59the output of "svcs -l svc:/milestone/multi-user:default".
60
README.rc3
1#
2# CDDL HEADER START
3#
4# The contents of this file are subject to the terms of the
5# Common Development and Distribution License, Version 1.0 only
6# (the "License"). You may not use this file except in compliance
7# with the License.
8#
9# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
10# or http://www.opensolaris.org/os/licensing.
11# See the License for the specific language governing permissions
12# and limitations under the License.
13#
14# When distributing Covered Code, include this CDDL HEADER in each
15# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
16# If applicable, add the following below this CDDL HEADER, with the
17# fields enclosed by brackets "[]" replaced with your own identifying
18# information: Portions Copyright [yyyy] [name of copyright owner]
19#
20# CDDL HEADER END
21#
22
23Copyright 2004 Sun Microsystems, Inc. All rights reserved.
24Use is subject to license terms.
25
26NOTE: This directory contains legacy initialization and termination
27scripts for managing services. The preferred method of service
28management is via the Service Management Facility; to read more about
29SMF, consult smf(7).
30
31For a general discussion of the mechanism used to invoke these scripts
32see the file /etc/init.d/README.
33
34When moving to run-level 3, via an "init 3" invocation or the SMF major
35milestone "svc:/milestone/multi-user-server:default", /sbin/rc3 executes
36each 'K' script within /etc/rc3.d/ with the argument 'stop', followed by
37each 'S' script within /etc/rc3.d/ with the argument 'start'. All
38start scripts in the directories /etc/rcS.d/ and /etc/rc2.d/ will have
39been run as part of the earlier major milestones. Any warnings, errors,
40or output from the scripts in /etc/rc3.d/ are logged to the file:
41
42/var/svc/log/milestone-multi-user-server:default.log
43
44Scripts in /etc/rc3.d/ may assume the following:
45
46 The NFS server, if enabled, is running and shared NFS filesystems
47 are exported.
48
49For a full list of services brought online before scripts are run, see
50the output of "svcs -l svc:/milestone/multi-user-server:default".
51
README.rcS
1#
2# CDDL HEADER START
3#
4# The contents of this file are subject to the terms of the
5# Common Development and Distribution License, Version 1.0 only
6# (the "License"). You may not use this file except in compliance
7# with the License.
8#
9# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
10# or http://www.opensolaris.org/os/licensing.
11# See the License for the specific language governing permissions
12# and limitations under the License.
13#
14# When distributing Covered Code, include this CDDL HEADER in each
15# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
16# If applicable, add the following below this CDDL HEADER, with the
17# fields enclosed by brackets "[]" replaced with your own identifying
18# information: Portions Copyright [yyyy] [name of copyright owner]
19#
20# CDDL HEADER END
21#
22
23Copyright 2004 Sun Microsystems, Inc. All rights reserved.
24Use is subject to license terms.
25
26NOTE: This directory contains legacy initialization and termination
27scripts for managing services. The preferred method of service
28management is via the Service Management Facility; to read more about
29SMF, consult smf(7).
30
31For a general discussion of the mechanism used to invoke these scripts
32see the file /etc/init.d/README.
33
34After all its dependencies have been satisfied, the start method of the
35SMF major milestone "svc:/milestone/single-user:default" executes each
36'S' script within /etc/rcS.d/ with the argument 'start'. Any warnings,
37errors, or output from these scripts are logged to the file:
38
39/var/svc/log/milestone-single-user:default.log
40
41If the system is changing from a higher run-level (for example, through
42an invocation of "init S"), SMF executes all 'K' scripts within
43/etc/rcS.d/ with the argument 'stop'. Any warnings, errors, or output
44from these scripts are logged to the file:
45
46/var/svc/log/rcS.log
47
48Scripts in /etc/rcS.d/ may assume the following:
49
50 Enough network plumbing has been done to NFS mount /usr/.
51
52 All system-supplied device file names have been established.
53
54 The environment variable _INIT_RECONFIG is set if this is
55 a reconfiguration boot.
56
57 The base system mounts have been performed, and the file
58 systems are read/write if so specified. These are:
59
60 /
61 /usr
62 /proc
63 /dev/fd
64 /tmp
65 /var
66 /var/adm
67 /var/run
68 /dev
69 /devices
70 /etc
71
72For a full list of services brought online before scripts are run, see
73the output of "svcs -l svc:/milestone/single-user:default".
74