Chinaunix首页 | 论坛 | 博客
  • 博客访问: 505270
  • 博文数量: 157
  • 博客积分: 3010
  • 博客等级: 中校
  • 技术积分: 1608
  • 用 户 组: 普通用户
  • 注册时间: 2008-08-16 09:30
文章存档

2010年(155)

2008年(2)

我的朋友

分类: LINUX

2010-04-29 10:58:56

Linux系统启动脚本分析之rc
#! /bin/bash
#
# rc            This file is responsible for starting/stopping                            # 该脚本主要是用于在切换运行级别时启动/停止服务
#               services when the runlevel changes.
#
# Original Author:      
#               Miquel van Smoorenburg, <
>
#
 
# check a file to be a correct runlevel script                # 下面的 check_runlevel 不是检查当前运行级别的意思,而是检查符号连接对应的 target 是否真正存在
                                                                               #  避免出现无效链接的情况
check_runlevel ()
{
 # Check if the file exists at all.                                # -x 可以测试该 symbol link ($1)的 target 是否可执行,如果不是则返回1
 [ -x "$1" ] || return 1
 
 # Reject backup files and files generated by rpm.      # 如果可以执行,还要检查该脚本是否是备份或者升级 rpm 后留下来的。
 case "$1" in                                                             # 根据 $1 的值进行选择
  *.rpmsave|*.rpmorig|*.rpmnew|*~|*.orig)                    # 如果是以 .rpmsave ,。rpmorig、.rpmnew ,~ ,.orig 结尾的,则
   return 1                                                                            # 返回 1
   ;;
 esac
 return 0                                                                 # 如果 target 存在且可执行,又不是备份文件,则返回 0
}
 
# Now find out what the current and what the previous runlevel are.            # 找出当前和前一个运行级别
argv1="$1"                                                                                                    # 把目标新运行级别 $1 赋予给 argv1 变量
set `/sbin/runlevel`                                                                                       # 运行 runlevel 命令,把值送给 set 命令,set 默认会把 N 赋予 $1 ,3 赋予 $2
runlevel=$2                                                                                                    # 把 $2 送给 runlevel 变量
previous=$1                                                                                                   # 把 $1 送给 previous 变量
export runlevel previous                                                                                 # 导出这两个变量
 
# 补充 :注意不要混淆这里的 两个 $1 ,前者是保存新的运行级别,后者是由 set $(runlevel)设置的 $1
 
. /etc/init.d/functions                                                                               # 重要部分 :执行 /etc/init.d/functions
 
##########################################################################################################################################################
# 注释 :下面根据是否进入交互来打印不同的标题栏,后面还会用到 /var/run/confirm 文件的。
 
# See if we want to be in user confirmation mode                                            # 确认是否处于 confirm 模式,也就是要求用户确认是否启动服务
if [ "$previous" = "N" ]; then                                                                             # 如果前一个运行级别是 N ,表示没有改变过运行级别
 if [ -f /var/run/confirm ]; then                                                                            # 如果存在 /var/run/confirm 文件(由 rc.sysinit 创建,前提是 $cmdline 有 confirm 
                                                                                                                          # 或者用户按下了 i 键
  echo $"Entering interactive startup"                                                                         # 则打印 "Enterinig interactive setup" 提示信息
 else                                                                                                                    # 如果不存在 /var/run/confirm 文件,则
  echo $"Entering non-interactive startup"                                                                    # 打印 "Entering non-interactive startup" 表示用户在下来的过程中无法干涉
 fi
fi
 
# Get first argument. Set new runlevel to this argument.                                            # 将新运行级别变量赋予变量 runlevel 。
 
[ -n "$argv1" ] && runlevel="$argv1"                                                                            # 补充 :这里实际上可以在上面直接把 $1 赋予 runlevel ,因为后面并不
                                                                               # 需要知道当前的运行级别
  
# 补充 :一旦机器重启,previous level 总是为 N ,除非你执行了类似 telinit 1 这样的命令,previous level 才会是3或者5
   
# Is there an rc directory for this new runlevel?                                                         # 检查指定的新运行级别是否有对应的 rc 目录?
[ -d /etc/rc$runlevel.d ] || exit 0                                                                                # 如果存在这个目录就继续,否则返回 0
 
 
###########################################################################################################################################################
 
 
# 注释 :下面开始执行新 runlevel 的 rc 目录中那些以 K 开头的脚本 
 
# First, run the KILL scripts.
for i in /etc/rc$runlevel.d/K* ; do                                                                                    # 对于在 /etc/rc.d/ 目录下的每个以 K 开头的文件
    check_runlevel "$i" || continue                                                                                        # 首先用 check_runlevel 检查符号连接的有效性
                                                                                     # 如果是无效地,则跳过它继续处理下一个符号链接(服务)
     # Check if the subsystem is already up.                                                                            # 下面检查某项服务 $(i) 是否是已经激活的
     subsys=${i#/etc/rc$runlevel.d/K??}                                                                                        # 从符号连接名中取出真正的服务名,也就是K<0-9><0-9> 后面的部分
     [ -f /var/lock/subsys/$subsys -o -f /var/lock/subsys/$subsys.init ] \                                         # 如果在 /var/lock/subsys 中有同样名称的文件或者 .init 文件,
          || continue                                                                                                                    # 则执行后面的脚本,如果没有则表示服务停止,无须执行下面的代码
 
# 补充 :从上面 subsys 变量的赋值中可以看出系统最多只能有 99 个服务,如果是100的话,则 subsys 的值将不正确(会留有一个数字)
 
# 例如 K100nfs ,经过上面的赋值后,subsys 会变成 0nfs ,而不是 nfs ,这样可能就无法杀死当前运行的 nfsd 进程了
 
     # Bring the subsystem down.                                       #  把服务停止
    if egrep -q "(killproc |action )" $i ; then                        # 如果脚本中含有 killprog 或者 action 
      $i stop                                                                        # 直接用 stop 的方式停止它们
    else                                                                            # 如果找不到这两个字符串,则
      action $"Stopping $subsys: " $i stop                                # 用 action 函数,打印 "Stopping  :" ,然后执行  stop 
     fi
done                                                                               # 这样先把每个以 K 开头的脚本都执行完
 
# 补充 :上面搜索 killproc 或者 action 字符串的目的可能是因为 :如果某个脚本不使用 /etc/init.d/functions ,则在停止服务时可能不会
 
# 显示相关信息,所以先用 action 打印该字符串(stopping xxx),然后再执行 stop (可能在 脚本中的 stop 部分不一定给出
 
# 相关的提示信息;如果 脚本是含有 killproc 或者 action ,则 killproc 自动会调用 success()或者 failure()函数输出提示信息
 
# Now run the START scripts.                                            # 在上面的 Kill 脚本都执行完后,就执行以 S 开头的脚本了。
for i in /etc/rc$runlevel.d/S* ; do                                    # 首先对于 /etc/rc.d/ 目录下的 S 开头的每个文件,都执行下面的代码
 check_runlevel "$i" || continue                                            # check_runlevel 确保存在 target ,否则跳过该服务
     
 # Check if the subsystem is already up.                                # 检查该服务是否已经启动,如果启动就跳过下面代码处理下一个服务
 subsys=${i#/etc/rc$runlevel.d/S??}
 [ -f /var/lock/subsys/$subsys -o -f /var/lock/subsys/$subsys.init ] \
  && continue
     
 # If we're in confirmation mode, get user confirmation          # 启动服务可以是 confirm 模式,也就是按y启动、按n不启动,按c恢复到非交互模式  
 if [ -f /var/run/confirm ]; then                                            # 首先查询是否有 /var/run/confirm 文件存在。
  confirm $subsys                                                                        # 如果存在,就使用 /etc/init.d/functions 的 confirm 函数来处理该服务
  test $? = 1 && continue                                                             # 按y返回0,按n返回1,按c返回2;如果是1的话表示不启动该服务,所以跳过后面代码
 fi
                                                            # 如果是y或者c则启动。但 c 会取消 continue 模式
 
 
 
 update_boot_stage "$subsys"                                                #  调用 update_boot_stage ,执行 rhgb-clinet --update "$subsys"
 # Bring the subsystem up.                                                    # 现在可以激活该服务了。注意,上面 confirm $subsys 只是确认是否启动而已,并为真正启动
 if [ "$subsys" = "halt" -o "$subsys" = "reboot" ]; then                 # 如果该服务 $sbusys 是 halt 或者 reboot 服务,则
  export LC_ALL=C                                                                      #  把 LC_ALL 设置为 C
  exec $i start                                                                             # 执行 exec $i start ,也就是用 halt start 或者 reboot start 代替当前进程,注意 exec 的使用
 fi
 if egrep -q "(daemon |action |success |failure )" $i 2>/dev/null \    # 如果不是上面两个服务之一,且该服务脚本中有 daemon、action、success、failure 等字符串,则
   || [ "$subsys" = "single" -o "$subsys" = "local" ]; then                      # 或者服务为 single 或者 local 服务,则
  $i start                                                                                        # 直接执行 start ,这次不用 exec 方式了
 else                                                                                           # 如果都不是上面的 halt、reboot、single、local 服务,则
  action $"Starting $subsys: " $i start                                                 # 用 action 打印一个 "starting xxx" 的信息,然后执行 $i start 启动该服务
 fi
done                                                                                    # 就用这样的方式对每个 S 开头的脚本都处理一次
 
###########################################################################################################################################################
rm -f /var/run/confirm                                                        # 最后删除 /var/run/confirm 文件,实际上如果上面在启动某个某个服务按下c,则该文件就被删除了
###########################################################################################################################################################
if [ -x /usr/bin/rhgb-client ] && /usr/bin/rhgb-client --ping ; then        
  /usr/bin/rhgb-client --quit                                                                # 执行 rhgb-client --quit ,--quit 就是告诉 rhgb 服务器(/usr/sbin/rhgb)退出
fi
 
Linux启动脚本分析之functions
 # -*-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 ,例如 success、action、failure 等函数
#
 
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
##########################################################################################################################################################
 
# 下面是设置 success、failure、passed、warning 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
"                           # MOVE_TO_COL 是用于打印 "OK" 或者 "FAILED" ,或者 "PASSED" ,或者 "WARNING" 之前的部分,不含 "["
    SETCOLOR_SUCCESS="echo -en
"                             # SETCOLOR_SUCCESS 设置后面的字体都为绿色
    SETCOLOR_FAILURE="echo -en
"                              # SETCOLOR_FAILURE 设置后面将要输出的字体都为红色
    SETCOLOR_WARNING="echo -en
"                            # SETCOLOR_WARNING 设置后面将要输出的字体都为黄色
    SETCOLOR_NORMAL="echo -en
"                              # 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  ,--check=
   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 , --user=)
     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 变量则用它代替  daem
on 后面的那个 nice 值
 [ -n "$NICELEVEL" ] && nice="nice -n $NICELEVEL"                        # 注意,这里的 nice 赋值是用 nice -n 的格式,因为 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 initlog -q -c "$*" 
 else                                                                                                         # 如果指定了用户,则
    $nice initlog $INITLOG_ARGS -c "runuser -s /bin/bash - $user -c \"$*\""                # 执行 nice -n initlog -q -c "runuser -s /bin/bash - -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 [] ,例如 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// 目录存在,则表示还没有杀死,继续等待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
}

阅读(2403) | 评论(0) | 转发(0) |
给主人留下些什么吧!~~