Context Navigation

source: bootscripts/contrib/enhanced/init.d/functions @ 163a6701

clfs-1.2clfs-2.1clfs-3.0.0-systemdclfs-3.0.0-sysvinitsystemdsysvinit

Last change on this file since 163a6701 was 163a6701, checked in by Jim Gifford <clfs@…>, 18 years ago
r720@server (orig r718): jim \| 2005-11-18 08:06:26 -0800 Added bootscripts to cross-lfs svn
Property mode set to `100644`
File size: 18.4 KB

Line
1	#!/bin/sh
2	########################################################################
3	# Begin $rc_base/init.d/functions
4	#
5	# Description : Run Level Control Functions
6	#
7	# Authors : Gerard Beekmans - gerard@linuxfromscratch.org
8	#
9	# Version : 00.00
10	#
11	# Notes : With code based on Matthias Benkmann's simpleinit-msb
12	# http://winterdrache.de/linux/newboot/index.html
13	# Updated for Interactive bootscript execution and
14	# bootlogging prior to start of syslog
15	########################################################################
16
17	## Environmental setup
18	# Setup default values for environment
19	umask 022
20	export PATH="/bin:/usr/bin:/sbin:/usr/sbin"
21
22	# Signal sent to running processes to refresh their configuration
23	RELOADSIG="HUP"
24
25	# Number of seconds between STOPSIG and FALLBACK when stopping processes
26	KILLDELAY="3"
27
28	## Screen Dimensions
29	# Find current screen size
30	if [ -z "${COLUMNS}" ]; then
31	COLUMNS=$(stty size)
32	COLUMNS=${COLUMNS##* }
33	fi
34
35	# When using remote connections, such as a serial port, stty size returns 0
36	if [ "${COLUMNS}" = "0" ]; then
37	COLUMNS=80
38	fi
39
40	## Measurements for positioning result messages
41	COL=$((${COLUMNS} - 8))
42	WCOL=$((${COL} - 2))
43
44	## Set Cursor Position Commands, used via echo -e
45	SET_COL="\\033[${COL}G" # at the $COL char
46	SET_WCOL="\\033[${WCOL}G" # at the $WCOL char
47	CURS_UP="\\033[1A\\033[0G" # Up one line, at the 0'th char
48
49	## Set color commands, used via echo -e
50	# Please consult `man console_codes for more information
51	# under the "ECMA-48 Set Graphics Rendition" section
52	#
53	# Warning: when switching from a 8bit to a 9bit font,
54	# the linux console will reinterpret the bold (1;) to
55	# the top 256 glyphs of the 9bit font. This does
56	# not affect framebuffer consoles
57	NORMAL="\\033[0;39m" # Standard console grey
58	SUCCESS="\\033[1;32m" # Success is green
59	WARNING="\\033[1;33m" # Warnings are yellow
60	FAILURE="\\033[1;31m" # Failures are red
61	INFO="\\033[1;36m" # Information is light cyan
62	BRACKET="\\033[1;34m" # Brackets are blue
63
64	## Set screen and bootlog message values to zero
65	BOOTMESG="" # text meant for the logfile
66	BOOTMESGPRN="" # text meant for the console
67	CUR_LENGTH="0" # the current line length
68	CHARS_LEFT="${WCOL}" # avilible space on the current line
69	STRING_LENGTH="0" # the length of the current message
70	BMSEP="" # contains neline separated bootmessage
71	BMSEPCT="" # used for character counts of each word in BMSEP
72	BMWORD="" # last printed word before a newline when wrapping text
73
74	#*******************************************************************************
75	# Function - boot_mesg()
76	#
77	# Purpose: Sending information from bootup scripts to the console
78	#
79	# Inputs: $1 is the message
80	# $2 is the colorcode for the console
81	#
82	# Outputs: Standard Output
83	#
84	# Dependencies: - sed for parsing strings.
85	# - grep, for counting \n's in a variable.
86	#
87	# Todo: - This function was created for the purpose of storing
88	# information to be passed to a bootup log and for better
89	# formatting of text sent to the screen. The logging support
90	# now pushes messages to the local2 service which is now
91	# configured by LFS default in syslog.conf. This also
92	# requires that /usr/bin/logger be moved to /bin.
93	# Support for parallel bootscripts is not added yet...
94	#*******************************************************************************
95	boot_mesg()
96	{
97	local ECHOPARM=""
98	##### NOTE!!!! A single message cannot span two complete lines
99	##### (longer than WCOL) or exceed 100 words.
100
101	while true
102	do
103	case "${1}" in
104	-n)
105	ECHOPARM=" -n "
106	shift 1
107	;;
108	-*)
109	echo "Unknown Option: ${1}"
110	return 1
111	;;
112	*)
113	break
114	;;
115	esac
116	done
117
118	## Figure out the length of what is to be printed.
119	# This is effectivly eqivelent to wc -m.
120	STRING_LENGTH="$(( `echo "${1}" \| sed \
121	-e 's,.,.,g' -e 'l 1' \| grep -c \$` - 2 ))"
122
123	# Append to BOOTMESG for logging
124	BOOTMESG="${BOOTMESG} ${1}"
125
126	# Find out how much room is left to work with
127	CHARS_LEFT="$(( ${WCOL} - ${CUR_LENGTH} ))"
128
129	# If the message doesn't exceed the remaining columns
130	# of the current line, just print it...
131	if [ "${STRING_LENGTH}" -le "${CHARS_LEFT}" ]; then
132	CUR_LENGTH="$(( ${CUR_LENGTH} + ${STRING_LENGTH} ))"
133	BOOTMESGPRN="${1}"
134
135	# Avoid a null value being passed to sed
136	if [ "${STRING_LENGTH}" -eq "${CHARS_LEFT}" ]; then
137	# set CUR_LENGTH to zero
138	CUR_LENGTH="0"
139	fi
140
141	else
142
143	## Do some adjustments to the output because it
144	## it is too long to fit on one line
145
146	# BMSEP is the boot message with each word
147	# on one line of it's own
148	BMSEP=`echo "${1}" \| sed 's/ /\\\n/g'`
149
150	# To work proerly with unicode, each character
151	# is replaced with a single dot (.) for counting.
152	### Note that this is still broken for Chinese,
153	### Japanese, and Korean because of characters
154	### that actually use two columns when printed
155	### to the screen.
156	BMSEPCT=`echo -e "${BMSEP}" \| sed 's/././g'`
157
158	# keep adding the character count of each line
159	# untill the count exceeds the value of CHARS_LEFT
160	# There is a ceiling of 100 words!
161	n="1"
162	while [ "${n}" -lt "100" ]; do
163	char_count="$(( `echo -e "${BMSEPCT}" \| \
164	sed -n "${n}"'~0p' \| sed 'l 1' \| \
165	grep -c \$` - 2 ))"
166	if [ "$(( ${CUR_LENGTH} + ${char_count} ))" \
167	-lt "${WCOL}" ]; then
168	let n++
169	CUR_LENGTH="$(( ${CUR_LENGTH} + ${char_count} + 1 ))"
170	else
171	let n--
172	break;
173	fi
174	done
175
176	# The number of words that will fit is now
177	# represented by 'n'. Find the nth word.
178	BMWORD="$( echo -e "${BMSEP}" \| sed -n "${n}"'~0p' )"
179
180	# Get rid of the extra space
181	BMWORD="${BMWORD} "
182
183	# And format the message as needed.
184	BOOTMESGPRN=`echo "${1}" \| \
185	sed "s/${BMWORD}/${BMWORD}\\\n/"`
186
187	# Now, determine the length of the second line
188	CUR_LENGTH=$(( `echo -e "${BOOTMESGPRN}" \| sed -n '2~0p' \| \
189	sed -e 's,.,.,g' -e 'l 1' \| grep -c \$` - 2 ))
190	fi
191
192	# Print the results to the screen
193	echo ${ECHOPARM} -e "${2}${BOOTMESGPRN}"
194
195	# if CUR_LENGTH was set to zero, then end the line
196	if [ "${CUR_LENGTH}" = "0" ]; then
197	echo ""
198	fi
199	}
200
201	boot_mesg_flush()
202	{
203	# Do not log null messages
204	if [ -z "${BOOTMESG}" ]; then
205	return 0
206	else
207	boot_log "${BOOTMESG}${@}"
208	fi
209
210	# Reset boot message buffers to keep from bleeding over again
211	BOOTMESG=""
212	BOOTMESGPRN=""
213	CUR_LENGTH="0"
214	CHARS_LEFT="${WCOL}"
215	STRING_LENGTH="0"
216	BMSEP=""
217	BMSEPCT=""
218	BMWORD=""
219	}
220
221	boot_log()
222	{
223	if [ -f /bin/logger ]; then
224	if [ "${runlevel}" = "sysinit" ]; then
225	/bin/logger -t bootlog "${@}" -s 2>&1 \| \
226	cat >> /media/boottemp/.logcache
227	else
228	/bin/logger -p "${BLSERVICE}".info -t bootlog "${@}"
229	fi
230	else
231	return 0
232	fi
233	}
234
235	echo_ok()
236	{
237	echo -n -e "${CURS_UP}${SET_COL}${BRACKET}[${SUCCESS} OK ${BRACKET}]"
238	echo -e "${NORMAL}"
239	boot_mesg_flush "[ OK ]"
240	}
241
242	echo_failure()
243	{
244	echo -n -e "${CURS_UP}${SET_COL}${BRACKET}[${FAILURE} FAIL ${BRACKET}]"
245	echo -e "${NORMAL}"
246	boot_mesg_flush "[ FAIL ]"
247	}
248
249	echo_warning()
250	{
251	echo -n -e "${CURS_UP}${SET_COL}${BRACKET}[${WARNING} WARN ${BRACKET}]"
252	echo -e "${NORMAL}"
253	boot_mesg_flush "[ WARN ]"
254	}
255
256	print_error_msg()
257	{
258	echo_failure
259	# $i is inherited by the rc script
260	boot_log "\n\n${i} failed and exited with a return value of ${error_value}."
261	boot_mesg_flush
262	boot_mesg -n "FAILURE:\n\nYou should not be reading this error message.\n\n" ${FAILURE}
263	boot_mesg -n " It means that an unforeseen error took"
264	boot_mesg -n " place in ${i}, which exited with a return value of"
265	boot_mesg " ${error_value}.\n"
266	boot_mesg_flush
267	boot_mesg -n "If you're able to track this"
268	boot_mesg -n " error down to a bug in one of the files provided by"
269	boot_mesg -n " the LFS book, please be so kind to inform us at"
270	boot_mesg " lfs-dev@linuxfromscratch.org.\n"
271	boot_mesg_flush
272	boot_mesg -n "Press Enter to continue..." ${INFO}
273	boot_mesg "" ${NORMAL}
274	read ENTER
275	}
276
277	check_script_status()
278	{
279	# $i is inherited by the rc script
280	if [ ! -f ${i} ]; then
281	boot_mesg "${i} is not a valid symlink." ${WARNING}
282	echo_warning
283	continue
284	fi
285
286	if [ ! -x ${i} ]; then
287	boot_mesg "${i} is not executable, skipping." ${WARNING}
288	echo_warning
289	continue
290	fi
291	}
292
293	evaluate_retval()
294	{
295	error_value="${?}"
296
297	if [ ${error_value} = 0 ]; then
298	echo_ok
299	else
300	echo_failure
301	fi
302
303	# This prevents the 'An Unexpected Error Has Occurred' from trivial
304	# errors.
305	return 0
306	}
307
308	print_status()
309	{
310	if [ "${#}" = "0" ]; then
311	echo "Usage: ${0} {success\|warning\|failure}"
312	return 1
313	fi
314
315	case "${1}" in
316
317	success)
318	echo_ok
319	;;
320
321	warning)
322	# Leave this extra case in because old scripts
323	# may call it this way.
324	case "${2}" in
325	running)
326	echo -e -n "${CURS_UP}"
327	echo -e -n "\\033[${CUR_LENGTH}G "
328	boot_mesg "Already running." ${WARNING}
329	echo_warning
330	;;
331	not_running)
332	echo -e -n "${CURS_UP}"
333	echo -e -n "\\033[${CUR_LENGTH}G "
334	boot_mesg "Not running." ${WARNING}
335	echo_warning
336	;;
337	not_available)
338	echo -e -n "${CURS_UP}"
339	echo -e -n "\\033[${CUR_LENGTH}G "
340	boot_mesg "Not available." ${WARNING}
341	echo_warning
342	;;
343	*)
344	# This is how it is supposed to
345	# be called
346	echo_warning
347	;;
348	esac
349	;;
350
351	failure)
352	echo_failure
353	;;
354
355	esac
356
357	}
358
359	reloadproc()
360	{
361	if [ "${#}" = "0" ]; then
362	echo "Usage: reloadproc [{program}]"
363	exit 1
364	fi
365
366	getpids "${1}"
367
368	if [ -n "${pidlist}" ]; then
369	failure="0"
370	for pid in ${pidlist}
371	do
372	kill -"${RELOADSIG}" "${pid}" \|\| failure="1"
373	done
374
375	(exit ${failure})
376	evaluate_retval
377
378	else
379	boot_mesg "Process ${1} not running." ${WARNING}
380	echo_warning
381	fi
382	}
383
384	statusproc()
385	{
386	if [ "${#}" = "0" ]
387	then
388	echo "Usage: statusproc {program}"
389	exit 1
390	fi
391
392	getpids "${1}"
393
394	if [ -n "${pidlist}" ]; then
395	echo -e "${INFO}${base} is running with Process"\
396	"ID(s) ${pidlist}.${NORMAL}"
397	else
398	if [ -n "${base}" -a -e "/var/run/${base}.pid" ]; then
399	echo -e "${WARNING}${1} is not running but"\
400	"/var/run/${base}.pid exists.${NORMAL}"
401	else
402	if [ -n "${PIDFILE}" -a -e "${PIDFILE}" ]; then
403	echo -e "${WARNING}${1} is not running"\
404	"but ${PIDFILE} exists.${NORMAL}"
405	else
406	echo -e "${INFO}${1} is not running.${NORMAL}"
407	fi
408	fi
409	fi
410	}
411
412	# The below functions are documented in the LSB-generic 2.1.0
413
414	#*******************************************************************************
415	# Function - pidofproc [-s] [-p pidfile] pathname
416	#
417	# Purpose: This function returns one or more pid(s) for a particular daemon
418	#
419	# Inputs: -p pidfile, use the specified pidfile instead of pidof
420	# pathname, path to the specified program
421	#
422	# Outputs: return 0 - Success, pid's in stdout
423	# return 1 - Program is dead, pidfile exists
424	# return 2 - Invalid or excessive number of arguments,
425	# warning in stdout
426	# return 3 - Program is not running
427	#
428	# Dependencies: pidof, echo, head
429	#
430	# Todo: Remove dependency on head
431	# This depreciates getpids
432	# Test changes to pidof
433	#
434	#*******************************************************************************
435	pidofproc()
436	{
437	local pidfile=""
438	local lpids=""
439	local silent=""
440	pidlist=""
441	while true
442	do
443	case "${1}" in
444	-p)
445	pidfile="${2}"
446	shift 2
447	;;
448
449	-s)
450	# Added for legacy opperation of getpids
451	# eliminates several '> /dev/null'
452	silent="1"
453	shift 1
454	;;
455	-*)
456	log_failure_msg "Unknown Option: ${1}"
457	return 2
458	;;
459	*)
460	break
461	;;
462	esac
463	done
464
465	if [ "${#}" != "1" ]; then
466	shift 1
467	log_failure_msg "Usage: pidofproc [-s] [-p pidfile] pathname"
468	return 2
469	fi
470
471	if [ -n "${pidfile}" ]; then
472	if [ ! -r "${pidfile}" ]; then
473	return 3 # Program is not running
474	fi
475
476	lpids=`head -n 1 ${pidfile}`
477	for pid in ${lpids}
478	do
479	if [ "${pid}" -ne "$$" -a "${pid}" -ne "${PPID}" ]; then
480	kill -0 "${pid}" > /dev/null &&
481	pidlist="${pidlist} ${pid}"
482	fi
483
484	if [ "${silent}" -ne "1" ]; then
485	echo "${pidlist}"
486	fi
487
488	test -z "${pidlist}" &&
489	# Program is dead, pidfile exists
490	return 1
491	# else
492	return 0
493	done
494
495	else
496	pidlist=`pidof -o $$ -o $PPID -x "$1"`
497	if [ "x${silent}" != "x1" ]; then
498	echo "${pidlist}"
499	fi
500
501	# Get provide correct running status
502	if [ -n "${pidlist}" ]; then
503	return 0
504	else
505	return 3
506	fi
507
508	fi
509
510	if [ "$?" != "0" ]; then
511	return 3 # Program is not running
512	fi
513	}
514
515	# This will ensure compatibility with previous LFS Bootscripts
516	getpids()
517	{
518	if [ -z "${PIDFILE}" ]; then
519	pidofproc -s -p "${PIDFILE}" $@
520	else
521	pidofproc -s $@
522	fi
523	base="${1##*/}"
524	}
525
526	#*******************************************************************************
527	# Function - loadproc [-f] [-n nicelevel] [-p pidfile] pathname [args]
528	#
529	# Purpose: This runs the specified program as a daemon
530	#
531	# Inputs: -f, run the program even if it is already running
532	# -n nicelevel, specifies a nice level. See nice(1).
533	# -p pidfile, uses the specified pidfile
534	# pathname, pathname to the specified program
535	# args, arguments to pass to specified program
536	#
537	# Outputs: return 0 - Success
538	# return 2 - Invalid of excessive number of arguments,
539	# warning in stdout
540	# return 4 - Program or service status is unknown
541	#
542	# Dependencies: nice
543	#
544	# Todo: LSB says this should be called start_daemon
545	# LSB does not say that it should call evaluate_retval
546	# It checks for PIDFILE, which is deprecated.
547	# Will be removed after BLFS 6.0
548	# loadproc returns 0 if program is already running, not LSB compliant
549	#
550	#*******************************************************************************
551	loadproc()
552	{
553	local pidfile=""
554	local forcestart=""
555	local nicelevel="10"
556
557	# This will ensure compatibility with previous LFS Bootscripts
558	if [ -n "${PIDFILE}" ]; then
559	pidfile="${PIDFILE}"
560	fi
561
562	while true
563	do
564	case "${1}" in
565	-f)
566	forcestart="1"
567	shift 1
568	;;
569	-n)
570	nicelevel="${2}"
571	shift 2
572	;;
573	-p)
574	pidfile="${2}"
575	shift 2
576	;;
577	-*)
578	log_failure_msg "Unknown Option: ${1}"
579	return 2 #invalid or excess argument(s)
580	;;
581	*)
582	break
583	;;
584	esac
585	done
586
587	if [ "${#}" = "0" ]; then
588	log_failure_msg "Usage: loadproc [-f] [-n nicelevel] [-p pidfile] pathname [args]"
589	return 2 #invalid or excess argument(s)
590	fi
591
592	if [ -z "${forcestart}" ]; then
593	if [ -z "${pidfile}" ]; then
594	pidofproc -s "${1}"
595	else
596	pidofproc -s -p "${pidfile}" "${1}"
597	fi
598
599	case "${?}" in
600	0)
601	log_warning_msg "Unable to continue: ${1} is running"
602	return 0 # 4
603	;;
604	1)
605	log_warning_msg "Unable to continue: ${pidfile} exists"
606	return 0 # 4
607	;;
608	3)
609	;;
610	*)
611	log_failure_msg "Unknown error code from pidofproc: ${?}"
612	return 4
613	;;
614	esac
615	fi
616
617	nice -n "${nicelevel}" "${@}"
618	evaluate_retval # This is "Probably" not LSB compliant, but required to be compatible with older bootscripts
619	return 0
620	}
621
622	#*******************************************************************************
623	# Function - killproc [-p pidfile] pathname [signal]
624	#
625	# Purpose:
626	#
627	# Inputs: -p pidfile, uses the specified pidfile
628	# pathname, pathname to the specified program
629	# signal, send this signal to pathname
630	#
631	# Outputs: return 0 - Success
632	# return 2 - Invalid of excessive number of arguments,
633	# warning in stdout
634	# return 4 - Unknown Status
635	#
636	# Dependencies: kill
637	#
638	# Todo: LSB does not say that it should call evaluate_retval
639	# It checks for PIDFILE, which is deprecated.
640	# Will be removed after BLFS 6.0
641	#
642	#*******************************************************************************
643	killproc()
644	{
645	local pidfile=""
646	local killsig=""
647	pidlist=""
648
649	# This will ensure compatibility with previous LFS Bootscripts
650	if [ -n "${PIDFILE}" ]; then
651	pidfile="${PIDFILE}"
652	fi
653
654	while true
655	do
656	case "${1}" in
657	-p)
658	pidfile="${2}"
659	shift 2
660	;;
661	-*)
662	log_failure_msg "Unknown Option: ${1}"
663	return 2
664	;;
665	*)
666	break
667	;;
668	esac
669	done
670
671	if [ "${#}" = "2" ]; then
672	killsig="${2}"
673	elif [ "${#}" != "1" ]; then
674	shift 2
675	log_failure_msg "Usage: killproc [-p pidfile] pathname [signal]"
676	return 2
677	fi
678
679	if [ -z "${pidfile}" ]; then
680	pidofproc -s "${1}"
681	else
682	pidofproc -s -p "${pidfile}" "${1}"
683	fi
684
685	if [ -n "${pidlist}" ]; then
686	for pid in ${pidlist}
687	do
688	kill -${killsig:-TERM} ${pid} 2>/dev/null
689	if [ -z "${killsig}" ]; then
690	# Wait up to 3 seconds, for ${pid} to terminate
691	local dtime=${KILLDELAY}
692	while [ "${dtime}" != "0" ]
693	do
694	kill -0 ${pid} 2>/dev/null \|\| break
695	sleep 1
696	dtime=$(( ${dtime} - 1))
697	done
698	# If ${pid} is still running, kill it
699	kill -0 ${pid} 2>/dev/null && kill -KILL ${pid} 2>/dev/null
700	fi
701	done
702
703	if [ -z "${killsig}" ]; then
704	pidofproc -s "${1}"
705
706	# Program was terminated
707	if [ "$?" != "0" ]; then
708	# Pidfile Exists
709	if [ -f "${pidfile}" ]; then
710	rm -f "${pidfile}"
711	fi
712	echo_ok
713	return 0
714	else # Program is still running
715	echo_failure
716	return 4 # Unknown Status
717	fi
718	else
719	if [ -z "${pidfile}" ]; then
720	pidofproc -s "${1}"
721	else
722	pidofproc -s -p "${pidfile}" "${1}"
723	fi
724	fi
725
726	evaluate_retval
727
728	else
729	print_status warning not_running
730	fi
731	}
732
733
734	#*******************************************************************************
735	# Function - log_success_msg "message"
736	#
737	# Purpose: Print a success message
738	#
739	# Inputs: $@ - Message
740	#
741	# Outputs: Text output to screen
742	#
743	# Dependencies: echo
744	#
745	# Todo: logging
746	#
747	#*******************************************************************************
748	log_success_msg()
749	{
750	echo -n -e "${BOOTMESG_PREFIX}${@}"
751	echo -e "${SET_COL}""${BRACKET}""[""${SUCCESS}"" OK ""${BRACKET}""]""${NORMAL}"
752	return 0
753	}
754
755	#*******************************************************************************
756	# Function - log_failure_msg "message"
757	#
758	# Purpose: Print a failure message
759	#
760	# Inputs: $@ - Message
761	#
762	# Outputs: Text output to screen
763	#
764	# Dependencies: echo
765	#
766	# Todo: logging
767	#
768	#*******************************************************************************
769	log_failure_msg() {
770	echo -n -e "${BOOTMESG_PREFIX}${@}"
771	echo -e "${SET_COL}""${BRACKET}""[""${FAILURE}"" FAIL ""${BRACKET}""]""${NORMAL}"
772	return 0
773	}
774
775	#*******************************************************************************
776	# Function - log_warning_msg "message"
777	#
778	# Purpose: print a warning message
779	#
780	# Inputs: $@ - Message
781	#
782	# Outputs: Text output to screen
783	#
784	# Dependencies: echo
785	#
786	# Todo: logging
787	#
788	#*******************************************************************************
789	log_warning_msg() {
790	echo -n -e "${BOOTMESG_PREFIX}${@}"
791	echo -e "${SET_COL}""${BRACKET}""[""${WARNING}"" WARN ""${BRACKET}""]""${NORMAL}"
792	return 0
793	}
794
795	# End $rc_base/init.d/functions

Note: See TracBrowser for help on using the repository browser.

Download in other formats: