Linux学习之/etc/init.d/functions详解

转自:http://blog.chinaunix.net/xmlrpc.php?r=blog/article&uid=28773997&id=3996557

/etc/init.d/functions详解

     functions这个脚本是给/etc/init.d里边的文件使用的,提供了一些基础的功能,看看里边究竟有些什么。首先会设置umask,path,还有语言环境,然后会设置success,failure,warning,normal几种情况下的字体颜色。下面再看看提供的重要方法:

 1 checkpid:检查是否已存在pid,如果有一个存在,返回0(通过查看/proc目录)
 2 daemon:启动某个服务。/etc/init.d目录部分脚本的start使用到这个
 3 killproc:杀死某个进程。/etc/init.d目录部分脚本的stop使用到这个
 4 pidfileofproc:寻找某个进程的pid
 5 pidofproc:类似上面的,只是还查找了pidof命令
 6 status:返回一个服务的状态
 7 echo_success,echo_failure,echo_passed,echo_warning分别输出各类信息
 8 success,failure,passed,warning分别记录日志并调用相应的方法
 9 action:打印某个信息并执行给定的命令,它会根据命令执行的结果来调用 success,failure方法
10 strstr:判断$1是否含有$2
11 confirm:显示 "Start service $1 (Y)es/(N)o/(C)ontinue? [Y]"的提示信息,并返回选择结果

详细分析:

 1 # -*-Shell-script-*-
 2 #
 3 # functions This file contains functions to be used by most or all   # 注释 :该脚本几乎被 /etc/init.d/ 下的所有脚本所调用,因为它包含了大量的
 4 #  shell scripts in the /etc/init.d directory.                       # 的基础函数。同时也被 /etc/rc.d/rc.sysinit ,例如 success、action、failure 等函数
 5 #
 6 
 7 TEXTDOMAIN=initscripts                # 设置 TEXTDOMAIN 变量
 8 #某些系统使用LC_MESSAGES shell变量所指定的消息类型. 其他一些系统根据
 9 shell变量TEXTDOMAIN的值来创建消息类型的名称, 可能还会加上后缀'.mo'. 如果
10 你使用TEXTDOMAIN变量, 你可能需要设置变量TEXTDOMAINDIR指向消息类型文件所
11 在的位置. 还有某些系统以这种形式两个变量都使用: TEXTDOMAINDIR/LC_MESSAGES
12 /Lc_Messages/TEXTDOMAIN.mo.
13 ########################################################################################################################
14 # Make sure umask is sane                                   # 确保 root 用户的 umask 是正确的 022 (也就是 rwxr-xr-x)
15 umask 022
16 
17 # Set up a default search path.                             # 设置默认的 PATH 变量
18 PATH="/sbin:/usr/sbin:/bin:/usr/bin:/usr/X11R6/bin"         # 默认为 /sbin:/usr/sbin:/bin:/usr/bin:/usr/X11R6/bin
19 export PATH                                                 # 导出为环境变量
20 
21 # Get a sane screen width                                   # 设置正确的屏幕宽度
22 [ -z "${COLUMNS:-}" ] && COLUMNS=80                         # 如果 COLUMNS 变量的值为空,则设置为 80 (列)
23 
24 [ -z "${CONSOLETYPE:-}" ] && CONSOLETYPE="`/sbin/consoletype`"            # 如果 CONSOLETYPE 为空则设置 CONSOLETYPE 为 /sbin/consoletype 命令返回的值
25                                                             # 一般是 vt 或者 pty 、serial
26 #######################################################################################################
27 if [ -f /etc/sysconfig/i18n -a -z "${NOLOCALE:-}" ] ; then  # 如果存在 /etc/sysconfig/i18n 且 NOLOCALE 变量的值为空,则
28       . /etc/sysconfig/i18n                                 # 执行 /etc/sysconfig/i18n 文件,取得 LANG 变量的值
29       if [ "$CONSOLETYPE" != "pty" ]; then                  # 如果当前 console 类型不是 pty(远程登录),而是 vt 或者 serial ,则
30           case "${LANG:-}" in                               # 根据 LANG 的值作出选择
31               ja_JP*|ko_KR*|zh_CN*|zh_TW*|bn_*|bd_*|pa_*|hi_*|ta_*|gu_*)         # 如果 LANG 是 日文、中文简体、中文繁体、韩文等,则
32                    export LC_MESSAGES=en_US                                      # 把 LC_MESSAGES 设置为 en_US
33                    export LANG                              # 同时导出为环境变量
34                    ;;
35               *)
36                    export LANG                              # 如果是其他类型的语言,则直接导出 LANG
37                ;    ;
38          esac
39       else                                                  # 如果当前 consle 是 pty                                                    
40        [ -n "$LC_MESSAGES" ] && export LC_MESSAGES          # 且如果 LC_MESSAGES 不为空,则直接导出 LC_MESSAGES 
41        export LANG
42   fi
43 fi
44 #######################*******************************###################

case语句 :它能够把变量的内容与多个模板进行匹配,再根据成功匹配的模板去决定应该执行哪部分代码。
  使用格式:
  case 匹配母板 in
    模板1 [ | 模板2 ] … )  语句组 ;;
    模板3 [ | 模板4 ] … )  语句组 ;;
  esac
  case语句的匹配是从上往下地匹配顺序。因此,case语句编写的原则是从上往下,模板从特殊到普通。在C语言里,case语句中有default模板,而在shell程序设计中,可能将模板写成*,就可以完成相同的功能。
case语句的模板支持匹配
  匹配以n开头的所有情况: n*
  匹配yes的所有字母大小不同的情况: [yY][eE][sS]
  但不支持{}匹配,因为模板可以使用 | 就可以达到目的。
例程:

1 #!/bin/sh
2 echo "Please input \"yes\" or \"no\""
3 read var
4 case "$var" in
5 [yY][eE][sS] ) echo "Your input is YES" ;;
6 [nN][oO]     ) echo "Your input is YES" ;;
7 *            ) echo "Input Error!"      ;;
8 esac
9 exit 0 

# 下面是设置 success、failure、passed、warning 4种情况下的字体颜色的

 1 # Read in our configuration
 2 if [ -z "${BOOTUP:-}" ]; then                                          # 首先如果 BOOTUP 变量为空,则
 3   if [ -f /etc/sysconfig/init ]; then                                  # 如果存在 /etc/sysconfig/init 文件,执行 /etc/sysconfig/init 文件
 4       . /etc/sysconfig/init
 5   else                                                                 # 否则我们就手工设置
 6     # This all seem confusing? Look in /etc/sysconfig/init,
 7     # or in /usr/doc/initscripts-*/sysconfig.txt
 8     BOOTUP=color                                                       # 第一设置 BOOTUP 变量,默认就是 color 
 9     RES_COL=60                                                         # 第二设置设置在屏幕的第几列输出后面的 "[ xxx ]" ,默认是第60列
10     MOVE_TO_COL="echo -en \\033[${RES_COL}G"                           # MOVE_TO_COL 是用于打印 "OK" 或者 "FAILED" ,或者 "PASSED" ,或者 "WARNING" 之前的部分,不含 "[" 
11     SETCOLOR_SUCCESS="echo -en \\033[1;32m"                            # SETCOLOR_SUCCESS 设置后面的字体都为绿色
12     SETCOLOR_FAILURE="echo -en \\033[1;31m"                            # SETCOLOR_FAILURE 设置后面将要输出的字体都为红色
13     SETCOLOR_WARNING="echo -en \\033[1;33m"                            # SETCOLOR_WARNING 设置后面将要输出的字体都为黄色
14     SETCOLOR_NORMAL="echo -en \\033[0;39m"                             # SETCOLOR_NORMAL 设置后面输出的字体都为白色(默认)
15     LOGLEVEL=1
16   fi
17   if [ "$CONSOLETYPE" = "serial" ]; then                               # 如果是通过串口登录的,则全部取消彩色输出
18       BOOTUP=serial
19       MOVE_TO_COL=
20       SETCOLOR_SUCCESS=
21       SETCOLOR_FAILURE=
22       SETCOLOR_WARNING=
23       SETCOLOR_NORMAL=
24   fi
25 fi
26 ##########################################################################################################################################################
27 if [ "${BOOTUP:-}" != "verbose" ]; then                                # 如果 BOOTUP 变量的值不为 verbose ,则
28    INITLOG_ARGS="-q"                                                   # 把 INITLOG_ARGS 的值设置为 -q (安静模式)
29 else                                                                   # 否则
30    INITLOG_ARGS=                                                       # 把 INITLOG_ARGS 的值请空 
31 fi

#################################################################################################

 

1 # Check if $pid (could be plural) are running            # 下面定义一个函数 checkpid (),目的是检查 /proc 下是否存在指定的目录(例如 /proc/1/2 checkpid() {                                             # 如果有任意一个存在,则返回0;
3 local i   #局部变量定义
4 
5 for i in $* ; do
6   [ -d "/proc/$i" ] && return 0
7 done
8 return 1                                                 # 如果给出的参数全部不存在对应的目录,则返回1
9 }

 

#####################################################################################################

 1 # A function to start a program.                        # 下面定义最重要的一个函数,daemon 函数,它的作用是启动某项服务。/etc/init.d/ 下的脚本的 start 部分都会用到它
 2 daemon() {
 3 # Test syntax.
 4 local gotbase= force=
 5 local base= user= nice= bg= pid=
 6 nicelevel=0
 7 while [ "$1" != "${1##[-+]}" ]; do                      # daemon 函数本身可以指定多个选项,例如 --check <value> ,--check=<value> 8    case $1 in
 9      '')    echo $"$0: Usage: daemon [+/-nicelevel] {program}"    # 也可以指定 nice 值
10             return 1;;
11      --check)
12      base=$2
13      gotbase="yes"
14      shift 2
15      ;;
16      --check=?*)
17          base=${1#--check=}
18      gotbase="yes"
19      shift
20      ;;
21      --user)                                             # 也可以指定要以什么用户身份运行(--user <usr> , --user=<usr>)
22      user=$2
23      shift 2
24      ;;
25      --user=?*)
26             user=${1#--user=}
27      shift
28      ;;
29      --force)
30          force="force"                                    # --force 表示强制运行
31      shift
32      ;;
33      [-+][0-9]*)
34          nice="nice -n $1"                                # 如果 daemon 的第一个参数是数字,则认为是 nice 值
35             shift
36      ;;
37      *)     echo $"$0: Usage: daemon [+/-nicelevel] {program}"
38             return 1;;
39    esac
40 done
41 
42         # Save basename.                                  # basename 就是从服务器的二进制程序的 full path 中取出最后的部分
43         [ -z "$gotbase" ] && base=${1##*/}                                       
44 
45         # See if it's already running. Look *only* at the pid file.    # 检查该服务是否已经在运行。不过 daemon 函数只查看 pid 文件而已
46 if [ -f /var/run/${base}.pid ]; then                      # 如果 /var/run 下存在该服务的 pid 文件,则
47   local line p
48   read line < /var/run/${base}.pid                        # 从该 pid 文件每次读取一行,送给变量 line 。注意 pid 文件可能有多行,且不一定都是数字
49   for p in $line ; do                                                                   # 对于 line 变量的每个 word 进行检查
50    [ -z "${p//[0-9]/}" -a -d "/proc/$p" ] && pid="$pid $p"                     # 如果 p 全部是数字,且存在 /proc/$p/ 目录,则认为该数字是一个 pid ,把它加入到 pid 变量
51   done                                                    # 到最后 pid 变量的值可能是有多个由空格分隔的数字组成
52 fi
53 [ -n "${pid:-}" -a -z "${force:-}" ] && return            # 如果 pid 变量最终为空,则 force 变量为空(不强制启动),则返回
54 
55 # make sure it doesn't core dump anywhere unless requested        # 下面对该服务使用的资源作一些设置
56 ulimit -S -c ${DAEMON_COREFILE_LIMIT:-0} >/dev/null 2>&1         # ulimit 是控制由该 shell 启动的进程能够使用的资源,-S 是 soft control 的意思,-c 是指最大的 core   
57                                                           # dump 文件大小,如果 DEAMON_COREFILE_LIMIT 为空,则默认为 0
58 # if they set NICELEVEL in /etc/sysconfig/foo, honor it   # 如果存在 /etc/sysconfi/foo 文件,且其中有 NICELEVEL 变量则用它代替  daemon 后面的那个 nice 值
59 [ -n "$NICELEVEL" ] && nice="nice -n $NICELEVEL"          # 注意,这里的 nice 赋值是用 nice -n <value> 的格式,因为 nice 本身可以启动命令,用这个格式较方便
60 # Echo daemon                                             # 如果 BOOTUP 的值为 verbose ,则打印一个服务名
61         [ "${BOOTUP:-}" = "verbose" -a -z "$LSB" ] && echo -n " $base"
62 
63 # And start it up.                                        # 下面是开始启动它了
64 if [ -z "$user" ]; then                                   # 如果 user 变量为空,则默认使用 root 启动它
65     $nice initlog $INITLOG_ARGS -c "$*"                   # 执行 nice -n <nice_value> initlog -q -c "$*" 
66 else                                                      # 如果指定了用户,则
67     $nice initlog $INITLOG_ARGS -c "runuser -s /bin/bash - $user -c \"$*\""                # 执行 nice -n <nice_value> initlog -q -c "runuser -s /bin/bash - <user> -c "$*"
68 fi
69 [ "$?" -eq 0 ] && success $"$base startup" || failure $"$base startup"                # 如果上面的命令成功,则显示一个绿色的 [ OK ] ,否则显示 [ FAILURE ]
70 }

################################################################################################ 

 1 # A function to stop a program.                                # 下面定义另外一个很重要的函数 killproc ,/etc/init.d/ 下面的脚本的 stop 部分都会用到它
 2 killproc() {
 3 RC=0                                                           # RC 是最终返回的值,初始化为 0
 4 # Test syntax.
 5 if [ "$#" -eq 0 ]; then                                        # killproc 函数的语法格式是 killproc <service> [<signal>] ,例如 killproc sm-client 9
 6   echo $"Usage: killproc {program} [signal]"              
 7   return 1
 8 fi
 9 
10 notset=0                                                       # noset 是用于检查用户是否指定了 kill 要使用的信号
11 # check for second arg to be kill level                  
12 if [ -n "$2" ]; then                                           # 如果 $2 不为空,则表示用户有设定信号,则
13   killlevel=$2                                                 # 把 $2 的值赋予 killlevel 变量
14 else                                                           # 否则
15   notset=1                                                     # notset 变量的值为1,同时 killlevel 为 '-9' (KILL 信号)
16   killlevel="-9"
17 fi
18 
19 # 补充 :注意,并不是说用户没有指定信号地停止某项服务时,就会立即用 kill -9 这样的方式强制杀死,而是先用 TERM 信号,然后再用 KILL
20 
21         # Save basename.
22         base=${1##*/}                                          # basename 就是得出服务的名称
23 
24         # Find pid.
25 pid=                                                           # 把 pid 变量的值清空。注意,不是指 pid 变量的值等于下面脚本的执行结果,要看清楚
26 if [ -f /var/run/${base}.pid ]; then                           # 下面和上面的 daemon 函数一样找出 pid 
27     local line p
28     read line < /var/run/${base}.pid
29     for p in $line ; do
30        [ -z "${p//[0-9]/}" -a -d "/proc/$p" ] && pid="$pid $p"
31     done
32 fi
33 if [ -z "$pid" ]; then                                         # 不过和 daemon 不同的是,一旦 pid 为空不会直接 return 而是尝试用 pid 命令再次查找
34   pid=`pidof -o $$ -o $PPID -o %PPID -x $1 || \                # -o 是用于忽略某个 pid ,-o $$ 是忽略当前 shell 的 pid、-o $PPID 是忽略 shell 的 pid 
35    pidof -o $$ -o $PPID -o %PPID -x $base`                     # -o %PPID 是忽略 pidof 命令的父进程,要查询的进程是 $1 (fullpath) 或者 $base 
36 fi
37 
38 # Kill it.                                                            
39   if [ -n "${pid:-}" ] ; then                                  # 如果 pid 的值最终不为空,则
40     [ "$BOOTUP" = "verbose" -a -z "$LSB" ] && echo -n "$base "    # 且 BOOTUP 的值为 verbose ,且 LSB 变量不为空,则打印一个服务名
41 
42     if [ "$notset" -eq "1" ] ; then                                        # 如果 notset 变量不为1,表示用户没有指定信号,则
43          if checkpid $pid 2>&1; then                                        # 调用 checkpid  $pid 检查是否在 /proc/ 下存在进程目录,如果有
44               # TERM first, then KILL if not dead                            # 先尝试用 TERM 信息,不行再用 KILL 信号
45               kill -TERM $pid >/dev/null 2>&1                                # 执行 kill -TERM $pid 
46               usleep 100000                                                          # usleep 和 sleep 一样,不过单位是百万分之1秒。这里休眠1秒
47               if checkpid $pid && sleep 1 &&                                # 如果 checkpid $pid 还是查到有 /proc/<pid>/ 目录存在,则表示还没有杀死,继续等待1秒
48                  checkpid $pid && sleep 3 &&                                # 如果1秒后用 checkpid 检查还是有,则再等待3秒;
49                  checkpid $pid ; then                                           # 如果还是没有杀死,则用 KILL 信号
50                         kill -KILL $pid >/dev/null 2>&1                            # 执行 kill -KILL 杀死它
51                         usleep 100000                                                    # 等待1秒种
52               fi
53     fi
54     checkpid $pid                                                             # 再次检查 pid 目录       
55     RC=$?                                                                         # 并把结果返回给 RC ,这就算是 killproc 的最后状态了
56     [ "$RC" -eq 0 ] && failure $"$base shutdown" || success $"$base shutdown"    # 如果 RC 的值为0,则表示kill -9 没有杀死了进程,则调用 failure 函数,否则调用 success 
57     RC=$((! $RC))
58   
59     # use specified level only                                            # 上面都是在没有指定信号的情况的,下面是用户指定了信号的。例如 restart)或者 reload)部分
60     else    # 这个 else 是针对 if [ "$notset" -eq "1" ]  的
61        if checkpid $pid; then                                             # 如果检查到进程存在,则
62             kill $killlevel $pid >/dev/null 2>&1                            # 执行kill命令,但使用指定的信号 $killlevel
63             RC=$?                                                                     # 并把状态值返回给变量 RC
64             [ "$RC" -eq 0 ] && success $"$base $killlevel" || failure $"$base $killlevel"    # 如果 RC 为0则表示成功,调用 success;否则调用 failure 函数
65        fi
66   fi
67 else      # 这个 else 是针对 if [ -n "${pid:-}" ]  的,也就是说没有 pid 文件,pidof 命令也没有找到 pid ,则
68      failure $"$base shutdown"                # 调用 failure 函数,表示停止服务失败
69      RC=1                                             # 同时 RC 的值为1
70 fi
71 
72 # Remove pid file if any.                    # 根据具体情况可能需要删除 pid 文件
73 if [ "$notset" = "1" ]; then                    # 如果 notset 不为1 ,也就是用户没有指定信号的情况
74             rm -f /var/run/$base.pid            # 自动删除 /var/run 下的 pid 文件
75 fi
76 return $RC                                        # 并把 RC 作为 exit status 返回
77 }
78 
79 # 补充 :自所以删除 pid 文件只针对 notset 为1 的情况,是因为 -HUP 信号(重读配置),并不杀死进程,所以不能删除它的 pid 文件
80 
81 # 例如下面 :
82 # ps -ef |grep xinetd
83 root      2635     1  0 12:25 ?        00:00:00 xinetd -stayalive -pidfile /var/run/xinetd.pid
84 # ./xinetd reload
85 Reloading configuration:                                   [  OK  ]
86 # ps -ef |grep xinetd
87 root      2635     1  0 12:25 ?        00:00:00 xinetd -stayalive -pidfile /var/run/xinetd.pid
88 root      3927  3412  0 16:43 pts/0    00:00:00 grep xinetd
89 #可以看到 pid 在 reload 后并没有变

##################################################################################################

 1 # A function to find the pid of a program. Looks *only* at the pidfile        
 2 # 下面的 pidfileofproc 函数和 checkpid 类似,但不执行 pidof 命令,只查询 pid 文件
 3 pidfileofproc() {
 4 local base=${1##*/}
 5 # Test syntax.
 6 if [ "$#" = 0 ] ; then
 7   echo $"Usage: pidfileofproc {program}"
 8   return 1
 9 fi
10 
11 # First try "/var/run/*.pid" files
12 if [ -f /var/run/$base.pid ] ; then
13          local line p pid=
14     read line < /var/run/$base.pid
15     for p in $line ; do
16          [ -z "${p//[0-9]/}" -a -d /proc/$p ] && pid="$pid $p"
17     done
18          if [ -n "$pid" ]; then
19                  echo $pid
20                  return 0
21          fi
22 fi
23 }

#################################################################################################

 1 # A function to find the pid of a program.                        # 下面的 pidofproc 函数和上面的 pidfileofproc 函数类似,但多了一步 pidof 命令
 2 pidofproc() {
 3 base=${1##*/}
 4 
 5 # Test syntax.
 6 if [ "$#" = 0 ]; then
 7   echo $"Usage: pidofproc {program}"
 8   return 1
 9 fi
10 
11 # First try "/var/run/*.pid" files
12 if [ -f /var/run/$base.pid ]; then
13          local line p pid=
14   read line < /var/run/$base.pid
15   for p in $line ; do
16          [ -z "${p//[0-9]/}" -a -d /proc/$p ] && pid="$pid $p"
17   done
18          if [ -n "$pid" ]; then
19                  echo $pid
20                  return 0
21          fi
22 fi
23 pidof -o $$ -o $PPID -o %PPID -x $1 || \
24   pidof -o $$ -o $PPID -o %PPID -x $base
25 }

####################################################################################

 1 status() {                                                                  # 注释 :下面的 status 函数是判断服务的状态,总共有4种
 2 local base=${1##*/}
 3 local pid
 4 
 5 # Test syntax.
 6 if [ "$#" = 0 ] ; then
 7   echo $"Usage: status {program}"
 8   return 1
 9 fi
10 
11 # First try "pidof"                                                        # 同样是查找 pid 先。直接使用 pidof 命令
12 pid=`pidof -o $$ -o $PPID -o %PPID -x $1 || \                
13       pidof -o $$ -o $PPID -o %PPID -x ${base}`
14 if [ -n "$pid" ]; then                                                    # 如果 pid 变量的值不为空,则表示找到进程,
15          echo $"${base} (pid $pid) is running..."                 # 则打印 "xxx (pid nnn) is running " ,
16          return 0                                                             # 并返回 0
17 fi
18 
19 # Next try "/var/run/*.pid" files                                    # 如果 pidof 命令没有找到,则尝试从 pid 文件找
20 if [ -f /var/run/${base}.pid ] ; then
21          read pid < /var/run/${base}.pid
22          if [ -n "$pid" ]; then                                                # 如果 pidof 命令找不到,但从 pid 文件找到了 pid ,则
23                  echo $"${base} dead but pid file exists"                # 打印 "xxx dead but pid file exists"24                  return 1                                                             # 并返回 1
25          fi
26 fi
27 # See if /var/lock/subsys/${base} exists                            # 如果 pidof 命令和 pid 文件都没有找到 pid ,则
28 if [ -f /var/lock/subsys/${base} ]; then                              # 如果在 /var/lock/subsys 下存在对应的文件,则
29   echo $"${base} dead but subsys locked"                               # 打印 “xxxx dead but subsys locked”,
30   return 2                                                                            # 并返回 2
31 fi
32 echo $"${base} is stopped"                                                # 如果 pidof 命令、pidf 文件都没有找到pid ,且没有别锁,则打印 “xxx is stopped”
33 return 3                                                                           # 并返回3
34 }

###########################################################################################

 1 # 注释 :下面的 echo_xxx 函数就是真正在屏幕上打印 [ ok ] 、[ PASSED ]、[ FAILURE ]、[ WARNING ] 的部分了
 2 
 3 echo_success() {                                                                    # 下面是 echo_success 部分
 4   [ "$BOOTUP" = "color" ] && $MOVE_TO_COL                           # 首先是打印 “[” 之前的空格
 5   echo -n "[  "                                                                         # 然后打印 "[" 
 6   [ "$BOOTUP" = "color" ] && $SETCOLOR_SUCCESS                    # 设置字体为红色
 7   echo -n $"OK"                                                                       # 打印 OK
 8   [ "$BOOTUP" = "color" ] && $SETCOLOR_NORMAL                     # 返回字体为白色
 9   echo -n "  ]"                                                                         # 打印 "]"    
10   echo -ne "\r"                                                                        # 换行。
11   return 0                                                                               # 返回 0,其他一律返回 1
12 
13 
14 echo_failure() {
15   [ "$BOOTUP" = "color" ] && $MOVE_TO_COL
16   echo -n "["
17   [ "$BOOTUP" = "color" ] && $SETCOLOR_FAILURE
18   echo -n $"FAILED"
19   [ "$BOOTUP" = "color" ] && $SETCOLOR_NORMAL
20   echo -n "]"
21   echo -ne "\r"
22   return 1
23 }
24 
25 echo_passed() {
26   [ "$BOOTUP" = "color" ] && $MOVE_TO_COL
27   echo -n "["
28   [ "$BOOTUP" = "color" ] && $SETCOLOR_WARNING
29   echo -n $"PASSED"
30   [ "$BOOTUP" = "color" ] && $SETCOLOR_NORMAL
31   echo -n "]"
32   echo -ne "\r"
33   return 1
34 }
35 
36 echo_warning() {
37   [ "$BOOTUP" = "color" ] && $MOVE_TO_COL
38   echo -n "["
39   [ "$BOOTUP" = "color" ] && $SETCOLOR_WARNING
40   echo -n $"WARNING"
41   [ "$BOOTUP" = "color" ] && $SETCOLOR_NORMAL
42   echo -n "]"
43   echo -ne "\r"
44   return 1
45 }

##################################################################################################

1 # Inform the graphical boot of our current state
2 update_boot_stage() {
3   if [ "$GRAPHICAL" = "yes" -a -x /usr/bin/rhgb-client ]; then
4     /usr/bin/rhgb-client --update="$1"
5   fi
6   return 0
7 }

################################################################################################

 

 1 # Log that something succeeded                                                
 2 success() {                                                                                                # success 函数除了打印 [ xxx ] 之外,还会使用 initlog 记录信息
 3   if [ -z "${IN_INITLOG:-}" ]; then
 4      initlog $INITLOG_ARGS -n $0 -s "$1" -e 1                                                   # -n 是 --name 的意思,-s 是 --string ,-e 是 --event1 表示完全成功
 5   else
 6      # silly hack to avoid EPIPE killing rc.sysinit
 7      trap "" SIGPIPE
 8      echo "$INITLOG_ARGS -n $0 -s \"$1\" -e 1" >&21
 9      trap - SIGPIPE
10   fi
11   [ "$BOOTUP" != "verbose" -a -z "$LSB" ] && echo_success
12   return 0
13 }
14 
15 # Log that something failed
16 failure() {
17   rc=$?
18   if [ -z "${IN_INITLOG:-}" ]; then
19      initlog $INITLOG_ARGS -n $0 -s "$1" -e 2                                                    # failure 的话 --event2 是失败
20   else
21      trap "" SIGPIPE
22      echo "$INITLOG_ARGS -n $0 -s \"$1\" -e 2" >&21
23      trap - SIGPIPE
24   fi
25   [ "$BOOTUP" != "verbose" -a -z "$LSB" ] && echo_failure
26   [ -x /usr/bin/rhgb-client ] && /usr/bin/rhgb-client --details=yes
27   return $rc
28 }
29 
30 # Log that something passed, but may have had errors. Useful for fsck
31 passed() {
32   rc=$?
33   if [ -z "${IN_INITLOG:-}" ]; then
34      initlog $INITLOG_ARGS -n $0 -s "$1" -e 1                                                 # passed 的话 --event 还是1
35   else
36      trap "" SIGPIPE
37      echo "$INITLOG_ARGS -n $0 -s \"$1\" -e 1" >&21
38      trap - SIGPIPE
39   fi
40   [ "$BOOTUP" != "verbose" -a -z "$LSB" ] && echo_passed
41   return $rc
42 }
43 
44 # Log a warning
45 warning() {
46   rc=$?
47   if [ -z "${IN_INITLOG:-}" ]; then
48      initlog $INITLOG_ARGS -n $0 -s "$1" -e 1                                                # warning 的话 --event 也是 1
49   else
50      trap "" SIGPIPE
51      echo "$INITLOG_ARGS -n $0 -s \"$1\" -e 1" >&21
52      trap - SIGPIPE
53   fi
54   [ "$BOOTUP" != "verbose" -a -z "$LSB" ] && echo_warning
55   return $rc
56 } 

 

####################################################################################################

# 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
}

###############################################################################################

1 # returns OK if $1 contains $2                        # strstr 函数是判断 $1 字符串是否含有 $2 字符串,是则返回0,否则返回1
2 () {
3   [ "${1#*$2*}" = "$1" ] && return 1
4   return 0
5 }

#############################################################################################

 1 # Confirm whether we really want to run this service                                       # confirm 函数是用于交互式的启动服务
 2 nfirm() {
 3   [ -x /usr/bin/rhgb-client ] && /usr/bin/rhgb-client --details=yes
 4   while : ; do 
 5     echo -n $"Start service $1 (Y)es/(N)o/(C)ontinue? [Y] "                                   # 会打印一个提示信息
 6     read answer
 7     if strstr $"yY" "$answer" || [ "$answer" = "" ] ; then                                          # 如果 answer 变量是 y 或者 Y 则
 8         return 0                                                                                                                # 返回 0(但未真正启动)
 9     elif strstr $"cC" "$answer" ; then                                                                    # 如果 answer 是 c 或者 C ,则
10         rm -f /var/run/confirm                                                                                          # 删除 /var/run/confirm 文件                           
11         [ -x /usr/bin/rhgb-client ] && /usr/bin/rhgb-client --details=no
12         return 2                                                                                                                # 返回2
13    elif strstr $"nN" "$answer" ; then                                                                      # 如果 answer 是 n 或者 N,则
14   return 1                                                                                                                       # 直接返回1
15      fi
16   done
17 }

 

posted @ 2016-01-21 21:44  天~宇~翱~翔  阅读(19979)  评论(0编辑  收藏  举报