# -*-Shell-script-*-
#
# functions This file contains functions to be used by most or all  # ע ýű /etc/init.d/ µнűãΪ˴
#  shell scripts in the /etc/init.d directory.        # ĻͬʱҲ /etc/rc.d/rc.sysinit  successactionfailure Ⱥ
#
 
TEXTDOMAIN=initscripts    #  TEXTDOMAIN 
 
 
##########################################################################################################################################################
# Make sure umask is sane     # ȷ root û umask ȷ 022 Ҳ rwxr-xr-x
umask 022
 
# Set up a default search path.           # Ĭϵ PATH 
PATH="/sbin:/usr/sbin:/bin:/usr/bin:/usr/X11R6/bin"  # ĬΪ /sbin:/usr/sbin:/bin:/usr/bin:/usr/X11R6/bin
export PATH         # Ϊ
 
# Get a sane screen width    # ȷĻ
[ -z "${COLUMNS:-}" ] && COLUMNS=80     #  COLUMNS ֵΪգΪ 80 У
 
[ -z "${CONSOLETYPE:-}" ] && CONSOLETYPE="`/sbin/consoletype`"    #  CONSOLETYPE Ϊ CONSOLETYPE Ϊ /sbin/consoletype صֵ
                                                                                                             # һ vt  pty serial
##########################################################################################################################################################
if [ -f /etc/sysconfig/i18n -a -z "${NOLOCALE:-}" ] ; then      #  /etc/sysconfig/i18n  NOLOCALE ֵΪգ
      . /etc/sysconfig/i18n       # ִ /etc/sysconfig/i18n ļȡ LANG ֵ
      if [ "$CONSOLETYPE" != "pty" ]; then        # ǰ console Ͳ ptyԶ̵¼ vt  serial 
          case "${LANG:-}" in                                                                                                    #  LANG ֵѡ
              ja_JP*|ko_KR*|zh_CN*|zh_TW*|bn_*|bd_*|pa_*|hi_*|ta_*|gu_*)    #  LANG  ġļ塢ķ塢ĵȣ
                   export LC_MESSAGES=en_US                                                                                                #  LC_MESSAGES Ϊ en_US
                   export LANG                                                                                                                       # ͬʱΪ
                   ;;
              *)
                   export LANG                                                                                                                # ͵ԣֱӵ LANG
               ;    ;
         esac
      else                                                                                                                    # ǰ consle  pty                                                   
       [ -n "$LC_MESSAGES" ] && export LC_MESSAGES        #  LC_MESSAGES Ϊգֱӵ LC_MESSAGES 
       export LANG
  fi
fi
##########################################################################################################################################################
 
#  successfailurepassedwarning 4µɫ
 
# Read in our configuration
if [ -z "${BOOTUP:-}" ]; then      #  BOOTUP Ϊգ
  if [ -f /etc/sysconfig/init ]; then       #  /etc/sysconfig/init ļִ /etc/sysconfig/init ļ
      . /etc/sysconfig/init
  else                 # Ǿֹ
    # This all seem confusing? Look in /etc/sysconfig/init,
    # or in /usr/doc/initscripts-*/sysconfig.txt
    BOOTUP=color           # һ BOOTUP ĬϾ color 
    RES_COL=60             # ڶĻĵڼ "[ xxx ]" Ĭǵ60
    MOVE_TO_COL="echo -en //033[${RES_COL}G"      # MOVE_TO_COL ڴӡ "OK"  "FAILED" , "PASSED" , "WARNING" ֮ǰĲ֣ "[" 
    SETCOLOR_SUCCESS="echo -en //033[1;32m"       # SETCOLOR_SUCCESS ú嶼Ϊɫ
    SETCOLOR_FAILURE="echo -en //033[1;31m"       # SETCOLOR_FAILURE ú潫Ҫ嶼Ϊɫ
    SETCOLOR_WARNING="echo -en //033[1;33m"       # SETCOLOR_WARNING ú潫Ҫ嶼Ϊ
    SETCOLOR_NORMAL="echo -en //033[0;39m"        # SETCOLOR_NORMAL ú嶼ΪɫĬϣ
    LOGLEVEL=1
  fi
  if [ "$CONSOLETYPE" = "serial" ]; then    # ͨڵ¼ģȫȡɫ
      BOOTUP=serial
      MOVE_TO_COL=
      SETCOLOR_SUCCESS=
      SETCOLOR_FAILURE=
      SETCOLOR_WARNING=
      SETCOLOR_NORMAL=
  fi
fi
 
 
##########################################################################################################################################################
if [ "${BOOTUP:-}" != "verbose" ]; then    #  BOOTUP ֵΪ verbose 
   INITLOG_ARGS="-q"                       #  INITLOG_ARGS ֵΪ -q ģʽ
else                                       # 
   INITLOG_ARGS=                           #  INITLOG_ARGS ֵ 
fi
##########################################################################################################################################################
# Check if $pid (could be plural) are running            # 涨һ checkpid ĿǼ /proc ǷָĿ¼ /proc/1/
checkpid() {         # һڣ򷵻0
 local i
 
 for i in $* ; do
  [ -d "/proc/$i" ] && return 0
 done
 return 1                 # ĲȫڶӦĿ¼򷵻1
}
 
##########################################################################################################################################################
# A function to start a program.     # 涨Ҫһdaemon ĳ/etc/init.d/ µĽű start ֶõ
daemon() {
 # Test syntax.
 local gotbase= force=
 local base= user= nice= bg= pid=
 nicelevel=0
 while [ "$1" != "${1##[-+]}" ]; do       # daemon ָѡ --check <value> --check=<value> 
   case $1 in
     '')    echo $"$0: Usage: daemon [nicelevel] {program}"    # Ҳָ nice ֵ
            return 1;;
     --check)
     base=$2
     gotbase="yes"
     shift 2
     ;;
     --check=?*)
         base=${1#--check=}
     gotbase="yes"
     shift
     ;;
     --user)               # ҲָҪʲôûУ--user <usr> , --user=<usr>)
     user=$2
     shift 2
     ;;
     --user=?*)
            user=${1#--user=}
     shift
     ;;
     --force)
         force="force"        # --force ʾǿ
     shift
     ;;
     [-+][0-9]*)
         nice="nice -n $1"      #  daemon ĵһ֣Ϊ nice ֵ
            shift
     ;;
     *)     echo $"$0: Usage: daemon [nicelevel] {program}"
            return 1;;
   esac
 done
 
        # Save basename.      # basename ǴӷĶƳ full path ȡĲ
        [ -z "$gotbase" ] && base=${1##*/}                                        
 
        # See if it's already running. Look *only* at the pid file.    # ÷ǷѾС daemon ֻ鿴 pid ļ
 if [ -f /var/run/${base}.pid ]; then              #  /var/run ´ڸ÷ pid ļ
  local line p
  read line < /var/run/${base}.pid          # Ӹ pid ļÿζȡһУ͸ line ע pid ļжУҲһ
  for p in $line ; do                       #  line ÿ word м
   [ -z "${p//[0-9]/}" -a -d "/proc/$p" ] && pid="$pid $p"      #  p ȫ֣Ҵ /proc/$p/ Ŀ¼Ϊһ pid 뵽 pid 
  done       #  pid ֵжɿոָ
 fi
 
 [ -n "${pid:-}" -a -z "${force:-}" ] && return     #  pid Ϊգ force Ϊգǿ򷵻
 
 # make sure it doesn't core dump anywhere unless requested        # Ը÷ʹõԴһЩ
 ulimit -S -c ${DAEMON_COREFILE_LIMIT:-0} >/dev/null 2>&1          # ulimit ǿɸ shell ĽܹʹõԴ-S  soft control ˼-c ָ core   
                                                                 # dump ļС DEAMON_COREFILE_LIMIT ΪգĬΪ 0
 
 # if they set NICELEVEL in /etc/sysconfig/foo, honor it         #  /etc/sysconfi/foo ļ NICELEVEL   daemon Ǹ nice ֵ
 [ -n "$NICELEVEL" ] && nice="nice -n $NICELEVEL"                # ע⣬ nice ֵ nice -n <value> ĸʽΪ nice ʽϷ
 
 # Echo daemon                                                   #  BOOTUP ֵΪ verbose ӡһ
        [ "${BOOTUP:-}" = "verbose" -a -z "$LSB" ] && echo -n " $base"
 
 # And start it up.                                                                                        # ǿʼ
 if [ -z "$user" ]; then                                                                                  #  user ΪգĬʹ root 
    $nice initlog $INITLOG_ARGS -c "$*"                                                                # ִ nice -n <nice_value> initlog -q -c "$*" 
 else                                                                                                         # ָû
    $nice initlog $INITLOG_ARGS -c "runuser -s /bin/bash - $user -c /"$*/""                # ִ nice -n <nice_value> initlog -q -c "runuser -s /bin/bash - <user> -c "$*"
 fi
 [ "$?" -eq 0 ] && success $"$base startup" || failure $"$base startup"                # ɹʾһɫ [ OK ] ʾ [ FAILURE ]
}
 
 
##########################################################################################################################################################
 
# A function to stop a program.                                # 涨һҪĺ killproc /etc/init.d/ Ľű stop ֶõ
killproc() {
 RC=0                                                                    # RC շصֵʼΪ 0
 # Test syntax.
 if [ "$#" -eq 0 ]; then                                            # killproc ﷨ʽ killproc <service> [<signal>]  killproc sm-client 9
  echo $"Usage: killproc {program} [signal]"              
  return 1
 fi
 
 notset=0                                                             # noset ڼûǷָ kill Ҫʹõź
 # check for second arg to be kill level                  
 if [ -n "$2" ]; then                                                #  $2 Ϊգʾû趨źţ
  killlevel=$2                                                            #  $2 ֵ killlevel 
 else                                                                    # 
  notset=1                                                                # notset ֵΪ1ͬʱ killlevel Ϊ '-9' KILL źţ
  killlevel="-9"
 fi
 
#  ע⣬˵ûûָźŵֹͣĳʱͻ kill -9 ķʽǿɱ TERM źţȻ KILL
 
        # Save basename.
        base=${1##*/}                                                # basename ǵó
 
        # Find pid.
 pid=                                                                    #  pid ֵաע⣬ָ pid ֵűִнҪ
 if [ -f /var/run/${base}.pid ]; then                         #  daemon һҳ pid 
    local line p
    read line < /var/run/${base}.pid
    for p in $line ; do
       [ -z "${p//[0-9]/}" -a -d "/proc/$p" ] && pid="$pid $p"
    done
 fi
 if [ -z "$pid" ]; then                                                #  daemon ͬǣһ pid Ϊղֱ return ǳ pid ٴβ
  pid=`pidof -o $$ -o $PPID -o %PPID -x $1 || /            # -o ںĳ pid -o $$ ǺԵǰ shell  pid-o $PPID Ǻ shell  pid 
   pidof -o $$ -o $PPID -o %PPID -x $base`                   # -o %PPID Ǻ pidof ĸ̣ҪѯĽ $1 (fullpath)  $base 
 fi
 
 # Kill it.                                                            
  if [ -n "${pid:-}" ] ; then                                        #  pid ֵղΪգ
    [ "$BOOTUP" = "verbose" -a -z "$LSB" ] && echo -n "$base "    #  BOOTUP ֵΪ verbose  LSB Ϊգӡһ
    if [ "$notset" -eq "1" ] ; then                                        #  notset Ϊ1ʾûûָźţ
         if checkpid $pid 2>&1; then                                        #  checkpid  $pid Ƿ /proc/ ´ڽĿ¼
              # TERM first, then KILL if not dead                            # ȳ TERM Ϣ KILL ź
              kill -TERM $pid >/dev/null 2>&1                                # ִ kill -TERM $pid 
              usleep 100000                                                          # usleep  sleep һλǰ֮1롣1
              if checkpid $pid && sleep 1 &&                                #  checkpid $pid ǲ鵽 /proc/<pid>/ Ŀ¼ڣʾûɱȴ1
                 checkpid $pid && sleep 3 &&                                # 1 checkpid 黹Уٵȴ3룻
                 checkpid $pid ; then                                            # ûɱ KILL ź
                        kill -KILL $pid >/dev/null 2>&1                            # ִ kill -KILL ɱ
                        usleep 100000                                                    # ȴ1
              fi
    fi
    checkpid $pid                                                             # ٴμ pid Ŀ¼       
    RC=$?                                                                         # ѽظ RC  killproc ״̬
    [ "$RC" -eq 0 ] && failure $"$base shutdown" || success $"$base shutdown"    #  RC ֵΪ0ʾkill -9 ûɱ˽̣ failure  success 
    RC=$((! $RC))
  
    # use specified level only                                            # 涼ûָźŵģûָźŵġ restart reload
    else    #  else  if [ "$notset" -eq "1" ]  
       if checkpid $pid; then                                             # 鵽̴ڣ
            kill $killlevel $pid >/dev/null 2>&1                            # ִkillʹָź $killlevel 
            RC=$?                                                                     # ״ֵ̬ظ RC
            [ "$RC" -eq 0 ] && success $"$base $killlevel" || failure $"$base $killlevel"    #  RC Ϊ0ʾɹ success failure 
       fi
  fi
 else      #  else  if [ -n "${pid:-}" ]  ģҲ˵û pid ļpidof Ҳûҵ pid 
     failure $"$base shutdown"                #  failure ʾֹͣʧ
     RC=1                                             # ͬʱ RC ֵΪ1
 fi
 
 # Remove pid file if any.                    # ݾҪɾ pid ļ
 if [ "$notset" = "1" ]; then                    #  notset Ϊ1 Ҳûûָźŵ
            rm -f /var/run/$base.pid            # Զɾ /var/run µ pid ļ
 fi
 return $RC                                        #  RC Ϊ exit status 
}
 
#  ɾ pid ļֻ notset Ϊ1 Ϊ -HUP źţضãɱ̣Բɾ pid ļ
 
#  
 
[root@mail init.d]# ps -ef |grep xinetd
root      2635     1  0 12:25 ?        00:00:00 xinetd -stayalive -pidfile /var/run/xinetd.pid
[root@mail init.d]# ./xinetd reload
Reloading configuration:                                   [  OK  ]
[root@mail init.d]# ps -ef |grep xinetd
root      2635     1  0 12:25 ?        00:00:00 xinetd -stayalive -pidfile /var/run/xinetd.pid
root      3927  3412  0 16:43 pts/0    00:00:00 grep xinetd
[root@mail init.d]#
 
Կ pid  reload ûб
 
##########################################################################################################################################################
# A function to find the pid of a program. Looks *only* at the pidfile        #  pidfileofproc  checkpid ƣִ pidof ֻѯ pid ļ
pidfileofproc() {
 local base=${1##*/}
 
 # Test syntax.
 if [ "$#" = 0 ] ; then
  echo $"Usage: pidfileofproc {program}"
  return 1
 fi
 
 # First try "/var/run/*.pid" files
 if [ -f /var/run/$base.pid ] ; then
         local line p pid=
    read line < /var/run/$base.pid
    for p in $line ; do
         [ -z "${p//[0-9]/}" -a -d /proc/$p ] && pid="$pid $p"
    done
         if [ -n "$pid" ]; then
                 echo $pid
                 return 0
         fi
 fi
}
##########################################################################################################################################################
# A function to find the pid of a program.                        #  pidofproc  pidfileofproc ƣһ pidof 
pidofproc() {
 base=${1##*/}
 
 # Test syntax.
 if [ "$#" = 0 ]; then
  echo $"Usage: pidofproc {program}"
  return 1
 fi
 
 # First try "/var/run/*.pid" files
 if [ -f /var/run/$base.pid ]; then
         local line p pid=
  read line < /var/run/$base.pid
  for p in $line ; do
         [ -z "${p//[0-9]/}" -a -d /proc/$p ] && pid="$pid $p"
  done
         if [ -n "$pid" ]; then
                 echo $pid
                 return 0
         fi
 fi
 pidof -o $$ -o $PPID -o %PPID -x $1 || /
  pidof -o $$ -o $PPID -o %PPID -x $base
}
##########################################################################################################################################################
status() {                                                                  # ע  status жϷ״̬ܹ4
 local base=${1##*/}
 local pid
 
 # Test syntax.
 if [ "$#" = 0 ] ; then
  echo $"Usage: status {program}"
  return 1
 fi
 
 # First try "pidof"                                                        # ͬǲ pid ȡֱʹ pidof 
 pid=`pidof -o $$ -o $PPID -o %PPID -x $1 || /                
      pidof -o $$ -o $PPID -o %PPID -x ${base}`
 if [ -n "$pid" ]; then                                                    #  pid ֵΪգʾҵ̣
         echo $"${base} (pid $pid) is running..."                 # ӡ "xxx (pid nnn) is running " ,
         return 0                                                             #  0
 fi
 
 # Next try "/var/run/*.pid" files                                    #  pidof ûҵԴ pid ļ
 if [ -f /var/run/${base}.pid ] ; then
         read pid < /var/run/${base}.pid
         if [ -n "$pid" ]; then                                                #  pidof Ҳ pid ļҵ pid 
                 echo $"${base} dead but pid file exists"                # ӡ "xxx dead but pid file exists"
                 return 1                                                             #  1
         fi
 fi
 # See if /var/lock/subsys/${base} exists                            #  pidof  pid ļûҵ pid 
 if [ -f /var/lock/subsys/${base} ]; then                              #  /var/lock/subsys ´ڶӦļ
  echo $"${base} dead but subsys locked"                                # ӡ xxxx dead but subsys locked
  return 2                                                                            #  2
 fi
 echo $"${base} is stopped"                                                #  pidof pidf ļûҵpid ûбӡ xxx is stopped
 return 3                                                                           # 3
}
##########################################################################################################################################################
 
# ע  echo_xxx Ļϴӡ [ ok ] [ PASSED ][ FAILURE ][ WARNING ] Ĳ
 
echo_success() {                                                                    #  echo_success 
  [ "$BOOTUP" = "color" ] && $MOVE_TO_COL                            # Ǵӡ [ ֮ǰĿո
  echo -n "[  "                                                                         # Ȼӡ "[" 
  [ "$BOOTUP" = "color" ] && $SETCOLOR_SUCCESS                    # Ϊɫ
  echo -n $"OK"                                                                       # ӡ OK
  [ "$BOOTUP" = "color" ] && $SETCOLOR_NORMAL                     # Ϊɫ
  echo -n "  ]"                                                                         # ӡ "]"    
  echo -ne "/r"                                                                        # С
  return 0                                                                               #  0һɷ 1
 
 
echo_failure() {
  [ "$BOOTUP" = "color" ] && $MOVE_TO_COL
  echo -n "["
  [ "$BOOTUP" = "color" ] && $SETCOLOR_FAILURE
  echo -n $"FAILED"
  [ "$BOOTUP" = "color" ] && $SETCOLOR_NORMAL
  echo -n "]"
  echo -ne "/r"
  return 1
}
 
echo_passed() {
  [ "$BOOTUP" = "color" ] && $MOVE_TO_COL
  echo -n "["
  [ "$BOOTUP" = "color" ] && $SETCOLOR_WARNING
  echo -n $"PASSED"
  [ "$BOOTUP" = "color" ] && $SETCOLOR_NORMAL
  echo -n "]"
  echo -ne "/r"
  return 1
}
 
echo_warning() {
  [ "$BOOTUP" = "color" ] && $MOVE_TO_COL
  echo -n "["
  [ "$BOOTUP" = "color" ] && $SETCOLOR_WARNING
  echo -n $"WARNING"
  [ "$BOOTUP" = "color" ] && $SETCOLOR_NORMAL
  echo -n "]"
  echo -ne "/r"
  return 1
}
##########################################################################################################################################################
# Inform the graphical boot of our current state
update_boot_stage() {
  if [ "$GRAPHICAL" = "yes" -a -x /usr/bin/rhgb-client ]; then
    /usr/bin/rhgb-client --update="$1"
  fi
  return 0
}
##########################################################################################################################################################
# Log that something succeeded                                                
success() {                                                                                                # success ˴ӡ [ xxx ] ֮⣬ʹ initlog ¼Ϣ
  if [ -z "${IN_INITLOG:-}" ]; then
     initlog $INITLOG_ARGS -n $0 -s "$1" -e 1                                                   # -n  --name ˼-s  --string -e  --event 1 ʾȫɹ
  else
     # silly hack to avoid EPIPE killing rc.sysinit
     trap "" SIGPIPE
     echo "$INITLOG_ARGS -n $0 -s /"$1/" -e 1" >&21
     trap - SIGPIPE
  fi
  [ "$BOOTUP" != "verbose" -a -z "$LSB" ] && echo_success
  return 0
}
 
# Log that something failed
failure() {
  rc=$?
  if [ -z "${IN_INITLOG:-}" ]; then
     initlog $INITLOG_ARGS -n $0 -s "$1" -e 2                                                    # failure Ļ --event  2 ʧ
  else
     trap "" SIGPIPE
     echo "$INITLOG_ARGS -n $0 -s /"$1/" -e 2" >&21
     trap - SIGPIPE
  fi
  [ "$BOOTUP" != "verbose" -a -z "$LSB" ] && echo_failure
  [ -x /usr/bin/rhgb-client ] && /usr/bin/rhgb-client --details=yes
  return $rc
}
 
# Log that something passed, but may have had errors. Useful for fsck
passed() {
  rc=$?
  if [ -z "${IN_INITLOG:-}" ]; then
     initlog $INITLOG_ARGS -n $0 -s "$1" -e 1                                                 # passed Ļ --event 1
  else
     trap "" SIGPIPE
     echo "$INITLOG_ARGS -n $0 -s /"$1/" -e 1" >&21
     trap - SIGPIPE
  fi
  [ "$BOOTUP" != "verbose" -a -z "$LSB" ] && echo_passed
  return $rc
} 
 
# Log a warning
warning() {
  rc=$?
  if [ -z "${IN_INITLOG:-}" ]; then
     initlog $INITLOG_ARGS -n $0 -s "$1" -e 1                                                # warning Ļ --event Ҳ 1
  else
     trap "" SIGPIPE
     echo "$INITLOG_ARGS -n $0 -s /"$1/" -e 1" >&21
     trap - SIGPIPE
  fi
  [ "$BOOTUP" != "verbose" -a -z "$LSB" ] && echo_warning
  return $rc
} 
##########################################################################################################################################################
# Run some action. Log its output.                                                        # action һҪĺǴӡĳʾϢִи
tion() {
  STRING=$1
  echo -n "$STRING "
  if [ "${RHGB_STARTED}" != "" -a -w /etc/rhgb/temp/rhgb-console ]; then
      echo -n "$STRING " > /etc/rhgb/temp/rhgb-console
  fi
  shift
  initlog $INITLOG_ARGS -c "$*" && success $"$STRING" || failure $"$STRING"
  rc=$?
  echo
  if [ "${RHGB_STARTED}" != "" -a -w /etc/rhgb/temp/rhgb-console ]; then
      if [ "$rc" = "0" ]; then
       echo_success > /etc/rhgb/temp/rhgb-console
      else
        echo_failed > /etc/rhgb/temp/rhgb-console
 [ -x /usr/bin/rhgb-client ] && /usr/bin/rhgb-client --details=yes
      fi
      echo
  fi
  return $rc
}
##########################################################################################################################################################
# returns OK if $1 contains $2                        # strstr ж $1 ַǷ $2 ַ򷵻0򷵻1
() {
  [ "${1#*$2*}" = "$1" ] && return 1
  return 0
}
##########################################################################################################################################################
# Confirm whether we really want to run this service                                       # confirm ڽʽ
nfirm() {
  [ -x /usr/bin/rhgb-client ] && /usr/bin/rhgb-client --details=yes
  while : ; do 
    echo -n $"Start service $1 (Y)es/(N)o/(C)ontinue? [Y] "                                   # ӡһʾϢ
    read answer
    if strstr $"yY" "$answer" || [ "$answer" = "" ] ; then                                          #  answer  y  Y 
        return 0                                                                                                                #  0δ
    elif strstr $"cC" "$answer" ; then                                                                    #  answer  c  C 
        rm -f /var/run/confirm                                                                                          # ɾ /var/run/confirm ļ                           
        [ -x /usr/bin/rhgb-client ] && /usr/bin/rhgb-client --details=no
        return 2                                                                                                                # 2
   elif strstr $"nN" "$answer" ; then                                                                      #  answer  n  N
  return 1                                                                                                                       # ֱӷ1
     fi
  done
}