]> git.ipfire.org Git - thirdparty/systemd.git/commit
man/sd_notify: change recommendations about unsupported notifications
authorZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>
Fri, 15 Sep 2023 06:58:46 +0000 (08:58 +0200)
committerZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>
Fri, 15 Sep 2023 07:00:23 +0000 (09:00 +0200)
commitbb8a3296e8837c8dbc8f0ccc5e5fc735de73ad50
treec3bf95e5f9fd6f71983dae8f2d02da9c85217f0a
parent67da7e9a4f4b1e488567cc1aa0f94c57afb17320
man/sd_notify: change recommendations about unsupported notifications

In principle, arbitrary notifications may be sent via sd_notify. But in
practice, this is not useful at all, since the manager only accepts
notifications from services and ignores anything except a few specific
ones. The others will be logged if debugging is enabled. OTOH, the manager
produces EXIT_STATUS, but nothing in systemd looks at it, which is rather
confusing.

So remove the recommendation to use X_ prefixes, and instead say that other
messages will be ignored. Also, mention that mkosi uses this. Having an example
may be useful to understand what is going on.

Strangely, this is the first reference to mkosi in our man pages. Even more
strangely, debian is the only place which hosts the mkosi man page (among
the sites we have definitions for), so I linked to that version.
man/sd_notify.xml