listen(3N)							    listen(3N)

NAME    [Toc]    [Back]

     listen - listen for connections on	a socket

SYNOPSIS    [Toc]    [Back]

     int listen(int s, int backlog);

DESCRIPTION    [Toc]    [Back]

     To	accept connections, a socket is	first created with socket, a backlog
     for incoming connections is specified with	listen and then	the
     connections are accepted with accept.  The	listen call applies only to
     sockets of	type SOCK_STREAM or SOCK_SEQPACKET.

     The backlog parameter defines the maximum length the queue	of pending
     connections may grow to.  If a connection request arrives with the	queue
     full, the client will receive an error with an indication of
     ECONNREFUSED.

RETURN VALUE    [Toc]    [Back]

     A 0 return	value indicates	success; -1 indicates an error.

ERRORS    [Toc]    [Back]

     The call fails if:

     EBADF		 The argument s	is not a valid descriptor.

     ENOTSOCK		 The argument s	is not a socket.

     EOPNOTSUPP		 The socket is not of a	type that supports the
			 operation listen.

NOTES    [Toc]    [Back]

     There is currently	no backlog limit.


									PPPPaaaaggggeeee 1111