diff options
| author | Daan De Meyer <daan.j.demeyer@gmail.com> | 2021-12-08 12:56:36 +0100 |
|---|---|---|
| committer | Luca Boccassi <luca.boccassi@gmail.com> | 2021-12-08 13:27:28 +0000 |
| commit | ecfa85e9e18e25887a6fdaaa9ec3e7aa0cba7f68 (patch) | |
| tree | 1317ef2ef0ad7c71263e2eb58ec2abf2d636edb7 /man/sd_notify.xml | |
| parent | 52e4ac691e4bacfc22242ca77acbf64b2e05dae1 (diff) | |
| download | systemd-ecfa85e9e18e25887a6fdaaa9ec3e7aa0cba7f68.tar.gz | |
docs: Clarify that the fd store is discarded when a service is stopped
Diffstat (limited to 'man/sd_notify.xml')
| -rw-r--r-- | man/sd_notify.xml | 5 |
1 files changed, 3 insertions, 2 deletions
diff --git a/man/sd_notify.xml b/man/sd_notify.xml index 69e1b024ad..4a0a7b34dc 100644 --- a/man/sd_notify.xml +++ b/man/sd_notify.xml @@ -218,7 +218,7 @@ <listitem><para>Stores additional file descriptors in the service manager. File descriptors sent this way will be maintained per-service by the service manager and will later be handed back using the usual file descriptor - passing logic at the next invocation of the service, see + passing logic at the next invocation of the service (e.g. when it is restarted), see <citerefentry><refentrytitle>sd_listen_fds</refentrytitle><manvolnum>3</manvolnum></citerefentry>. This is useful for implementing services that can restart after an explicit request or a crash without losing state. Any open sockets and other file descriptors which should not be closed during the restart may be stored @@ -232,7 +232,8 @@ <constant>EPOLLHUP</constant> or <constant>EPOLLERR</constant> event seen on them will result in their automatic removal from the store. Multiple arrays of file descriptors may be sent in separate messages, in which case the arrays are combined. Note that the service manager removes duplicate (pointing to the same - object) file descriptors before passing them to the service. Use <function>sd_pid_notify_with_fds()</function> + object) file descriptors before passing them to the service. When a service is stopped, its file descriptor + store is discarded and all file descriptors in it are closed. Use <function>sd_pid_notify_with_fds()</function> to send messages with <literal>FDSTORE=1</literal>, see below.</para></listitem> </varlistentry> |