1 .\" Hey, Emacs! This is an -*- nroff -*- source file.
2 .\" Authors: Ian Jackson
4 .\" authbind is Copyright (C) 1998 Ian Jackson
6 .\" This program is free software; you can redistribute it and/or modify
7 .\" it under the terms of the GNU General Public License as published by
8 .\" the Free Software Foundation; either version 2, or (at your option)
11 .\" This program is distributed in the hope that it will be useful,
12 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
13 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 .\" GNU General Public License for more details.
16 .\" You should have received a copy of the GNU General Public License
17 .\" along with this program; if not, write to the Free Software Foundation,
18 .\" Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
20 .TH AUTHBIND\-HELPER 8 "30th August 1998" "Debian Project" "Debian Linux manual"
23 authbind\-helper \- helper program to bind sockets to privileged ports without root
25 .BI /usr/lib/authbind/helper " addr4\-hex port\-hex " < socket
27 .BI /usr/lib/authbind/helper " addr6\-hex port\-hex 6 " < socket
30 is the program used by
32 which is in turn used by
34 to allow programs which do not or should not run as root to bind to
35 low-numbered ports in a controlled way. See
38 It may also be used standalone, i.e. without assistance from
40 Its standard input should be a TCP/IP socket, and it should be passed
41 two or three arguments.
43 The arguments are the address and port number, respectively, to which
44 the caller desires that the socket be bound, and the address family
45 (ommitted for IPv4; the fixed string
51 should be hex strings,
55 of exactly the right length (8 and 4 digits, respectively), being
56 a pair of hex digits for each byte in the address or port number when
57 expressed in host byte order. For example, the port argument is the
58 result of something like
63 should be a string of 32 hex digits, being a pair for each byte in
64 the address, in network byte order.
67 will exit with code 0 on success.
71 will return an appropriate
73 value as its exit status. If this is not possible it may exit with
74 status 255 or with an exit status corresponding to
76 .RI ( "Function not implemented" ).
80 for details of the access control regime implemented by
87 and this manpage were written by Ian Jackson. They are
88 Copyright (C)1998,2012
89 by him and released under the GNU General Public Licence; there is NO
91 .B /usr/doc/authbind/copyright
93 .B /usr/doc/copyright/GPL