From: Łukasz Stelmach <l.stelmach@samsung.com>
Date: Wed, 19 Jun 2013 12:59:02 +0000 (+0200)
Subject: Describe handling of an AF_UNIX socket
X-Git-Tag: v205~106
X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=commitdiff_plain;h=77f40f165cc60a1d6b8a3503e4b7e46814d5935e

Describe handling of an AF_UNIX socket

Describe how to handle an AF_UNIX socket, with Accept set to false,
received from systemd, upon exit.

Signed-off-by: Łukasz Stelmach <l.stelmach@samsung.com>
---

diff --git a/man/systemd.socket.xml b/man/systemd.socket.xml
index 6dc847df3..f1e7d408a 100644
--- a/man/systemd.socket.xml
+++ b/man/systemd.socket.xml
@@ -381,9 +381,15 @@
                                 performance reasons, it is recommended
                                 to write new daemons only in a way
                                 that is suitable for
-                                <option>Accept=false</option>. This
-                                option is mostly useful to allow
-                                daemons designed for usage with
+                                <option>Accept=false</option>. A daemon
+                                listening on an AF_UNIX socket may, but does not need to, call
+                                <citerefentry><refentrytitle>close</refentrytitle><manvolnum>2</manvolnum></citerefentry>
+                                or
+                                <citerefentry><refentrytitle>shutdown</refentrytitle><manvolnum>2</manvolnum></citerefentry>
+                                on the received socket before exiting. However,
+                                it must not unlink the socket from a
+                                filesystem. This option is mostly useful
+                                to allow daemons designed for usage with
                                 <citerefentry><refentrytitle>inetd</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
                                 to work unmodified with systemd socket
                                 activation.</para></listitem>