d95be1db89c32a94323f38dc8d6bac21a6420041
[grml-etc-core.git] / etc / grml / lsb-functions
1 # lsb init-functions
2 #
3 # based on:
4 # /lib/lsb/init-functions for Debian -*- shell-script -*-
5 #
6 # Copyright (c) 2002-03 Chris Lawrence
7 # All rights reserved.
8 #
9 # Redistribution and use in source and binary forms, with or without
10 # modification, are permitted provided that the following conditions
11 # are met:
12 # 1. Redistributions of source code must retain the above copyright
13 #    notice, this list of conditions and the following disclaimer.
14 # 2. Redistributions in binary form must reproduce the above copyright
15 #    notice, this list of conditions and the following disclaimer in the
16 #    documentation and/or other materials provided with the distribution.
17 # 3. Neither the name of the author nor the names of other contributors
18 #    may be used to endorse or promote products derived from this software
19 #    without specific prior written permission.
20 #
21 # THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
22 # ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23 # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24 # ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
25 # FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
26 # DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
27 # OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
28 # HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
29 # LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
30 # OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
31 # SUCH DAMAGE.
32
33 # log_*() functions {{{
34 TPUT="${TPUT:-"/usr/bin/tput"}"
35
36 _have_tput() {
37     [ -x "$TPUT" ] && "$TPUT" hpa 60 >/dev/null 2>&1 \
38         && return 0 \
39         || return 1
40 }
41
42 log_success_msg() {
43     printf " * $@\n"
44 }
45
46 log_failure_msg() {
47     if _have_tput ; then
48         RED="$("$TPUT" setaf 1)"
49         #NORMAL="$("$TPUT" op)"
50         printf " ${RED}*${NORMAL} $@\n"
51     else
52         printf " * $@\n"
53     fi
54 }
55
56 log_warning_msg() {
57     if _have_tput ; then
58         YELLOW="$("$TPUT" setaf 3)"
59         #NORMAL="$("$TPUT" op")"
60         # printf " *${NORMAL} $@\n"
61         printf " ${BLUE}*${NORMAL} $@\n"
62     else
63         printf " * $@\n"
64     fi
65 }
66
67 log_warning_msg_nn() {
68     if _have_tput ; then
69         YELLOW="$("$TPUT" setaf 3)"
70         printf " ${BLUE}*${NORMAL} $@"
71     else
72         printf " * $@"
73     fi
74 }
75
76 # int log_begin_message (char *message)
77 log_begin_msg() {
78         if [ "$#" -eq 0 ]; then
79                 return 1
80         fi
81         printf " ${GREEN}*${NORMAL} $@\n"
82 }
83
84 log_begin_msg_nn() {
85         if [ "$#" -eq 0 ]; then
86                 return 1
87         fi
88         printf " ${GREEN}*${NORMAL} $@"
89 }
90
91
92 SUBMSG="   ${GREEN}-${NORMAL} "
93
94 # int log_end_message (int exitstatus)
95 log_end_msg() {
96
97     # If no arguments were passed, return
98     [ "$#" -eq 0 ] && return 1
99
100     # Only do the fancy stuff if we have an appropriate terminal
101     # and if /usr is already mounted
102     if _have_tput ; then
103         COLS="$("$TPUT" cols)"
104         if [ -n "$COLS" ]; then
105             COL=$(( $COLS - 7 ))
106         else
107             COL=73
108         fi
109         UP="$("$TPUT" cuu1)"
110         END="$("$TPUT" hpa "$COL")"
111         START="$("$TPUT" hpa 0)"
112         #RED="$("$TPUT" setaf 1)"
113         #NORMAL="$("$TPUT" op)"
114         if [ "$1" -eq 0 ]; then
115             printf "${UP}${END}${BLUE}[ ${GREEN}ok ${BLUE}]${NORMAL}\n"
116         else
117             printf "${UP}${START} ${RED}*${NORMAL}${END}[${RED}fail${NORMAL}]\n"
118         fi
119     else
120         if [ "$1" -eq 0 ]; then
121             printf "   ...done.\n"
122         else
123             printf "   ...fail!\n"
124         fi
125     fi
126     return "$1"
127 }
128 # }}}
129
130 # e*() output functions {{{
131 # heavily based on gentoo's functions.sh; stripped down and modified
132 # to match our needs.
133 #
134 # defined functions:
135 #   ebegin()
136 #   eend()
137 #   eerror()
138 #   eindent()
139 #   einfo()
140 #   einfon()
141 #   eoutdent()
142 #   esetdent()
143 #   esyslog()
144 #   ewarn()
145 #   ewend()
146 #
147 # copyright 1999-2005 gentoo foundation
148 # distributed under the terms of the gnu general public license v2
149 # $header: /var/cvsroot/gentoo-src/rc-scripts/sbin/functions.sh,v 1.81.2.6 2005/05/15 20:00:31 vapier exp $
150
151 # initialisation {{{
152 # internal variables
153
154 # Dont output to stdout?
155 RC_QUIET_STDOUT="no"
156
157 # Default values for e-message indentation and dots
158 RC_INDENTATION=''
159 RC_DEFAULT_INDENT=2
160 #RC_DOT_PATTERN=' .'
161 RC_DOT_PATTERN=''
162 # dont output to stdout?
163 rc_quiet_stdout="no"
164
165 # default values for e-message indentation and dots
166 rc_indentation=''
167 rc_default_indent=2
168 #rc_dot_pattern=' .'
169 rc_dot_pattern=''
170
171 # should we use color?
172 if [ -r /proc/cmdline ] ; then
173   grep -q ' nocolor' /proc/cmdline && RC_NOCOLOR='yes'
174 fi
175 [ -n "$NOCOLORS" ] && RC_NOCOLOR='yes'
176 RC_NOCOLOR="${RC_NOCOLOR:-no}"
177
178 # Can the terminal handle endcols?
179 if [ "${RC_NOCOLOR}" = "yes" ]; then
180   RC_ENDCOL="no"
181 else
182   RC_ENDCOL="yes"
183 fi
184
185 # Setup COLS and ENDCOL so eend can line up the [ ok ]
186 # width of [ ok ] == 7
187 COLS="$(stty size 2>/dev/null | cut -d' ' -f2)"
188 if [ -z "${COLS}" ] || [ "${COLS}" -le 0 ] ; then
189   COLS=80
190 fi
191
192 if [ "${RC_ENDCOL}" = "yes" ]; then
193   ENDCOL="\e[A\e[$(( ${COLS} - 8 ))G"
194 else
195   ENDCOL=''
196 fi
197
198 # Setup the colors so our messages all look pretty
199 if [ "${RC_NOCOLOR}" = "yes" ]; then
200   unset GOOD WARN BAD NORMAL HILITE BRACKET
201 else
202   GOOD='\e[32;01m'
203   WARN='\e[33;01m'
204   BAD='\e[31;01m'
205   NORMAL='\e[0m'
206   HILITE='\e[36;01m'
207   BRACKET='\e[34;01m'
208 fi
209 #}}}
210
211 # void esyslog(char* priority, char* tag, char* message)
212 #
213 #    use the system logger to log a message
214 #
215 esyslog() {
216   local pri
217   local tag
218
219   [ "$#" -le 2 ] && return 0
220   if [ -x /usr/bin/logger ] ; then
221     pri="$1"
222     tag="$2"
223     shift 2
224
225     /usr/bin/logger -p "${pri}" -t "${tag}" -- "$@"
226   fi
227
228   return 0
229 }
230
231 # void eindent(int num)
232 #
233 #    increase the indent used for e-commands.
234 #
235 eindent() {
236   local i="${1:-0}"
237   [ "$i" -gt 0 ] || i="${RC_DEFAULT_INDENT}"
238   esetdent $(( ${#RC_INDENTATION} + $i ))
239 }
240
241 # void eoutdent(int num)
242 #
243 #    decrease the indent used for e-commands.
244 #
245 eoutdent() {
246   local i="${1:-0}"
247   [ "$i" -gt 0 ] || i="${RC_DEFAULT_INDENT}"
248   esetdent $(( ${#RC_INDENTATION} - $i ))
249 }
250
251 # void esetdent(int num)
252 #
253 #    hard set the indent used for e-commands.
254 #    num defaults to 0
255 #
256 esetdent() {
257   local i="${1:-0}"
258   [ "$i" -lt 0 ] && i=0
259   RC_INDENTATION="$(printf "%${i}s" '')"
260 }
261
262 # void einfo(char* message)
263 #
264 #    show an informative message (with a newline)
265 #
266 einfo() {
267   einfon "$*\n"
268   LAST_E_CMD=einfo
269   return 0
270 }
271
272 # void einfon(char* message)
273 #
274 #    show an informative message (without a newline)
275 #
276 einfon() {
277   [ "${RC_QUIET_STDOUT}" = "yes" ] && return 0
278   [ "${RC_ENDCOL}" != "yes" ] && [ "${LAST_E_CMD}" = "ebegin" ] && echo
279   printf " ${GOOD}*${NORMAL} ${RC_INDENTATION}$*"
280   LAST_E_CMD=einfon
281   return 0
282 }
283
284 # void ewarn(char* message)
285 #
286 #    show a warning message + log it
287 #
288 ewarn() {
289   if [ "${RC_QUIET_STDOUT}" = "yes" ]; then
290       printf " $*\n"
291   else
292     [ "${RC_ENDCOL}" != "yes" ] && [ "${LAST_E_CMD}" = "ebegin" ] && echo
293     printf " ${WARN}*${NORMAL} ${RC_INDENTATION}$*\n"
294   fi
295
296   # Log warnings to system log
297   esyslog "daemon.warning" "rc-scripts" "$@"
298
299   LAST_E_CMD=ewarn
300   return 0
301 }
302
303 # void eerror(char* message)
304 #
305 #    show an error message + log it
306 #
307 eerror() {
308   if [ "${RC_QUIET_STDOUT}" = "yes" ]; then
309     printf " $*\n" >&2
310   else
311     [ "${RC_ENDCOL}" != "yes" ] && [ "${LAST_E_CMD}" = "ebegin" ] && echo
312     printf " ${BAD}*${NORMAL} ${RC_INDENTATION}$*\n"
313   fi
314
315   # Log errors to system log
316   esyslog "daemon.err" "rc-scripts" "$@"
317
318   LAST_E_CMD=eerror
319   return 0
320 }
321
322 # void ebegin(char* message)
323 #
324 #    show a message indicating the start of a process
325 #
326 ebegin() {
327   local msg="$@" dots spaces
328   spaces="$(printf '%'"${#RC_DOT_PATTERN}"'s' '')"
329   [ "${RC_QUIET_STDOUT}" = "yes" ] && return 0
330
331   if [ -n "${RC_DOT_PATTERN}" ]; then
332     dots="$(printf "%$(( $COLS - 3 - ${#RC_INDENTATION} - ${#msg} - 7 ))s" '')"
333     while [ "${dots#${spaces}}" != "${dots}" ] ; do
334         dots="${dots#${spaces}}${RC_DOT_PATTERN}"
335     done
336     msg="${msg}${dots}"
337   else
338     msg="${msg} ..."
339   fi
340   einfon "${msg}"
341   [ "${RC_ENDCOL}" = "yes" ] && echo
342
343   LAST_E_LEN=$(( 3 + ${#RC_INDENTATION} + ${#msg} ))
344   LAST_E_CMD=ebegin
345   return 0
346 }
347
348 # void _eend(int error, char *efunc, char* errstr)
349 #
350 #    indicate the completion of process, called from eend/ewend
351 #    if error, show errstr via efunc
352 #
353 #    This function is private to functions.sh.  Do not call it from a
354 #    script.
355 #
356 _eend() {
357   local retval="${1:-0}" efunc="${2:-eerror}" msg
358   shift 2
359
360   if [ "${retval}" -eq 0 ]; then
361     [ "${RC_QUIET_STDOUT}" = "yes" ] && return 0
362     msg="${BRACKET}[ ${GOOD}ok${BRACKET} ]${NORMAL}"
363   else
364     if [ "$#" -gt 0 ] ; then
365         "${efunc}" "$@"
366     fi
367     msg="${BRACKET}[ ${BAD}!!${BRACKET} ]${NORMAL}"
368   fi
369
370   if [ "${RC_ENDCOL}" = "yes" ]; then
371     printf "${ENDCOL}  ${msg}\n"
372   else
373     [ "${LAST_E_CMD}" = "ebegin" ] || LAST_E_LEN=0
374     printf "%$(( ${COLS} - ${LAST_E_LEN} - 6 ))s%b\n" '' "${msg}"
375   fi
376
377   return "${retval}"
378 }
379
380 # void eend(int error, char* errstr)
381 #
382 #    indicate the completion of process
383 #    if error, show errstr via eerror
384 #
385 eend() {
386   local retval="${1:-0}"
387   shift
388
389   _eend "${retval}" eerror "$@"
390
391   LAST_E_CMD=eend
392   return "$retval"
393 }
394
395 # void ewend(int error, char* errstr)
396 #
397 #    indicate the completion of process
398 #    if error, show errstr via ewarn
399 #
400 ewend() {
401   local retval="${1:-0}"
402   shift
403
404   _eend "${retval}" ewarn "$@"
405
406   LAST_E_CMD=ewend
407   return "$retval"
408 }
409 #}}}
410
411 # vim: ft=sh tw=80 ts=4 foldmethod=marker