osf1 man page for rresvport_af

Query: rresvport_af

OS: osf1

Section: 3

Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar

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)
Related Man Pages
ruserok(3socket) - opensolaris
rresvport(3) - osf1
rcmd_af(3socket) - sunos
ruserok(3socket) - sunos
rresvport_af(3socket) - opensolaris
Similar Topics in the Unix Linux Community
Non-root user access to privileged ports-Solaris 8
Why people are not concerned about security on Internet Social tools?
Get process id and port from the socket
Privileged port