返回介绍

systemd-notify 中文手册

发布于 2020-11-08 09:27:18 字数 3631 浏览 1329 评论 0 收藏 0

名称

systemd-notify — 向 systemd 报告服务状态的变化

大纲

systemd-notify [OPTIONS...] [VARIABLE=VALUE...]

描述

systemd-notify 可用于在守护进程脚本中向 systemd 报告进程状态的变化。可用于发送任意信息,其中最重要的是报告"启动已完成"的消息。

此工具基本上就是对sd_notify() 的简单包装,以便于在脚本中使用。详见sd_notify(3) 手册。

注意,在报告状态更新的同时,还可以传递一系列环境变量。

注意,在默认情况下(也就是调用此命令的服务单元含有 NotifyAccess=none), systemd 并不从此命令接受状态更新消息。

注意,服务单元的 sd_notify() 通知能够正常工作的前提,是必须满足如下两个条件之一:(1)在 PID=1 的进程处理通知消息时,发送该通知的进程依然在运行;(2)发送该通知的进程是 systemd 派生的子进程(也就是匹配 NotifyAccess=mainNotifyAccess=exec 的进程)。如果服务单元中的某个辅助进程在发送了 sd_notify() 通知之后就立即退出了,那么 systemd 将有可能来不及将该通知关联到这个服务单元上。在这种情况下,即使明确设置了 NotifyAccess=all ,该通知也可能会被忽略掉。

systemd-notify 会首先尝试以调用进程的PID来调用 sd_notify() (此操作仅在确实拥有足够权限的情况下才会成功),如果失败,将会使用其自身的PID再次调用 sd_notify() 。这种做法对于从 shell 脚本中调用 systemd-notify 命令非常有用,特别是当服务的主进程是 shell 的时候(由于 NotifyAccess=all 的限制),因为在这种情况下,shell 进程(而不是 systemd-notify 进程)将成为消息的发送者。

选项

能够识别的命令行选项如下:

--ready

向 systemd 报告"启动已完成"的消息。这等价于 systemd-notify READY=1 。详见 sd_notify(3) 手册。

--pid=

向 systemd 报告主守护进程的 PID 。如果 PID 参数被省略,将使用调用 systemd-notify 的进程的 PID 。这等价于 systemd-notify MAINPID=$PID 。详见 sd_notify(3) 手册。

--uid=USER

向 systemd 报告此消息来自哪个用户,也就是使用指定的 USER 取代调用此命令的用户,作为此通知消息的发送者。USER 既可以是一个UID数值也可以是一个用户名字符串。此选项需要足够的权限才能操作进程的用户标识。

--status=

向 systemd 发送一个任意内容的字符串消息。这等价于 systemd-notify STATUS=… 。详见 sd_notify(3) 手册。

--booted

用于检查系统的 init 进程是否为 systemd ,返回 0 表示系统的 init 进程是 systemd ,返回非零表示其他。此选项并不发送任何消息,因此与其他选项没有任何关系。详见 sd_booted(3) 手册。另一种检查方法是 systemctl(1)is-system-running 命令。若返回 "offline" 则表示 系统的 init 进程不是 systemd

-h, --help

显示简短的帮助信息并退出。

--version

显示简短的版本信息并退出。

退出状态

返回值为 0 表示成功,非零返回值表示失败代码。

例子

例 1. 启动通知与状态更新

一个简单的守护进程脚本,在创建好通信管道之后,向 systemd 报告"启动已完成"的消息。在运行时,向 systemd 报告更多的状态消息:

#!/bin/bash

mkfifo /tmp/waldo
systemd-notify --ready --status="Waiting for data…"

while : ; do  read a < /tmp/waldo  systemd-notify --status="Processing $a"
  # Do something with $a …
  systemd-notify --status="Waiting for data…"
done

参见

systemd(1),systemctl(1),systemd.unit(5),sd_notify(3),sd_booted(3)

如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。

扫码二维码加入Web技术交流群

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。
列表为空,暂无数据
    我们使用 Cookies 和其他技术来定制您的体验包括您的登录状态等。通过阅读我们的 隐私政策 了解更多相关信息。 单击 接受 或继续使用网站,即表示您同意使用 Cookies 和您的相关数据。
    原文