Index for Section 3

Alphabetical listing for R

Bottom of page

rresvport(3)
NAME
  rresvport - Retrieves a socket with a privileged address

LIBRARY
  Standard C Library (libc.a)

SYNOPSIS
  #include <unistd.h>
  int rresvport (
	  int *port );

PARAMETERS
  port	    Specifies the port to use for the connection.

DESCRIPTION
  The rresvport() 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()
  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 is returned to the calling process.

RETURN VALUES
  Upon successful completion, the rresvport() 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() function fails, errno may be set to one of the following
  values:

  [EAGAIN]  All network ports are in use.

  [EAFNOSUPPORT]
	    The addresses in the specified address family cannot be used with
	    this socket.



  [EMFILE]  Two hundred (200) file descriptors are currently open.

  [ENFILE]  The system file table is full.

  ENOBUFS   Insufficient buffers are available in the system to complete the
	    function.



FILES
  /etc/services
	    Contains the service names.

RELATED INFORMATION
  Functions: rcmd(3), ruserok(3)

Index for Section 3

Alphabetical listing for R

Top of page