NAME    [Toc]    [Back]

       rresvport_af - Retrieve a socket with a privileged address

SYNOPSIS    [Toc]    [Back]

       #include <unistd.h>

       int rresvport_af(
               int *port,
               int family );

LIBRARY    [Toc]    [Back]

       Standard C Library (libc)

PARAMETERS    [Toc]    [Back]

       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    [Toc]    [Back]

       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 numbers 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    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       Contains the service names.

SEE ALSO    [Toc]    [Back]

       Functions: rcmd(3), ruserok(3)



                                                  rresvport_af(3)