xref: /titanic_41/usr/src/cmd/initpkg/init.d/README (revision 7c478bd95313f5f23a4c958a745db2134aa03244)
1*7c478bd9Sstevel@tonic-gate#
2*7c478bd9Sstevel@tonic-gate# CDDL HEADER START
3*7c478bd9Sstevel@tonic-gate#
4*7c478bd9Sstevel@tonic-gate# The contents of this file are subject to the terms of the
5*7c478bd9Sstevel@tonic-gate# Common Development and Distribution License, Version 1.0 only
6*7c478bd9Sstevel@tonic-gate# (the "License").  You may not use this file except in compliance
7*7c478bd9Sstevel@tonic-gate# with the License.
8*7c478bd9Sstevel@tonic-gate#
9*7c478bd9Sstevel@tonic-gate# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
10*7c478bd9Sstevel@tonic-gate# or http://www.opensolaris.org/os/licensing.
11*7c478bd9Sstevel@tonic-gate# See the License for the specific language governing permissions
12*7c478bd9Sstevel@tonic-gate# and limitations under the License.
13*7c478bd9Sstevel@tonic-gate#
14*7c478bd9Sstevel@tonic-gate# When distributing Covered Code, include this CDDL HEADER in each
15*7c478bd9Sstevel@tonic-gate# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
16*7c478bd9Sstevel@tonic-gate# If applicable, add the following below this CDDL HEADER, with the
17*7c478bd9Sstevel@tonic-gate# fields enclosed by brackets "[]" replaced with your own identifying
18*7c478bd9Sstevel@tonic-gate# information: Portions Copyright [yyyy] [name of copyright owner]
19*7c478bd9Sstevel@tonic-gate#
20*7c478bd9Sstevel@tonic-gate# CDDL HEADER END
21*7c478bd9Sstevel@tonic-gate#
22*7c478bd9Sstevel@tonic-gate#ident	"%Z%%M%	%I%	%E% SMI"
23*7c478bd9Sstevel@tonic-gateCopyright 2004 Sun Microsystems, Inc.  All rights reserved.
24*7c478bd9Sstevel@tonic-gateUse is subject to license terms.
25*7c478bd9Sstevel@tonic-gate
26*7c478bd9Sstevel@tonic-gateNOTE: This directory contains legacy initialization and termination
27*7c478bd9Sstevel@tonic-gatescripts for managing services.  The preferred method of service
28*7c478bd9Sstevel@tonic-gatemanagement is via the Service Management Facility; to read more about
29*7c478bd9Sstevel@tonic-gateSMF, consult smf(5).
30*7c478bd9Sstevel@tonic-gate
31*7c478bd9Sstevel@tonic-gateFile names in rc?.d directories are of the form [SK]nn<init.d filename>
32*7c478bd9Sstevel@tonic-gatewhere 'S' means start this job, 'K' means kill this job, and 'nn' is the
33*7c478bd9Sstevel@tonic-gaterelative sequence number for killing or starting the job.  When
34*7c478bd9Sstevel@tonic-gateexecuting each script in one of the /etc/rc[S0-6] directories, the
35*7c478bd9Sstevel@tonic-gate/sbin/rc[S0-6] script passes a single argument.  It passes the argument
36*7c478bd9Sstevel@tonic-gate'stop' for scripts prefixed with 'K' and the argument 'start' for
37*7c478bd9Sstevel@tonic-gatescripts prefixed with 'S'.  There is no harm in applying the same
38*7c478bd9Sstevel@tonic-gatesequence number to multiple scripts.  In this case the order of
39*7c478bd9Sstevel@tonic-gateexecution is deterministic but unspecified.  It is recommended that
40*7c478bd9Sstevel@tonic-gatescripts be hard-linked from the same file stored in /etc/init.d/.
41*7c478bd9Sstevel@tonic-gate
42*7c478bd9Sstevel@tonic-gateOn earlier Solaris releases, a script named with a suffix of '.sh' would
43*7c478bd9Sstevel@tonic-gatebe sourced, allowing scripts to modify the environment of other scripts
44*7c478bd9Sstevel@tonic-gateexecuted later.  This behavior is no longer supported; for altering the
45*7c478bd9Sstevel@tonic-gateenvironment in which services are run, refer to the SMF documentation.
46*7c478bd9Sstevel@tonic-gate
47*7c478bd9Sstevel@tonic-gateLegacy services are reported by the default svcs(1m) output, and (where
48*7c478bd9Sstevel@tonic-gateappropriate) the utility's '-p' option.  This reporting assumes a
49*7c478bd9Sstevel@tonic-gatebehavior as described above, such that each 'S' script has a suitable
50*7c478bd9Sstevel@tonic-gatematching 'K' script, and they are both hard linked to a script in
51*7c478bd9Sstevel@tonic-gate/etc/init.d/.  If this is not the case, legacy service reporting may not
52*7c478bd9Sstevel@tonic-gateoperate accurately; under all circumstances, the scripts are always
53*7c478bd9Sstevel@tonic-gateexecuted as described above.
54*7c478bd9Sstevel@tonic-gate
55*7c478bd9Sstevel@tonic-gateThe run-levels operate as follows:
56*7c478bd9Sstevel@tonic-gate
57*7c478bd9Sstevel@tonic-gates/S
58*7c478bd9Sstevel@tonic-gate
59*7c478bd9Sstevel@tonic-gate	Read /etc/rcS.d/README for details. This run-level corresponds to
60*7c478bd9Sstevel@tonic-gate	the milestone svc:/milestone/single-user:default.
61*7c478bd9Sstevel@tonic-gate
62*7c478bd9Sstevel@tonic-gate0/5/6
63*7c478bd9Sstevel@tonic-gate
64*7c478bd9Sstevel@tonic-gate	All /etc/rc0.d/K* scripts are run, followed by all /etc/rc0.d/S*
65*7c478bd9Sstevel@tonic-gate	scripts. The S* scripts should only be used for cleanup during
66*7c478bd9Sstevel@tonic-gate	shutdown.
67*7c478bd9Sstevel@tonic-gate
68*7c478bd9Sstevel@tonic-gate1
69*7c478bd9Sstevel@tonic-gate
70*7c478bd9Sstevel@tonic-gate	If the system was in a higher run-level, all /etc/rc1.d/K* scripts
71*7c478bd9Sstevel@tonic-gate	are run. Regardless of the previous run-level, all /etc/rc1.d/S*
72*7c478bd9Sstevel@tonic-gate	scripts are run.
73*7c478bd9Sstevel@tonic-gate
74*7c478bd9Sstevel@tonic-gate2
75*7c478bd9Sstevel@tonic-gate
76*7c478bd9Sstevel@tonic-gate	Read /etc/rc2.d/README for details. This run-level corresponds to
77*7c478bd9Sstevel@tonic-gate	the milestone svc:/milestone/multi-user:default.
78*7c478bd9Sstevel@tonic-gate
79*7c478bd9Sstevel@tonic-gate3
80*7c478bd9Sstevel@tonic-gate
81*7c478bd9Sstevel@tonic-gate	Read /etc/rc3.d/README for details. This run-level corresponds to
82*7c478bd9Sstevel@tonic-gate	the milestone svc:/milestone/multi-user-server:default.
83*7c478bd9Sstevel@tonic-gate
84