pSOSystem System Calls - Read

accept pNA+ System Calls
accept Accepts a connection on a socket.
#include
long accept(
int s, /* socket descriptor */
struct sockaddr_in *addr, /* socket structure */
int *addrlen /* socket structure size */
)
Description
Arguments
This call is used to accept a connection request that the specified socket receives
from a foreign socket. Servers use accept() with connection-oriented or stream
(TCP) sockets.
Before accept() is called, the socket must be set up to receive a connection
request by issuing the listen() system call. accept() extracts the first
connection request on the queue of pending connections; creates a new socket with
the same properties as the original socket; completes the connection between the
foreign socket and the new socket; and returns a descriptor for the new socket. The
new returned socket descriptor is used to read from and write data to the foreign
socket. It is not used to accept more connections. The original socket remains open
for accepting further connections.
If no pending connections exist on the queue and the socket is not marked as nonblocking,
accept() blocks the caller until a connection is present. If the socket is
marked non-blocking and no pending connections are present on the queue,
accept() returns an error.
Upon return, accept() stores the address of the connected socket in the specified
socket address structure.
s Specifies the socket on which to accept a connection request.
4-2 pSOSystem System Calls