socket_create_listen(3) [php man page]

SOCKET_CREATE_LISTEN(3) 						 1						   SOCKET_CREATE_LISTEN(3)

socket_create_listen - Opens a socket on port to accept connections

SYNOPSIS

       resource socket_create_listen (int  $port, [int	$backlog = 128])

DESCRIPTION

       socket_create_listen(3)	creates  a new socket resource of type AF_INET listening on all local interfaces on the given port waiting for new
       connections.

	This function is meant to ease the task of creating a new socket which only listens to accept new connections.

PARAMETERS

	      o $port
		- The port on which to listen on all interfaces.

	      o $backlog
		- The $backlog parameter defines the maximum length the queue of pending connections may grow to.   SOMAXCONN  may  be	passed	as
		$backlog parameter, see socket_listen(3) for more information.

RETURN VALUES

       socket_create_listen(3)	 returns  a  new  socket  resource  on	success  or  FALSE  on	error.	The  error  code  can  be  retrieved  with
       socket_last_error(3). This code may be passed to socket_strerror(3) to get a textual explanation of the error.

NOTES

       Note

	       If you want to create a socket which only listens on a certain interface you  need  to  use  socket_create(3),  socket_bind(3)  and
	      socket_listen(3).

SEE ALSO

       socket_create(3), socket_create_pair(3), socket_bind(3), socket_listen(3), socket_last_error(3), socket_strerror(3).

PHP Documentation Group 												   SOCKET_CREATE_LISTEN(3)

listen(3SOCKET) 					     Sockets Library Functions						   listen(3SOCKET)

NAME

       listen - listen for connections on a socket

SYNOPSIS

       cc [ flag ... ] file ... -lsocket -lnsl [ library ... ]
       #include <sys/types.h>
       #include <sys/socket.h>

       int listen(int s, int backlog);

DESCRIPTION

       To  accept  connections, a socket is first created with	socket(3SOCKET), a backlog for incoming connections is specified with listen() and
       then the connections are accepted with  accept(3SOCKET).  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 for  AF_UNIX sock-
       ets.  If  the  underlying protocol supports retransmission,  the connection request may be ignored so that retries may succeed. For AF_INET
       and AF_INET6sockets, the TCP will retry the connection. If the  backlog is not cleared by the time the tcp times out, the connect will fail
       with ETIMEDOUT.

RETURN VALUES

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

ERRORS

       The call fails if:

       EBADF		       The argument s is not a valid file descriptor.

       ENOTSOCK 	       The argument s is not a socket.

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

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       accept(3SOCKET), connect(3SOCKET), socket(3SOCKET), attributes(5), socket.h(3HEAD)

NOTES

       There is currently no backlog limit.

SunOS 5.10							    8 Nov 1999							   listen(3SOCKET)