diff options
| author | Kenny Levinsen <kl@kl.wtf> | 2020-04-08 20:19:30 +0200 |
|---|---|---|
| committer | Kenny Levinsen <kl@kl.wtf> | 2020-04-30 19:42:26 +0200 |
| commit | cb5a46b84504006196e4415266c1a6414c07c9b3 (patch) | |
| tree | aef16cbee4a79b4c5f570fa21a8f1f72e493811c /man/sd_notify.xml | |
| parent | notify: beef up --pid= logic (diff) | |
| download | systemd-cb5a46b84504006196e4415266c1a6414c07c9b3.tar.xz systemd-cb5a46b84504006196e4415266c1a6414c07c9b3.zip | |
core: Add optional FDPOLL=0 argument to fdstore
A service can specify FDSTORE=1 FDPOLL=0 to request that PID1 does not
poll the fd to remove them on error. If set, fds will only be removed on
FDSTOREREMOVE=1 or when the service is done.
Fixes: #12086
Diffstat (limited to 'man/sd_notify.xml')
| -rw-r--r-- | man/sd_notify.xml | 14 |
1 files changed, 12 insertions, 2 deletions
diff --git a/man/sd_notify.xml b/man/sd_notify.xml index 3046ca88ee..0157ce864a 100644 --- a/man/sd_notify.xml +++ b/man/sd_notify.xml @@ -219,8 +219,8 @@ in a <citerefentry><refentrytitle>memfd_create</refentrytitle><manvolnum>2</manvolnum></citerefentry> memory file descriptor. Note that the service manager will accept messages for a service only if its <varname>FileDescriptorStoreMax=</varname> setting is non-zero (defaults to zero, see - <citerefentry><refentrytitle>systemd.service</refentrytitle><manvolnum>5</manvolnum></citerefentry>). If file - descriptors sent are pollable (see + <citerefentry><refentrytitle>systemd.service</refentrytitle><manvolnum>5</manvolnum></citerefentry>). If + <varname>FDPOLL=0</varname> is not set and the file descriptors sent are pollable (see <citerefentry><refentrytitle>epoll_ctl</refentrytitle><manvolnum>2</manvolnum></citerefentry>), then any <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 @@ -251,6 +251,16 @@ submitted name does not follow these restrictions, it is ignored.</para></listitem> </varlistentry> + <varlistentry> + <term>FDPOLL=0</term> + + <listitem><para>When used in combination with <varname>FDSTORE=1</varname>, disables polling of the stored + file descriptors regardless of whether or not they are pollable. As this option disables automatic cleanup + of the stored file descriptors on EPOLLERR and EPOLLHUP, care must be taken to ensure proper manual cleanup. + Use of this option is not generally recommended except for when automatic cleanup has unwanted behavior such + as prematurely discarding file descriptors from the store.</para></listitem> + </varlistentry> + </variablelist> <para>It is recommended to prefix variable names that are not |