OpenPKG Specs: openpkg/rc.func@a2c6460cfb16 (annotated)

openpkg/rc.func@a2c6460cfb16 (annotated)

openpkg/rc.func

Mon, 28 Jan 2013 17:37:18 +0100

author: Michael Schloh von Bennewitz <michael@schloh.com>
date: Mon, 28 Jan 2013 17:37:18 +0100
changeset 758: a2c6460cfb16
parent 427: 71503088f51b
permissions: -rw-r--r--

Correct socket error reporting improvement with IPv6 portable code,
after helpful recommendation by Saúl Ibarra Corretgé on OSips devlist.

 ##
 ##  @l_prefix@/etc/rc.func -- Run-Command Helper Functions
 ##  Copyright (c) 2000-2012 OpenPKG GmbH <http://openpkg.com/>
 ##
 ##  This software is property of the OpenPKG GmbH, DE MUC HRB 160208.
 ##  All rights reserved. Licenses which grant limited permission to use,
 ##  copy, modify and distribute this software are available from the
 ##  OpenPKG GmbH.
 ##
 ##  THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED
 ##  WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
 ##  MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
 ##  IN NO EVENT SHALL THE AUTHORS AND COPYRIGHT HOLDERS AND THEIR
 ##  CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 ##  SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 ##  LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
 ##  USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
 ##  ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
 ##  OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
 ##  OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 ##  SUCH DAMAGE.
 ##
 ##
 ##  NOTICE: This script is a collection of reusable shell functions
 ##  running under GNU Bash during the execution of OpenPKG run-command
 ##  sections.
 ##
 #
 #   rcMsg (display message)
 #
 #   Usage:       rcMsg [-e] [-w] <message>
 #   Example:     rcMsg -e "invalid command line"
 #   Description: display a regular/warning/error message.
 #
 rcMsg () {
     local prefix="rc:"
     while [ $# -gt 0 ]; do
         case $1 in
             -e ) prefix="${prefix}ERROR:";   shift ;;
             -w ) prefix="${prefix}WARNING:"; shift ;;
             *  ) break ;;
         esac
     done
     echo "${prefix} $*"
     return 0
 }
 #
 #   rcPath (manipulate colon-separated PATH-style variable)
 #
 #   Usage:       rcPath [-a] [-r] [-p] [-e] <var> <dir> [<dir> ...]
 #   Example:     rcPath -a -e PATH /bin /sbin /usr/bin /usr/sbin /usr/ccs/bin
 #   Description: removes (-r) or adds (-a) by appending or prepending
 #                (-p) one or more directories <dir> (optionally have
 #                to be existing if -e is given) to a colon-separated
 #                PATH-style variable <var>. In case a directory already
 #                exists, it is first removed.
 #
 rcPath () {
     local mode=""
     local prepend=0
     local exists=0
     while [ $# -gt 0 ]; do
         case $1 in
             -a ) mode="add";    shift ;;
             -r ) mode="remove"; shift ;;
             -p ) prepend=1;     shift ;;
             -e ) exists=1;      shift ;;
             *  ) break                ;;
         esac
     done
     local var="$1"
     shift
     if [ ".${mode}" = .add ]; then
         local edit_del=""
         local edit_add=""
         local dir
         for dir in "$@"; do
             if [ ".${exists}" = .1 ] && [ ! -d "${dir}" ]; then
                 continue
             fi
             edit_del="${edit_del} -e 's;^${dir}\$;;' -e 's;^${dir}:;;'"
             edit_del="${edit_del} -e 's;:${dir}:;:;' -e 's;:${dir}\$;;'"
             if [ ".${prepend}" = .0 ]; then
                 edit_add="${edit_add} -e 's;\$;:${dir};'"
             else
                 edit_add="-e 's;^;${dir}:;' ${edit_add}"
             fi
         done
         if [ ".${edit_del}${edit_add}" != . ]; then
             eval "${var}=\`echo \"\$${var}\" | sed ${edit_del} ${edit_add}\`"
         fi
         return 0
     elif [ ".${mode}" = .remove ]; then
         local edit=""
         local dir
         for dir in "$@"; do
             edit="${edit} -e 's;^${dir}\$;;' -e 's;^${dir}:;;'"
             edit="${edit} -e 's;:${dir}:;:;' -e 's;:${dir}\$;;'"
         done
         eval "${var}=\`echo \"\$${var}\" | sed ${edit}\`"
         return 0
     else
         rcMsg -e "rcPath: neither add (-a) nor remove (-r) operation specified"
         return 1
     fi
 }
 #
 #   rcTmp (temporary file handling)
 #
 #   Usage:       rcTmp [-i] [-f [-n <name>]] [-k]
 #   Example:     rcTmp -i; tmpfile=`rcTmp -f -n tmp`; ...; rcTmp -k
 #   Description: ???
 #
 rcTmp () {
     local mode=""
     local name=""
     while [ $# -gt 0 ]; do
         case $1 in
             -i ) mode="init"; shift        ;;
             -f ) mode="file"; shift        ;;
             -k ) mode="kill"; shift        ;;
             -n ) name="$2";   shift; shift ;;
             *  ) break                     ;;
         esac
     done
     if [ ".${mode}" = .init ]; then
         if [ ".${RC_TMPDIR}" = . ]; then
             local i=0
             while [ ${i} -lt 10 ]; do
                RC_TMPDIR="@l_prefix@/RPM/TMP/rc-`date '+%Y%m%d%H%M%S'`-$$"
                (umask 022; mkdir ${RC_TMPDIR} >/dev/null 2>&1) && break
                i=$((${i} + 1))
                sleep 1
             done
             if [ ${i} -eq 10 ]; then
                 rcMsg -e "rcTmp: unable to establish secure temporary directory" 1>&2
                 return 1
             fi
             declare -r RC_TMPDIR
         fi
         return 0
     elif [ ".${mode}" = .file ]; then
         echo "${RC_TMPDIR}/${name:-tmp}"
         return 0
     elif [ ".${mode}" = .kill ]; then
         if [ ".${RC_TMPDIR}" = . ]; then
             rcMsg -e "rcTmp: no secure temporary directory known"
             return 1
         else
             rm -rf ${RC_TMPDIR}
             return 0
         fi
     else
         rcMsg -e "rcTmp: neither init (-i), file (-f) nor kill (-k) operation specified"
         return 1
     fi
 }
 #
 #   rcService (check for service status enable/active/usable)
 #
 #   Usage:       rcService <pkg> <service> <val>
 #   Example:     if rcService openssh enable yes; then ...
 #   Description: check <service> of package <pkg> against value <val>.
 #                <service> has to be one of "enable", "active" or "usable".
 #                <val> has to be either "no", "yes", or "unknown".
 #
 rcService () {
     local pkg="`echo ${1} | sed -e 's;-;_;g'`"
     local var="${pkg}_${2}"
     local chk="${3}"
     eval "local val=\$${var}"
     if [ ".${val}" = . ]; then
         eval `@l_prefix@/bin/openpkg rc 2>/dev/null --silent ${1} status || true`
         eval "local val=\$${var}"
     fi
     if [ ".${val}" = ".${chk}" ]; then
         return 0
     else
         return 1
     fi
 }
 #
 #   rcVarIsYes (check variable for positive value)
 #
 #   Usage:       rcVarIsYes <var>
 #   Example:     if rcVarIsYes foo; then ...
 #   Description: check whether a variable <var> contains a positive
 #                value, i.e., the values "yes", "true", "on" or "1" in
 #                arbitrary lower or upper case.
 #
 rcVarIsYes () {
     local var="${1}"
     eval "local val=\"\$${var}\""
     case "${val}" in
         [Yy][Ee][Ss] | [Tt][Rr][Uu][Ee] | [Oo][Nn] | 1 )
             return 0
             ;;
         * )
             return 1
             ;;
     esac
 }

OpenPKG Specs / annotate

openpkg/rc.func@a2c6460cfb16 (annotated)

openpkg/rc.func