Skip to main content

OpenRC

rc_sysfor
dockerDocker container manager (Linux)
jailJail (DragonflyBSD or FreeBSD)
lxcLinux Containers
openvzLinux OpenVZ
prefixPrefix
rktCoreOS container management system (Linux)
subhurdHurd subhurds (to be checked)
systemd-nspawnContainer created by systemd-nspawn (Linux)
umlUsermode Linux
vserverLinux vserver
xen0Xen0 Domain (Linux and NetBSD)
xenUXenU Domain (Linux and NetBSD)

/etc/inittab​

::sysinit:/sbin/openrc sysinit
::sysinit:/sbin/openrc boot
::wait:/sbin/openrc default

# Set up a couple of getty's
tty1::respawn:/sbin/getty 38400 tty1
tty2::respawn:/sbin/getty 38400 tty2
tty3::respawn:/sbin/getty 38400 tty3
tty4::respawn:/sbin/getty 38400 tty4
tty5::respawn:/sbin/getty 38400 tty5
tty6::respawn:/sbin/getty 38400 tty6

# Put a getty on the serial port
#ttyS0::respawn:/sbin/getty -L ttyS0 115200 vt100

# Stuff to do for the 3-finger salute
::ctrlaltdel:/sbin/reboot

# Stuff to do before rebooting
::shutdown:/sbin/openrc shutdown

service​

#!/sbin/openrc-run

command="/usr/sbin/ntpd"
pidfile="/run/${RC_SVCNAME}.pid"
command_args="-p ${pidfile}"

command_args_background="--daemon"
# start-stop-daemon --make-pidfile
command_background=true

command_user="user:group"
# ^cap_chown,!cap_setpcap
capabilities="cap-list"
procname="cancd"

# 定义依赖
depend() {
  need net
  use dns logger netmount
  want coolservice
  # provide
}

extra_started_commands="reload"

extra_commands="checkconfig"
checkconfig() {
  #
}

reload() {
  checkconfig || return $?
  ebegin "Reloading ${RC_SVCNAME}"
  start-stop-daemon --signal HUP --pidfile "${pidfile}"
  eend $?
}

# 启动停止检查配置
start_pre() {
  if [ "${RC_CMD}" != "restart" ]; then
    checkconfig || return $?
  fi
}

stop_pre() {
  if [ "${RC_CMD}" = "restart" ]; then
    checkconfig || return $?
  fi
}
  • RC_SVCNAME
  • 主要函数
    • start
    • stop
    • status
  • depend
    • need - 强制依赖
    • use - soft dependency - 如果在相同 runlevel 则 start，已经 start 不关心
    • want - 尝试 start，不关心 runlevel，已经 start 不关心
    • before - 在给定服务之前启动
    • after - 在给定服务之后启动
    • provide - 提供服务 - 类似别名或相同服务
    • keyword
    • 依赖
      • 影响服务起停
      • 例如: 重启 服务 -> 会先停止 依赖，重启服务，然后再启动 依赖
    • 依赖服务 - 会 start 依赖服务
    • 被服务依赖 - 会 stop & start 依赖服务
  • https://github.com/OpenRC/openrc/blob/master/service-script-guide.md

start-stop-daemon​

flagsfor
--exec $command
--chroot $chroot
--chdir $directory工作目录
--stdout $output_log
--stderr $error_log
--stdout-logger $output_logger
--stderr-logger $error_logger
--capabilities $capabilities
--secbits $secbits
--no-new-privs $no_new_privs
--name $procname
--pidfile $pidfile
--user $command_user
--umask $umask
$command_args
$command_args_background
start-stop-daemon --start \
  --exec $command \
  ${chroot:+--chroot} $chroot \
  ${directory:+--chdir} $directory \
  ${output_log+--stdout} $output_log \
  ${error_log+--stderr} $error_log \
  ${output_logger:+--stdout-logger \"$output_logger\"} \
  ${error_logger:+--stderr-logger \"$error_logger\"} \
  ${capabilities+--capabilities} "$capabilities" \
  ${secbits:+--secbits} "$secbits" \
  ${no_new_privs:+--no-new-privs} \
  ${procname:+--name} $procname \
  ${pidfile:+--pidfile} $pidfile \
  ${command_user+--user} $command_user \
  ${umask+--umask} $umask \
  $_background $start_stop_daemon_args \
  -- $command_args $command_args_background

supervise-daemon​

flagfor
-u, --user user[:group]
-D, --respawn-delay seconds0
-m, --respawn-max count10
-P, --respawn-period seconds
-R, --retry [signal/]timeoutSIGTERM/5
-d, --chdir path
-r, --chroot path
-, --signal signal
-g, --group group
-k, --umask mode
-p, --pidfile supervisorpidfile
-1, --stdout logfile
-2, --stderr logfile
supervise-daemon "${RC_SVCNAME}" --start \
  ${retry:+--retry} $retry \
  ${directory:+--chdir} $directory \
  ${chroot:+--chroot} $chroot \
  ${output_log+--stdout} ${output_log} \
  ${error_log+--stderr} $error_log \
  ${output_logger:+--stdout-logger \"$output_logger\"} \
  ${error_logger:+--stderr-logger \"$error_logger\"} \
  ${pidfile:+--pidfile} $pidfile \
  ${respawn_delay:+--respawn-delay} $respawn_delay \
  ${respawn_max:+--respawn-max} $respawn_max \
  ${respawn_period:+--respawn-period} $respawn_period \
  ${healthcheck_delay:+--healthcheck-delay} $healthcheck_delay \
  ${healthcheck_timer:+--healthcheck-timer} $healthcheck_timer \
  ${capabilities+--capabilities} "$capabilities" \
  ${secbits:+--secbits} "$secbits" \
  ${no_new_privs:+--no-new-privs} \
  ${command_user+--user} $command_user \
  ${umask+--umask} $umask \
  ${supervise_daemon_args-${start_stop_daemon_args}} \
  $command \
  -- $command_args $command_args_foreground

settings​

varfor
supervisor=supervise-daemon
command_args_foreground="arguments"
healthcheck_delay=seconds
healthcheck_timer=seconds
respawn_delay
respawn_max=x
respawn_period=seconds

FAQ

failed to add service sysfs to runlevel boot': No such file or directory​

for svc in $BOOT_SERVICES; do ln -fs /etc/init.d/$svc /etc/runlevels/boot; done

is the name of a real and virtual service​

  • virtual service
    • 是 openrc 中 provide 后面的内容
  • real service
    • 是 /etc/init.d 下名字

provide 的名字和实际服务名字冲突

restart​

# 默认 0
respawn_delay=5
# 默认 10
respawn_max=0

或

# 默认 SIGTERM/5
retry="${TINC_RETRY:-TERM/60/KILL/10}"

supervise-daemon: unable to open the logfile for stdout `/var/log/app.log': Permission denied​