rresvport_af(3) 					     Library Functions Manual						   rresvport_af(3)

NAME

       rresvport_af - Retrieves a socket with a privileged address

LIBRARY

       Standard C Library (libc.a)

SYNOPSIS

       #include <unistd.h>
       int rresvport_af (      int *port,      int family );

PARAMETERS

       Specifies  the port to use for the connection.  Specifies the address family for the socket to be created.  Valid values are AF_INET (IPv4)
       and AF_INET6 (IPv6).

DESCRIPTION

       The rresvport_af() function obtains a socket with a privileged address bound to the socket.  A privileged Internet port is one  that  falls
       in the range of 0 to 1023.

       Only  processes	with an effective user ID of root can use the rresvport_af() function.	An authentication scheme based on remote port num-
       bers is used to verify permissions.

       If the connection succeeds, a socket in the Internet domain of type SOCK_STREAM for the specified address family is returned to the calling
       process.

RETURN VALUES

       Upon successful completion, the rresvport_af() function returns a valid, bound socket descriptor.  Otherwise, a value of -1 is returned and
       errno is set to indicate the error.

ERRORS

       If the rresvport_af() function fails, errno may be set to one of the following values: All network ports are in use.  The addresses in  the
       specified address family cannot be used with this socket.  Two hundred (200) file descriptors are currently open.  The system file table is
       full.  Insufficient buffers are available in the system to complete the function.

FILES

       Contains the service names.

RELATED INFORMATION

       Functions: rcmd(3), ruserok(3) delim off

																   rresvport_af(3)