1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
# 该函数的作用是关闭进程的.
# 用法：
# killproc [-p pidfile] [-d delay] <program> [-signal]
# -p:  指定进程的pid文件，一般在/var/run/xxx.pid
# -d:  指定延迟多长时间就强度关闭进程
# -signal: 关闭进程的信号
# A function to stop a program.             
killproc() {
         local  RC killlevel= base pid pid_file= delay     
         # 定义局部变量，只在函数体内有效。
         RC=0; delay=3   # 默认延迟3秒，不能正常关闭就强制关闭
         # Test syntax. # 判断用户调用该函数时，给的参数格式。并使用变量记录下来
         if  [  "$#"  - eq  0 ];  then
                 echo  $"Usage: killproc [-p pidfile] [ -d delay] {program} [-signal]“
         # 如果调用该函数时，不使用任何参数的话将给用户输出使用该函数的使用方法。                                                                         
                 return  1        # 退出该函数。
         fi
         if  [  "$1"  =  "-p"  ];  then   
                 # 如果参数1，是字符 -p 的话，那么用户输入的第二个参数就是：
                 # 程序的pid_file文件。通常是/var/run/XXX.pid
                 pid_file=$2    
                 shift  2         
         fi
         if  [  "$1"  =  "-d"  ];  then
                 delay=$2    
                 # 记录的参数的作用是用来。如果进程在正常情况下不能关闭，
                 # 延迟多长时间就向该进程发送SIGKILL信号强制关闭。
                 shift  2
         fi
         # check for second arg to be kill level 
         # 检查用户是否指定函数关闭进程时，所使用的信号。
         [ -n  "${2:-}"  ] && killlevel=$2
         # Save basename.       # 保存进程的二进制运行文件的。
         base=${1 ##*/}          # 参数替换，把程序的二进制文件的路径名***掉。
####################################################################
         # 查找可运行二进制程序的进程号PID 部分
         # Find pid.
         __pids_var_run  "$1"  "$pid_file"     
         #调用 函数:__pids_var_run 来检查用户指定的程序的进程号。
         # 该函数会使用一个变量：PID记录程序的进程号的。
         if  [ -z  "$pid_file"  -a -z  "$pid"  ];  then 
         # 如果pidfile文件不存在，并且找不到进程的pid号。
         # 就使用该方法查找该程序$base的PID号。
                 pid= "$(__pids_pidof " $1 ")"
         fi
  #####################################################################
         # Kill it.       
         # 找到二进制可运行程序的进程号，是如果关闭进程的
         if  [ -n  "$pid"  ] ;  then 
                        # 如果$PID 不为空，证明进程运行的。就执行 then 后的内容
                 [  "$BOOTUP"  =  "verbose"  -a -z  "${LSB:-}"  ] &&  echo  -n  "$base "
                 if  [ -z  "$killlevel"  ] ;  then  
                #如果用户没有指定函数要使用关闭进程的信号的话，就执行 then后的内容
                        if  checkpid $pid 2>&1;  then  
                         # 调用函数：checkpid 来判断进程号为：$PID的进程是否
                         #运行。其实 checkpid是判断$PID,如果伪目录/proc 
                         #下是否有一个目录名和$PID相同
                            # TERM first, then KILL if not dead
                            kill  -TERM $pid > /dev/null  2>&1   
                            # 给进程$PID发送 -15信号。等待进程关闭资源后，
                            # 再杀死该进程。
                            usleep 100000    #等待100000 微秒
                            if  checkpid $pid &&  sleep  1 && 
                                #再使用函数checkpid检查,如果进程还运行的话，
                                #再等待1秒，
                               checkpid $pid &&  sleep  $delay &&  
                               #再使用函数checkpid检查,如果进程还运行的话，
                               #就使用用户给的延迟时间，再等待
                               checkpid $pid ;  then      
                                 #在用户给的延时时间到了,再次使用函数
                                 #checkpid检查，如果进程还是运行的
                                 # 话，就强制关闭。
                                 kill  -KILL $pid > /dev/null  2>&1  
                                 # 给进程$PID发送 -9 信号，强制关闭该进程。
                                 usleep 100000
                            fi
                         fi
                         checkpid $pid   # 再次确认下，进程$PID是否是关闭的。
                         RC=$?     
                            # 记录函数checkpid的返回结果。
                            # 如果是：0 的话就代表关闭进程$PID成功。
                         [  "$RC"  - eq  0 ] && failure $ "$base shutdown"  || success   $ "$base shutdown"
               # 判断函数checkpid的返回值，给用户输出进程是否关闭成功的信                        RC=$((! $RC))  
                    # 对变量RC进行，非操作，避免下面使用该变量时，判断有误。
                 # use specified level only
                   #调用函数：killproc时传递有关闭进程的信号就执行else 后的程序
                 else    # 如果用户给函数killproc 传递了关闭进程所使用的信号，
                        #就执行else后的代码
             # 作用想要通知进程重读配置文件时， 可以传递一个 -HUP 信号给进程。
                         if  checkpid $pid;  then                                                   #使用函数checkpid检查，进程$PID是否运行的，
 
                        kill  $killlevel $pid > /dev/null  2>&1    
                              #使用用户传递关闭进程的信号来关闭进程$PID
                                 RC=$?   #记录函数checkpid的返回结果。 
                                 [  "$RC"  eq  0 ] && success $ "$base $killlevel"   || failure $ "$base $killlevel"    
                              # 根据$RC判断进程$PID是否关闭成功                                                
                       elif  [ -n  "${LSB:-}"  ];  then   
                                 RC=7  # Program is not running
                         fi
                 fi
                  ###########################找不到二进制可运行程序的进程号
         else
                 if  [ -n  "${LSB:-}"  -a -n  "$killlevel"  ];  then
                         RC=7  # Program is not running
                 else
                         failure $ "$base shutdown"
                         RC=0
                 fi
         fi
         # Remove pid file if any.
         if  [ -z  "$killlevel"  ];  then
             rm  -f  "${pid_file:-/var/run/$base.pid}"
         fi
         return  $RC
}