From e9be34c9b798141dd6c224cf33934904935c49b2 Mon Sep 17 00:00:00 2001 From: Laurent Bercot Date: Wed, 7 Jan 2015 19:01:26 +0000 Subject: Complete conversion of s6-ipcserver and s6-tcpserver (4 and 6) to socketbinder + d model. With documentation (!) --- doc/s6-tcpserver6-socketbinder.html | 70 +++++++++++++++++++++++++++++++++++++ 1 file changed, 70 insertions(+) create mode 100644 doc/s6-tcpserver6-socketbinder.html (limited to 'doc/s6-tcpserver6-socketbinder.html') diff --git a/doc/s6-tcpserver6-socketbinder.html b/doc/s6-tcpserver6-socketbinder.html new file mode 100644 index 0000000..0c0f8ee --- /dev/null +++ b/doc/s6-tcpserver6-socketbinder.html @@ -0,0 +1,70 @@ + + + + + s6-networking: the s6-tcpserver6-socketbinder program + + + + + + +

+ +

The `s6-tcpserver6-socketbinder` program

+ +

+s6-tcpserver6-socketbinder binds an INET domain +socket to an IPv6 address and port, then executes a program. +

+ +

Interface

+ +

+     s6-tcpserver6-socketbinder [ -d | -D ] [ -b backlog ] ip port prog...
+

+ +

s6-tcpserver6-socketbinder creates an TCP socket +and binds it to IPv6 address ip, port port. +It prepares the socket to accept connections by calling +listen().
It then execs into prog... with the open socket +as its standard input.

Options

-d : allow instant rebinding to the same IP and port +even if it has been used not long ago - this is the SO_REUSEADDR flag to +setsockopt() +and is generally used with server programs. This is the default.
-D : disallow instant rebinding to the same path.
-b backlog : set a maximum of +backlog backlog connections on the socket. Extra +connection attempts will rejected by the kernel.

Notes

s6-tcpserver6-socketbinder is part of a set of basic blocks used to +build a flexible TCP/IPv6 super-server. It normally should be given a +command line crafted to make it execute into +s6-tcpserver6d to accept connections +from clients, or into a program such as +s6-applyuidgid +to drop privileges before doing so.
The s6-tcpserver6 program does +exactly this. It implements +a full TCP/IPv6 super-server by building a command line starting with +s6-tcpserver6-socketbinder and ending with s6-tcpserver6d followed by the +application program, and executing into it.

The s6-tcpserver6-socketbinder program

Interface

Options

Notes

The `s6-tcpserver6-socketbinder` program