authbind-helper (8)
Leading comments
Hey, Emacs! This is an source file. Authors: Ian Jackson authbind is Copyright (C) 1998 Ian Jackson This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICU...
NAME
authbind-helper - helper program to bind sockets to privileged ports without rootSYNOPSIS
/usr/lib/authbind/helper addr4-hex port-hex <socket/usr/lib/authbind/helper addr6-hex port-hex 6 <socket
DESCRIPTION
helper is the program used by libauthbind, which is in turn used by authbind to allow programs which do not or should not run as root to bind to low-numbered ports in a controlled way. See authbind(1).It may also be used standalone, i.e. without assistance from authbind. Its standard input should be a TCP/IP socket, and it should be passed two or three arguments.
The arguments are the address and port number, respectively, to which the caller desires that the socket be bound, and the address family (ommitted for IPv4; the fixed string 6 for IPv6). addr4-hex and port-hex should be hex strings, without leading 0x, of exactly the right length (8 and 4 digits, respectively), being 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 sprintf(arg, %04X, sin.sin_port). addr6-hex should be a string of 32 hex digits, being a pair for each byte in the address, in network byte order.
EXIT STATUS
helper will exit with code 0 on success.If possible, helper will return an appropriate errno value as its exit status. If this is not possible it may exit with status 255 or with an exit status corresponding to ENOSYS (Function not implemented).