xref: /illumos-gate/usr/src/cmd/svc/shell/smf_include.sh (revision 34a0f871d192b33b865455a8812a3d34c1866315)
1#!/bin/sh
2#
3# CDDL HEADER START
4#
5# The contents of this file are subject to the terms of the
6# Common Development and Distribution License (the "License").
7# You may not use this file except in compliance 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#
23# Copyright 2007 Sun Microsystems, Inc.  All rights reserved.
24# Use is subject to license terms.
25#
26#ident	"%Z%%M%	%I%	%E% SMI"
27
28smf_present () {
29	[ -r /etc/svc/volatile/repository_door ] && \
30	    [ ! -f /etc/svc/volatile/repository_door ]
31}
32
33smf_clear_env () {
34	unset \
35		SMF_FMRI \
36		SMF_METHOD \
37		SMF_RESTARTER \
38		SMF_ZONENAME
39}
40
41# smf_console
42#
43#   Use as "echo message 2>&1 | smf_console".  If SMF_MSGLOG_REDIRECT is
44#   unset, message will be displayed to console.  SMF_MSGLOG_REDIRECT is
45#   reserved for future use.
46#
47smf_console () {
48	/usr/bin/tee ${SMF_MSGLOG_REDIRECT:-/dev/msglog}
49}
50
51# smf_zonename
52#
53#  Prints the name of this zone.
54
55smf_zonename() {
56	echo "${SMF_ZONENAME:=`/sbin/zonename`}"
57}
58
59# smf_is_globalzone
60#
61#  Returns zero (success) if this is the global zone.  1 otherwise.
62#
63smf_is_globalzone() {
64	[ "${SMF_ZONENAME:=`/sbin/zonename`}" = "global" ] && return 0
65	return 1
66}
67
68# smf_is_nonglobalzone
69#
70#  Returns zero (success) if this is not the global zone.  1 otherwise.
71#
72smf_is_nonglobalzone() {
73	[ "${SMF_ZONENAME:=`/sbin/zonename`}" != "global" ] && return 0
74	return 1
75}
76
77# smf_configure_ip
78#
79#  Returns zero (success) if this zone needs IP to be configured i.e.
80#  the global zone or has an exclusive stack.  1 otherwise.
81#
82smf_configure_ip() {
83	[ "${SMF_ZONENAME:=`/sbin/zonename`}" = "global" -o \
84	 `/sbin/zonename -t` = exclusive ] && return 0
85	return 1
86}
87
88# smf_dont_configure_ip
89#
90#  Inverse of smf_configure_ip
91#
92smf_dont_configure_ip() {
93	[ "${SMF_ZONENAME:=`/sbin/zonename`}" != "global" -a \
94	 `/sbin/zonename -t` = shared ] && return 0
95	return 1
96}
97
98# smf_is_system_labeled
99#
100#  Returns zero (success) if system is labeled (aka Trusted Extensions).
101#  1 otherwise.
102#
103smf_is_system_labeled() {
104	[ ! -x /bin/plabel ] && return 1
105	/bin/plabel > /dev/null 2>&1
106	return $?
107}
108
109# smf_netstrategy
110#   -> (_INIT_NET_IF, _INIT_NET_STRATEGY)
111#
112#   Sets _INIT_NET_IF to the name for the network-booted
113#   interface if we are booting from the network.  _INIT_NET_STRATEGY is
114#   assigned the value of the current network configuration strategy.
115#   Valid values for _INIT_NET_STRATEGY are "none", "dhcp", and "rarp".
116#
117#   The network boot strategy for a zone is always "none".
118#
119smf_netstrategy () {
120	if smf_is_nonglobalzone; then
121		_INIT_NET_STRATEGY="none" export _INIT_NET_STRATEGY
122		return 0
123	fi
124
125	set -- `/sbin/netstrategy`
126	if [ $? -eq 0 ]; then
127		[ "$1" = "nfs" -o "$1" = "cachefs" ] && \
128			_INIT_NET_IF="$2" export _INIT_NET_IF
129		_INIT_NET_STRATEGY="$3" export _INIT_NET_STRATEGY
130	else
131		return 1
132	fi
133}
134
135#
136# smf_kill_contract CONTRACT SIGNAL WAIT TIMEOUT
137#
138#   To be called from stop methods of non-transient services.
139#   Sends SIGNAL to the service contract CONTRACT.  If the
140#   WAIT argument is non-zero, smf_kill_contract will wait
141#   until the contract is empty before returning, or until
142#   TIMEOUT expires.
143#
144#   Example, send SIGTERM to contract 200:
145#
146#       smf_kill_contract 200 TERM
147#
148#   Since killing a contract with pkill(1) is not atomic,
149#   smf_kill_contract will continue to send SIGNAL to CONTRACT
150#   every second until the contract is empty.  This will catch
151#   races between fork(2) and pkill(1).
152#
153#   Returns 1 if the contract is invalid.
154#   Returns 2 if WAIT is "1", TIMEOUT is > 0, and TIMEOUT expires.
155#   Returns 0 on success.
156#
157smf_kill_contract() {
158
159	time_waited=0
160	time_to_wait=$4
161
162	[ -z "$time_to_wait" ] && time_to_wait=0
163
164	# Verify contract id is valid using pgrep
165	/usr/bin/pgrep -c $1 > /dev/null 2>&1
166	ret=$?
167	if [ $ret -gt 1 ] ; then
168		echo "Error, invalid contract \"$1\"" >&2
169		return 1
170	fi
171
172	# Return if contract is already empty.
173	[ $ret -eq 1 ] && return 0
174
175	# Kill contract.
176	/usr/bin/pkill -$2 -c $1
177	if [ $? -gt 1 ] ; then
178		echo "Error, could not kill contract \"$1\"" >&2
179		return 1
180	fi
181
182	# Return if WAIT is not set or is "0"
183	[ -z "$3" ] && return 0
184	[ "$3" -eq 0 ] && return 0
185
186	# If contract does not empty, keep killing the contract to catch
187	# any child processes missed because they were forking
188	/usr/bin/sleep 5
189	/usr/bin/pgrep -c $1 > /dev/null 2>&1
190	while [ $? -eq 0 ] ; do
191
192		time_waited=`/usr/bin/expr $time_waited + 5`
193
194		# Return  if TIMEOUT was passed, and it has expired
195		[ "$time_to_wait" -gt 0 -a $time_waited -ge $time_to_wait ] && \
196		    return 2
197		/usr/bin/pkill -$2 -c $1
198		/usr/bin/sleep 5
199		/usr/bin/pgrep -c $1 > /dev/null 2>&1
200	done
201
202	return 0
203}
204
205#
206# smf(5) method and monitor exit status definitions
207#   SMF_EXIT_ERR_OTHER, although not defined, encompasses all non-zero
208#   exit status values.
209#
210SMF_EXIT_OK=0
211SMF_EXIT_ERR_FATAL=95
212SMF_EXIT_ERR_CONFIG=96
213SMF_EXIT_MON_DEGRADE=97
214SMF_EXIT_MON_OFFLINE=98
215SMF_EXIT_ERR_NOSMF=99
216SMF_EXIT_ERR_PERM=100
217