分类： LINUX
2014-05-21 16:19:45
# -*-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
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=$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/sysconfig/foo
文件，且其中有 NICELEVEL 变量则用它代替 daemon 后面的那个 nice 值
[ -n "$NICELEVEL" ]
&& nice="nice -n
$NICELEVEL" #
注意，这里的 nice 赋值是用 nice -n
# 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
else #
如果指定了用户，则
$nice initlog $INITLOG_ARGS -c "runuser -s
/bin/bash - $user -c \"$*\"" # 执行 nice -n
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
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/
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}
#
Test syntax.
if [ "$#" = 0 ]; then
echo $"Usage: pidofproc
{program}"
return 1
fi
# First try
"/var/run}
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
}
