X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemd.socket.xml;h=28c8dc456625b784a4582b534ce5f4a8ef1605b8;hp=78d379de92e587a59c7db467bab5cbd2d743289c;hb=a43757462acaffa902417a9876486763d0b7ed58;hpb=d9ff321ad9477664c34b81a9dd4fce616e44124e diff --git a/man/systemd.socket.xml b/man/systemd.socket.xml index 78d379de9..28c8dc456 100644 --- a/man/systemd.socket.xml +++ b/man/systemd.socket.xml @@ -113,6 +113,17 @@ Socket units may be used to implement on-demand starting of services, as well as parallelized starting of services. + + Note that the daemon software configured for + socket activation with socket units needs to be able + to accept sockets from systemd, either via systemd's + native socket passing interface (see + sd_listen_fds3 + for details) or via the traditional + inetd8-style + socket passing (i.e. sockets passed in via STDIN and + STDOUT, using StandardInput=socket + in the service file). @@ -207,6 +218,51 @@ directive above. + + ListenSpecial= + Specifies a special + file in the file system to listen + on. This expects an absolute file + system path as argument. Behaviour + otherwise is very similar to the + ListenFIFO= + directive above. Use this to open + character device nodes as well as + special files in + /proc and + /sys. + + + + ListenNetlink= + Specifies a Netlink + family to create a socket for to + listen on. This expects a short string + referring to the AF_NETLINK family + name (such as audit + or kobject-uevent) + as argument, optionally suffixed by a + whitespace followed by a multicast + group integer. Behaviour otherwise is + very similar to the + ListenDatagram= + directive above. + + + + ListenMessageQueue= + Specifies a POSIX + message queue name to listen on. This + expects a valid message queue name + (i.e. beginning with /). Behaviour + otherwise is very similar to the + ListenFIFO= + directive above. On Linux message + queue descriptors are actually file + descriptors and can be inherited + between processes. + + BindIPv6Only= Takes a one of @@ -420,6 +476,19 @@ for details. + + MessageQueueMaxMessages=, + MessageQueueMessageSize= + These two settings + take integer values and control the + mq_maxmsg resp. mq_msgsize field when + creating the message queue. Note that + either none or both of these variables + need to be set. See + mq_setattr3 + for details. + + FreeBind= Takes a boolean @@ -437,6 +506,24 @@ address. Defaults to . + + Transparent= + Takes a boolean + value. Controls the IP_TRANSPARENT + option. Defaults to + . + + + + Broadcast= + Takes a boolean + value. This controls the SO_BROADCAST + option, which allows broadcast + datagrams to be sent from this + socket. Defaults to + . + + TCPCongestion= Takes a string @@ -499,7 +586,7 @@ a time span value such as "5min 20s". Pass 0 to disable the timeout logic. Defaults to - 60s. + 90s. @@ -508,7 +595,6 @@ processes of this socket unit shall be killed. One of , - , , . @@ -519,6 +605,25 @@ for details. + + KillSignal= + Specifies which signal + to use when killing a process of this + socket. Defaults to SIGTERM. + + + + + SendSIGKILL= + Specifies whether to + send SIGKILL to remaining processes + after a timeout, if the normal + shutdown procedure left processes of + the socket around. Takes a boolean + value. Defaults to "yes". + + + Service= Specifies the service