'\" t
.TH "DAEMON" "7" "" "systemd 231" "daemon"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
daemon \- 编写与打包系统守护进程
.SH "描述"
.PP
"守护进程"的意思是在后台运行的服务进程， 常用于监督系统的运行或者提供某种功能。 在传统的 SysV Unix 系统上， 多个守护进程必须严格按照特定的顺序依次启动。 在"新型"的
\fBsystemd\fR(1)
系统上， 守护进程的启动顺序非常简单且非常强大。 本手册同时解说了上述两种不同的启动方案， 并特别推荐了应该包含在 systemd 系统中的守护进程。
.SS "传统的SysV守护进程"
.PP
传统的SysV守护进程在启动的时候， 应该在初始化阶段执行下面的步骤：
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
关闭除 STDIN STDOUT STDERR 之外的所有文件描述符
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
重置所有信号处理器
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  3." 4.2
.\}
重置所有信号掩码
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 4.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  4." 4.2
.\}
清理环境变量(重置一部分，移除一部分)
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 5.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  5." 4.2
.\}
调用
\fBfork()\fR
创建一个后台进程
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 6.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  6." 4.2
.\}
在子进程中调用
\fBsetsid()\fR
从终端脱离并创建一个独立的会话
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 7.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  7." 4.2
.\}
在子进程中再一次调用
\fBfork()\fR
以确保守护进程永远无法获取任何终端。
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 8.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  8." 4.2
.\}
第一个子进程主动退出， 只有第二个子进程(实际的守护进程)保持运行， 并且以 init(PID=1) 为父进程。
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 9.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  9." 4.2
.\}
守护进程(第二个子进程)将 STDIN STDOUT STDERR 连接到
/dev/null
虚拟设备
.RE
.sp
.RS 4
.ie n \{\
\h'-04'10.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "10." 4.2
.\}
守护进程将 umask 设为 0
.RE
.sp
.RS 4
.ie n \{\
\h'-04'11.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "11." 4.2
.\}
守护进程将当前目录切换到根目录(/)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'12.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "12." 4.2
.\}
守护进程将自身的PID记录到例如
/run/foobar\&.pid
这样的文件中
.RE
.sp
.RS 4
.ie n \{\
\h'-04'13.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "13." 4.2
.\}
守护进程丢弃自己不需要的权限(如果可以)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'14.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "14." 4.2
.\}
守护进程通知最初的父进程：初始化工作已完成
.RE
.sp
.RS 4
.ie n \{\
\h'-04'15.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "15." 4.2
.\}
最初的父进程自身退出
.RE
.PP
注意，这些步骤对于下文讲述的新型守护进程是不需要的， 除非为了刻意兼容传统的SysV系统。
.SS "新型守护进程"
.PP
Linux 系统上的新型守护进程更容易被监控也更容易实现。
.PP
守护进程无需实现前文所描述的复杂步骤， 即可直接在 systemd 提供的干净的上下文环境中运行：
.PP
环境变量已经被清理、信号处理器与信号掩码已经被重置、没有遗留的文件描述符、守护进程自动在其专属的会话中执行、 标准输入(STDIN)已被连接到
/dev/null
虚拟设备(除非另有配置)、 标准输出(STDOUT)与标准错误(STDERR)已被连接到
\fBsystemd-journald.service\fR(8)
日志服务(除非另有配置)、umask 已经被重置 \&.\&.\&. 等等
.PP
新型守护进程只需要遵守如下要求：
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
收到
\fBSIGTERM\fR
信号后 关闭进程并确保干净的退出
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
收到
\fBSIGHUP\fR
信号后 重新加载配置文件(若需要)
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  3." 4.2
.\}
主守护进程在退出时应该按照
\m[blue]\fBLSB recommendations for SysV init scripts\fR\m[]\&\s-2\u[1]\d\s+2
的要求返回恰当的退出码， 以便于 systemd 判断服务的退出状态。
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 4.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  4." 4.2
.\}
若可行，在初始化的最后一步， 通过 D\-Bus 创建进程的控制接口， 并在 D\-Bus 上注册一个总线名称。
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 5.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  5." 4.2
.\}
提供一个
\&.service
单元文件， 包含如何启动/停止/维护该服务的配置。 详见
\fBsystemd.service\fR(5)
手册。
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 6.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  6." 4.2
.\}
尽可能依赖于 systemd 的资源控制与权限剥夺功能 (CPU与内存占用/文件访问等等)， 而不要自己实现它们。 详见
\fBsystemd.exec\fR(5)
手册。
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 7.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  7." 4.2
.\}
若使用了 D\-Bus ， 则强烈推荐使用基于 D\-Bus 的启动机制。 这样做有许多好处： 守护进程可以按需延迟启动； 可以和依赖于它的进程并行启动(提升启动速度)； 守护进程可以在失败时被自动重启 而不丢失D\-Bus总线上的请求(详见下文)
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 8.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  8." 4.2
.\}
若守护进程通过套接字提供服务， 则强烈推荐使用基于套接字的启动机制(详见下文)。 这样做有许多好处： 守护进程可以按需延迟启动； 可以和依赖于它的进程并行启动(提升启动速度)； 对于无状态协议(例如 syslog, DNS)， 守护进程可以在失败时被自动重启而不丢失套接字上的请求(详见下文)
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 9.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  9." 4.2
.\}
若可能，守护进程应该通过
\fBsd_notify\fR(3)
接口通知 systemd "启动已完成"或"状态已更新"这样的消息。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'10.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "10." 4.2
.\}
不要使用
\fBsyslog()\fR
记录日志， 只需简单的使用
\fBfprintf()\fR
向 STDERR 输出日志即可。 如果必须指明日志等级， 则可以在日志的 行首加上类似
"<4>"
这样的前缀即可(这里表示4级"WARNING")。 详见
\fBsd-daemon\fR(3)
与
\fBsystemd.exec\fR(5)
手册。
.RE
.PP
上述要求与
\m[blue]\fBApple MacOS X Daemon Requirements\fR\m[]\&\s-2\u[2]\d\s+2
类似， 但并不完全相同。
.SH "启动"
.PP
systemd 提供了多种启动机制(见下文)， 而服务单元也经常同时使用其中的几种。 例如
bluetoothd\&.service
可以在插入蓝牙硬件时被启动， 也可以在某进程访问其 D\-Bus 接口时被启动。 又如打印服务可以在IPP端口有流量接入时被启动， 也可以在插入打印机硬件时被启动， 还可以在有文件进入打印机 spool 目录时被启动。 甚至对于必须在系统启动时无条件启动的服务， 为了尽可能并发启动， 也应该使用某些启动机制。 如果某守护进程实现了一个 D\-Bus 服务或者监听一个套接字， 那么使用基于 D\-Bus 或基于套接字的启动机制， 将允许该进程与其客户端同时并行启动(从而加快启动速度)。 因为所有的通信渠道都已事先建立， 并且不会丢失任何客户端请求， 同时 D\-Bus 总线或者内核会将客户端请求排入队列等候， 直到完成启动。
.SS "系统启动时启动"
.PP
传统的守护进程一般是在系统启动时通过SysV初始化脚本自动启动， systemd 也支持这种启动方式。
.PP
对于 systemd 来说， 如果希望确保某单元在系统启动时自动启动， 那么最佳的做法是在默认启动目标 (通常是
multi\-user\&.target
或
graphical\&.target)的
\&.wants/
目录中为该单元建立软链接。 参见
\fBsystemd.unit\fR(5)
手册以了解
\&.wants/
目录， 参见
\fBsystemd.special\fR(7)
手册以了解上述两个特殊的启动目标。
.SS "基于套接字的启动"
.PP
为了尽可能提高并行性与健壮性， 以及简化配置与开发， 对于需要监听套接字的服务， 强烈推荐使用基于套接字的启动机制。 使用此机制后， 守护进程不再需要创建和绑定套接字， 而是由 systemd 接管这个工作。 systemd 将会根据单元文件的设置， 预先创建所需的套接字， 并在第一个客户端请求接入的时候启动该服务， 以实现服务的按需启动。 该机制的好处还在于， 预先创建好套接字之后， 所有使用此套接字通信的进程可以并行启动(包括客户端和服务端)。 此外，重启服务只会导致丢失最低限度的客户端连接， 甚至不丢失任何客户端请求 (例如对于 DNS 或 syslog 这样的无状态协议)。 因为套接字在服务重启期间始终保持有效并且可被访问， 同时所有客户端请求也都被排入队列等候处理。
.PP
使用此机制之后， 守护进程必须要从 systemd 接收已创建好的套接字， 而不能自己创建并绑定套接字。 关于如何使用该机制，参见
\fBsd_listen_fds\fR(3)
与
\fBsd-daemon\fR(3)
手册。 只需要小小的修改， 即可在原有启动机制的基础上添加基于套接字的启动机制， 至于如何移植，详见后文。
.PP
systemd 通过
\&.socket
单元实现该机制，详见
\fBsystemd.socket\fR(5)
手册。 必须确保所有为支持基于套接字启动而创建的监听 socket 单元都被包含在
sockets\&.target
中。 建议在 socket 单元的
"[Install]"
小节加入
\fIWantedBy=sockets\&.target\fR
设置， 以确保在启用该单元时能够自动添加上述依赖关系。 除非明确设置了
\fIDefaultDependencies=no\fR
， 否则会为所有 socket 单元隐含的创建必要的顺序依赖。 有关
sockets\&.target
的解释，详见
\fBsystemd.special\fR(7)
手册。 如果某 socket 单元已被包含在
sockets\&.target
中， 那么不建议在其中再添加任何额外的依赖关系(例如
multi\-user\&.target
之类)。
.SS "基于 D\-Bus 的启动"
.PP
如果守护进程使用 D\-Bus 与客户端通信， 那么它应该使用基于 D\-Bus 的启动机制， 这样当客户端访问其 D\-Bus 接口时， 该服务将被自动启动。 该机制是通过 D\-Bus service 文件实现的(不要与普通的单元文件混淆)。 为了确保让 D\-Bus 使用 systemd 来启动与维护守护进程， 必须在这些 D\-Bus service 文件中使用
\fISystemdService=\fR
指明其匹配的服务单元。 例如，对于文件名为
org\&.freedesktop\&.RealtimeKit\&.service
的 D\-Bus service 来说， 为了将其绑定到
rtkit\-daemon\&.service
服务单元， 必须确保在该文件中设置了
\fISystemdService=rtkit\-daemon\&.service\fR
指令。 注意，必须明确设置
\fISystemdService=\fR
指令， 否则当服务单元同时使用多种启动机制时， 可能会导致竞争条件的出现。
.SS "基于设备的启动"
.PP
用于管理特定类型硬件的守护进程， 只应该在符合条件的硬件变为可用或者被插入时，才需要启动。 为了达到上述目的， 可以将服务的启动/停止与硬件的插入/拔出事件绑定。 当带有
"systemd"
标签的设备出现在 sysfs/udev 设备树中时， systemd 将会自动为其创建对应的 device 单元。 通过向这些单元中添加对其他单元的
\fIWants=\fR
依赖， 就可以实现当该 device 单元被启动(也就是硬件被插入)时， 连带启动其他单元，从而实现基于设备的启动。 这可以通过向 udev 规则库中添加
\fISYSTEMD_WANTS=\fR
属性来实现， 详见
\fBsystemd.device\fR(5)
手册。 通常，并不是将 service 单元直接添加到设备的
\fIWants=\fR
依赖中， 而是通过专用的 target 单元间接添加。 例如，不是将
bluetoothd\&.service
添加到各种蓝牙设备的
\fIWants=\fR
依赖中， 而是将
bluetoothd\&.service
添加到 bluetooth\&.target 的
\fIWants=\fR
依赖中， 同时再将 bluetooth\&.target 添加到各种蓝牙设备的
\fIWants=\fR
依赖中。 通过引入 bluetooth\&.target 这个抽象层， 系统管理员无需批量修改 udev 规则库， 仅通过
\fBsystemctl enable|disable \&.\&.\&.\fR
命令 修改
bluetooth\&.target\&.wants/
目录中的软链接， 即可控制
bluetoothd\&.service
的使用。
.SS "基于路径的启动"
.PP
对于处理 spool 文件或目录的守护进程(例如打印服务)来说， 仅在 spool 文件或目录状态发生变化或者内容非空时， 才需要启动。 通过
\&.path
单元实现的、 基于路径的启动机制正好适用于这种场合， 详见
\fBsystemd.path\fR(5)
手册。
.SS "基于定时器的启动"
.PP
对于周期性的操作(例如垃圾文件清理或者网络对时)， 可以通过基于定时器的启动机制来实现。 这种机制通过
\&.timer
单元实现，详见
\fBsystemd.timer\fR(5)
手册。
.SS "其他启动方式"
.PP
在其他操作系统上还存在着其他的启动机制， 不过这些机制都可以被前述的各种机制的组合替代。 因此在这里不再赘述。
.SH "与 SYSTEMD 整合"
.SS "编写 systemd 单元文件"
.PP
在编写单元文件时应当考虑下列建议：
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
尽可能不用
\fIType=forking\fR
。 若非用不可，则必须正确设置
\fIPIDFile=\fR
指令。参见
\fBsystemd.service\fR(5)
手册。
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
若守护进程在 D\-Bus 上注册了一个名字， 则应尽可能使用
\fIType=dbus\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  3." 4.2
.\}
设置一个易于理解的
\fIDescription=\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 4.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  4." 4.2
.\}
确保
\fIDefaultDependencies=yes\fR
， 除非该单元必须在系统启动的早期启动或者必须在系统关闭的末期关闭。
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 5.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  5." 4.2
.\}
通常无需显式定义依赖关系。 不过，如果确实需要显式定义依赖关系， 为了确保单元文件不局限于特定的发行版，仅应该依赖于
\fBsystemd.special\fR(7)
中列出的单元以及自身所属软件包中提供的单元。
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 6.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  6." 4.2
.\}
确保在
"[Install]"
小节中包含完整的启用信息(参见
\fBsystemd.unit\fR(5)
手册)。 若希望自动启动该单元， 则应该设置
\fIWantedBy=multi\-user\&.target\fR
或
\fIWantedBy=graphical\&.target\fR
若希望自动启动该单元的套接字，则应该设置
\fIWantedBy=sockets\&.target\fR
。 通常你还希望在启用该单元时， 一起启用对应的套接字单元(假定为
foo\&.service)， 因此还应该设置
\fIAlso=foo\&.socket\fR
.RE
.SS "安装 service 单元文件"
.PP
当从源代码编译安装(\fBmake install\fR)软件包时， 其中的系统服务单元文件会被默认安装到
\fBpkg\-config systemd \-\-variable=systemdsystemunitdir\fR
命令返回的目录中(通常是
/usr/lib/systemd/system)； 而其中的用户服务单元文件会被默认安装到
\fBpkg\-config systemd \-\-variable=systemduserunitdir\fR
命令返回的目录中(通常是
/usr/lib/systemd/user)； 但并不应该使用
\fBsystemctl enable \&.\&.\&.\fR
命令启用它们。 当从包管理器安装(\fBrpm \-i\fR)二进制软件包时， 其中的单元文件应该同样安装到上述位置。 但不同之处在于， 还应该使用
\fBsystemctl enable \&.\&.\&.\fR
命令启用它们， 因此安装的单元有可能会在开机时自动启动。
.SH "移植已有的守护进程"
.PP
虽然 systemd 兼容传统的 SysV 初始化系统， 但是移植旧有的守护进程可以更好的利用 systemd 的先进特性。 建议对旧有的 SysV 守护进程做如下改进： \&.\&.\&.[省略]\&.\&.\&.
.SH "放置守护进程的数据"
.PP
建议遵守
\fBfile-hierarchy\fR(7)
所建议的通用准则。
.SH "参见"
.PP
\fBsystemd\fR(1),
\fBsd-daemon\fR(3),
\fBsd_listen_fds\fR(3),
\fBsd_notify\fR(3),
\fBdaemon\fR(3),
\fBsystemd.service\fR(5),
\fBfile-hierarchy\fR(7)
.SH "NOTES"
.IP " 1." 4
LSB recommendations for SysV init scripts
.RS 4
\%http://refspecs.linuxbase.org/LSB_3.1.1/LSB-Core-generic/LSB-Core-generic/iniscrptact.html
.RE
.IP " 2." 4
Apple MacOS X Daemon Requirements
.RS 4
\%https://developer.apple.com/library/mac/documentation/MacOSX/Conceptual/BPSystemStartup/Chapters/CreatingLaunchdJobs.html
.RE
.SH "跋"
.br
本页面中文版由中文 man 手册页计划提供。
.PP
翻译人员：金步国
.br
金步国作品集：http://www.jinbuguo.com
.br
.br
中文 man 手册页计划：\fBhttps://github.com/man-pages-zh/manpages-zh\fR