1
1
mirror of https://github.com/systemd/systemd-stable.git synced 2025-03-12 08:58:20 +03:00

man: Add remarks about StandardInput=socket and sd_listen_fds()

It confuses users when they cannot find respective environment variables
with config that is supposes for (x)inetd activated service only.

Fix: #29670
(cherry picked from commit 788b7e7630669a47c54c6f3299af14db26ca7fe0)
(cherry picked from commit 136dc1c818aab93301032664931765f6285d0ba8)
This commit is contained in:
Michal Koutný 2023-10-30 19:50:20 +01:00 committed by Luca Boccassi
parent 09fac9bc90
commit 147ad7d0a3
2 changed files with 5 additions and 1 deletions

View File

@ -194,6 +194,9 @@
number. <function>sd_listen_fds_with_names()</function> does the
same but also parses <varname>$LISTEN_FDNAMES</varname> if
set.</para>
<para>These functions are not designed for services that specify <varname>StandardInput=socket</varname>
as the <varname>$LISTEN_FDS</varname> variable is not set in their environment.</para>
</refsect1>
<refsect1>

View File

@ -2708,7 +2708,8 @@ SystemCallErrorNumber=EPERM</programlisting>
input will be connected to the socket the service was activated from, which is primarily useful for
compatibility with daemons designed for use with the traditional <citerefentry
project='freebsd'><refentrytitle>inetd</refentrytitle><manvolnum>8</manvolnum></citerefentry> socket activation
daemon.</para>
daemon (<varname>$LISTEN_FDS</varname> (and related) environment variables are not passed when
<option>socket</option> value is configured).</para>
<para>The <option>fd:<replaceable>name</replaceable></option> option connects standard input to a specific,
named file descriptor provided by a socket unit. The name may be specified as part of this option, following a