listen

listen

Indicates Socket Descriptor is Ready to Accept Requests

Portability: UNIX compatible

SYNOPSIS
DESCRIPTION
RETURN VALUE
PORTABILITY
RELATED FUNCTIONS

SYNOPSIS

#include <sys/types.h>
#include <sys/socket.h>

int listen(int s, int backlog);

DESCRIPTION

listen indicates that the socket descriptor s is ready to accept incoming connection requests. backlog is an integer defining the maximum length of the queue of connection requests. The SOMAXCONN constant in the <socket.h> header file defines the maximum value for the backlog parameter. Currently, SOMAXCONN is 10 . The connections are accepted with accept . Servers typically use this call in preparation for service requests from clients.

RETURN VALUE

If listen succeeds, it returns a 0 . Otherwise, it returns a -1 , and sets errno to indicate the type of error.

PORTABILITY

listen is portable to other environments, including most UNIX systems, that implement BSD sockets.

RELATED FUNCTIONS

accept , bind , connect

Chapter Contents
Previous
Next
Top of Page