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
 163 # should we use color?
 164 if [ -r /proc/cmdline ] ; then
 165   grep -q ' nocolor' /proc/cmdline && RC_NOCOLOR='yes'
 166 fi
 167 [ -n "$NOCOLORS" ] && RC_NOCOLOR='yes'
 168 RC_NOCOLOR="${RC_NOCOLOR:-no}"
 169
 170 # Can the terminal handle endcols?
 171 RC_ENDCOL="yes"
 172
 173 # Setup COLS and ENDCOL so eend can line up the [ ok ]
 174 # width of [ ok ] == 7
 175 COLS="$(stty size 2>/dev/null | cut -d' ' -f2)"
 176 if [ -z "${COLS}" ] || [ "${COLS}" -le 0 ] ; then
 177   COLS=80
 178 fi
 179
 180 if [ "${RC_ENDCOL}" = "yes" ]; then
 181   ENDCOL="\e[A\e[$(( ${COLS} - 8 ))G"
 182 else
 183   ENDCOL=''
 184 fi
 185
 186 # Setup the colors so our messages all look pretty
 187 if [ "${RC_NOCOLOR}" = "yes" ]; then
 188   unset GOOD WARN BAD NORMAL HILITE BRACKET
 189 else
 190   GOOD='\e[32;01m'
 191   WARN='\e[33;01m'
 192   BAD='\e[31;01m'
 193   NORMAL='\e[0m'
 194   HILITE='\e[36;01m'
 195   BRACKET='\e[34;01m'
 196 fi
 197 #}}}
 198
 199 # void esyslog(char* priority, char* tag, char* message)
 200 #
 201 #    use the system logger to log a message
 202 #
 203 esyslog() {
 204   local pri
 205   local tag
 206
 207   [ "$#" -le 2 ] && return 0
 208   if [ -x /usr/bin/logger ] ; then
 209     pri="$1"
 210     tag="$2"
 211     shift 2
 212
 213     /usr/bin/logger -p "${pri}" -t "${tag}" -- "$@"
 214   fi
 215
 216   return 0
 217 }
 218
 219 # void eindent(int num)
 220 #
 221 #    increase the indent used for e-commands.
 222 #
 223 eindent() {
 224   local i="${1:-0}"
 225   [ "$i" -gt 0 ] || i="${RC_DEFAULT_INDENT}"
 226   esetdent $(( ${#RC_INDENTATION} + $i ))
 227 }
 228
 229 # void eoutdent(int num)
 230 #
 231 #    decrease the indent used for e-commands.
 232 #
 233 eoutdent() {
 234   local i="${1:-0}"
 235   [ "$i" -gt 0 ] || i="${RC_DEFAULT_INDENT}"
 236   esetdent $(( ${#RC_INDENTATION} - $i ))
 237 }
 238
 239 # void esetdent(int num)
 240 #
 241 #    hard set the indent used for e-commands.
 242 #    num defaults to 0
 243 #
 244 esetdent() {
 245   local i="${1:-0}"
 246   [ "$i" -lt 0 ] && i=0
 247   RC_INDENTATION="$(printf "%${i}s" '')"
 248 }
 249
 250 # void einfo(char* message)
 251 #
 252 #    show an informative message (with a newline)
 253 #
 254 einfo() {
 255   einfon "$*\n"
 256   LAST_E_CMD=einfo
 257   return 0
 258 }
 259
 260 # void einfon(char* message)
 261 #
 262 #    show an informative message (without a newline)
 263 #
 264 einfon() {
 265   [ "${RC_QUIET_STDOUT}" = "yes" ] && return 0
 266   [ "${RC_ENDCOL}" != "yes" ] && [ "${LAST_E_CMD}" = "ebegin" ] && echo
 267   printf " ${GOOD}*${NORMAL} ${RC_INDENTATION}$*"
 268   LAST_E_CMD=einfon
 269   return 0
 270 }
 271
 272 # void ewarn(char* message)
 273 #
 274 #    show a warning message + log it
 275 #
 276 ewarn() {
 277   if [ "${RC_QUIET_STDOUT}" = "yes" ]; then
 278       printf " $*\n"
 279   else
 280     [ "${RC_ENDCOL}" != "yes" ] && [ "${LAST_E_CMD}" = "ebegin" ] && echo
 281     printf " ${WARN}*${NORMAL} ${RC_INDENTATION}$*\n"
 282   fi
 283
 284   # Log warnings to system log
 285   esyslog "daemon.warning" "rc-scripts" "$@"
 286
 287   LAST_E_CMD=ewarn
 288   return 0
 289 }
 290
 291 # void eerror(char* message)
 292 #
 293 #    show an error message + log it
 294 #
 295 eerror() {
 296   if [ "${RC_QUIET_STDOUT}" = "yes" ]; then
 297     printf " $*\n" >&2
 298   else
 299     [ "${RC_ENDCOL}" != "yes" ] && [ "${LAST_E_CMD}" = "ebegin" ] && echo
 300     printf " ${BAD}*${NORMAL} ${RC_INDENTATION}$*\n"
 301   fi
 302
 303   # Log errors to system log
 304   esyslog "daemon.err" "rc-scripts" "$@"
 305
 306   LAST_E_CMD=eerror
 307   return 0
 308 }
 309
 310 # void ebegin(char* message)
 311 #
 312 #    show a message indicating the start of a process
 313 #
 314 ebegin() {
 315   local msg="$@" dots spaces
 316   spaces="$(printf '%'"${#RC_DOT_PATTERN}"'s' '')"
 317   [ "${RC_QUIET_STDOUT}" = "yes" ] && return 0
 318
 319   if [ -n "${RC_DOT_PATTERN}" ]; then
 320     dots="$(printf "%$(( $COLS - 3 - ${#RC_INDENTATION} - ${#msg} - 7 ))s" '')"
 321     while [ "${dots#${spaces}}" != "${dots}" ] ; do
 322         dots="${dots#${spaces}}${RC_DOT_PATTERN}"
 323     done
 324     msg="${msg}${dots}"
 325   else
 326     msg="${msg} ..."
 327   fi
 328   einfon "${msg}"
 329   [ "${RC_ENDCOL}" = "yes" ] && echo
 330
 331   LAST_E_LEN=$(( 3 + ${#RC_INDENTATION} + ${#msg} ))
 332   LAST_E_CMD=ebegin
 333   return 0
 334 }
 335
 336 # void _eend(int error, char *efunc, char* errstr)
 337 #
 338 #    indicate the completion of process, called from eend/ewend
 339 #    if error, show errstr via efunc
 340 #
 341 #    This function is private to functions.sh.  Do not call it from a
 342 #    script.
 343 #
 344 _eend() {
 345   local retval="${1:-0}" efunc="${2:-eerror}" msg
 346   shift 2
 347
 348   if [ "${retval}" -eq 0 ]; then
 349     [ "${RC_QUIET_STDOUT}" = "yes" ] && return 0
 350     msg="${BRACKET}[ ${GOOD}ok${BRACKET} ]${NORMAL}"
 351   else
 352     if [ "$#" -gt 0 ] ; then
 353         "${efunc}" "$@"
 354     fi
 355     msg="${BRACKET}[ ${BAD}!!${BRACKET} ]${NORMAL}"
 356   fi
 357
 358   if [ "${RC_ENDCOL}" = "yes" ]; then
 359     printf "${ENDCOL}  ${msg}\n"
 360   else
 361     [ "${LAST_E_CMD}" = "ebegin" ] || LAST_E_LEN=0
 362     printf "%$(( ${COLS} - ${LAST_E_LEN} - 6 ))s%b\n" '' "${msg}"
 363   fi
 364
 365   return "${retval}"
 366 }
 367
 368 # void eend(int error, char* errstr)
 369 #
 370 #    indicate the completion of process
 371 #    if error, show errstr via eerror
 372 #
 373 eend() {
 374   local retval="${1:-0}"
 375   shift
 376
 377   _eend "${retval}" eerror "$@"
 378
 379   LAST_E_CMD=eend
 380   return "$retval"
 381 }
 382
 383 # void ewend(int error, char* errstr)
 384 #
 385 #    indicate the completion of process
 386 #    if error, show errstr via ewarn
 387 #
 388 ewend() {
 389   local retval="${1:-0}"
 390   shift
 391
 392   _eend "${retval}" ewarn "$@"
 393
 394   LAST_E_CMD=ewend
 395   return "$retval"
 396 }
 397 #}}}
 398
 399 # vim: ft=sh tw=80 ts=4 foldmethod=marker