bindresvport_sa(3)
- NetBSD Manual Pages
BINDRESVPORT(3) NetBSD Library Functions Manual BINDRESVPORT(3)
NAME
bindresvport, bindresvport_sa -- bind a socket to a reserved privileged
IP port
LIBRARY
Standard C Library (libc, -lc)
SYNOPSIS
#include <sys/types.h>
#include <rpc/rpc.h>
int
bindresvport(int sd, struct sockaddr_in *sin);
int
bindresvport_sa(int sd, struct sockaddr *sa);
DESCRIPTION
bindresvport() and bindresvport_sa() are used to bind a socket descriptor
to a reserved privileged IP port, that is, a port number in the range
0-1023. The routine returns 0 if it is successful, otherwise -1 is
returned and errno set to reflect the cause of the error.
If sin is a pointer to a struct sockaddr_in then the appropriate fields
in the structure should be defined. Note that sin->sin_family must be
initialized to the address family of the socket, passed by sd. If
sin->sin_port is `0' then a port (in the range 600-1023) will be chosen,
and if bind(2) is successful, the sin->sin_port will be updated to con-
tain the allocated port.
If sin is the NULL pointer, a port will be allocated (as above). How-
ever, there is no way for bindresvport() to return the allocated port in
this case. getsockname(2) can be used to determine the assigned port.
Only root can bind to a privileged port; this call will fail for any
other users.
Function prototype of bindresvport() is biased to AF_INET socket.
bindresvport_sa() acts exactly the same, with more neutral function pro-
totype. Note that both functions behave exactly the same, and both sup-
port AF_INET6 sockets as well as AF_INET sockets.
RETURN VALUES
If the bind is successful, a 0 value is returned. A return value of -1
indicates an error, which is further specified in the global errno.
ERRORS
[EPFNOSUPPORT] If second argument was supplied, and address family
did not match between arguments.
bindresvport() may also fail and set errno for any of the errors speci-
fied for the calls bind(2), getsockopt(2), or setsockopt(2).
SEE ALSO
bind(2), getsockname(2), getsockopt(2), setsockopt(2), ip(4)
NetBSD 10.99 January 27, 2007 NetBSD 10.99
Powered by man-cgi (2024-03-20).
Maintained for NetBSD
by Kimmo Suominen.
Based on man-cgi by Panagiotis Christias.