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
This commit is contained in:
Michal Koutný 2023-10-30 19:50:20 +01:00
parent 761791bcf8
commit 788b7e7630
2 changed files with 5 additions and 1 deletions

View file

@ -198,6 +198,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

@ -2941,7 +2941,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