Cope with programs which set SIGCHLD to SIG_IGN. (We assume they don't manipulate...

[authbind.git] / authbind-helper.8

diff --git a/authbind-helper.8 b/authbind-helper.8
index 55c5e0593ca0155aef7d32e853e523942b375b0d..b9c25e8637da2c2636632219ee4db872955f37c4 100644 (file)
--- a/authbind-helper.8
+++ b/authbind-helper.8
@@ -17,14 +17,14 @@
 .\" along with this program; if not, write to the Free Software Foundation,
 .\" Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. 
 .\"
 .\" along with this program; if not, write to the Free Software Foundation,
 .\" Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. 
 .\"

-.\" $Id$
-.\"

 .TH AUTHBIND\-HELPER 8 "30th August 1998" "Debian Project" "Debian Linux manual"
 .br
 .SH NAME 
 authbind\-helper \- helper program to bind sockets to privileged ports without root
 .SH SYNOPSIS
 .TH AUTHBIND\-HELPER 8 "30th August 1998" "Debian Project" "Debian Linux manual"
 .br
 .SH NAME 
 authbind\-helper \- helper program to bind sockets to privileged ports without root
 .SH SYNOPSIS

-.BI /usr/lib/authbind/helper " addr\-hex port\-hex " < socket
+.BI /usr/lib/authbind/helper " addr4\-hex port\-hex " < socket
+.br
+.BI /usr/lib/authbind/helper " addr6\-hex port\-hex 6 " < socket

 .SH DESCRIPTION
 .B helper
 is the program used by
 .SH DESCRIPTION
 .B helper
 is the program used by


@@ -38,17 +38,30 @@ low-numbered ports in a controlled way.  See
 It may also be used standalone, i.e. without assistance from
 .BR authbind .
 Its standard input should be a TCP/IP socket, and it should be passed
 It may also be used standalone, i.e. without assistance from
 .BR authbind .
 Its standard input should be a TCP/IP socket, and it should be passed

-two arguments.
+two or three arguments.

 .PP
 The arguments are the address and port number, respectively, to which
 .PP
 The arguments are the address and port number, respectively, to which

-the caller desires that the socket be bound.  They should be hex
-strings,
+the caller desires that the socket be bound, and the address family
+(ommitted for IPv4; the fixed string
+.B 6
+for IPv6).
+.I addr4-hex
+and
+.I port-hex
+should be hex strings,

 .I without
 leading
 .BR 0x ,
 of exactly the right length (8 and 4 digits, respectively), being
 .I without
 leading
 .BR 0x ,
 of exactly the right length (8 and 4 digits, respectively), being

-a pairs of hex digits for each byte in the address or port number when
-expressed in network byte order.
+a pair of hex digits for each byte in the address or port number when
+expressed in host byte order.  For example, the port argument is the
+result of something like
+.B sprintf(arg,
+.B """%04X"",
+.BR sin.sin_port) .
+.I addr6-hex
+should be a string of 32 hex digits, being a pair for each byte in
+the address, in network byte order.

 .SH EXIT STATUS
 .B helper
 will exit with code 0 on success.
 .SH EXIT STATUS
 .B helper
 will exit with code 0 on success.


@@ -72,7 +85,7 @@ for details of the access control regime implemented by
 .SH AUTHOR
 .B authbind
 and this manpage were written by Ian Jackson.  They are
 .SH AUTHOR
 .B authbind
 and this manpage were written by Ian Jackson.  They are

-Copyright (C)1998
+Copyright (C)1998,2012

 by him and released under the GNU General Public Licence; there is NO
 WARRANTY.  See
 .B /usr/doc/authbind/copyright
 by him and released under the GNU General Public Licence; there is NO
 WARRANTY.  See
 .B /usr/doc/authbind/copyright