SYSTEMD-NOTIFY(1) | systemd-notify | SYSTEMD-NOTIFY(1) |
NAME
systemd-notify - 向 systemd 報告服務狀態的變化
SYNOPSIS
systemd-notify [OPTIONS...] [VARIABLE=VALUE...]
描述
systemd-notify 可用於 在守護程序指令碼中向 systemd 報告程序狀態的變化。 可用於傳送任意資訊, 其中最重要的是 報告"啟動已完成"的訊息。
此工具基本上就是對 sd_notify() 的簡單包裝, 以便於在指令碼中使用。詳見 sd_notify(3) 手冊。
注意,在報告狀態更新的同時, 還可以傳遞一系列環境變數。
注意, 除非在呼叫此命令的服務單元中設定了 NotifyAccess=all , 否則 systemd 將會拒絕接受狀態更新的訊息。
選項
能夠識別的命令列選項如下:
--ready
--pid=
--status=
--booted
-h, --help
--version
退出狀態
返回值為 0 表示成功, 非零返回值表示失敗程式碼。
例子
Example 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)
跋
本頁面中文版由中文 man 手冊頁計劃提供。
翻譯人員:金步國
金步國作品集:http://www.jinbuguo.com
中文 man
手冊頁計劃:https://github.com/man-pages-zh/manpages-zh
systemd 231 |