socket_listen(3) [debian man page]

socket_listen(3)					     Library Functions Manual						  socket_listen(3)

NAME

       socket_listen - attempt to make a TCP connection

SYNTAX

       #include <socket.h>

       int socket_listen(int s,int n);

DESCRIPTION

       socket_listen prepares TCP socket s to accept TCP connections.  It allows a backlog of approximately n TCP SYNs. (On systems supporting SYN
       cookies, the backlog is irrelevant.) Normally socket_listen returns 0.

       If anything goes wrong, socket_listen returns -1, setting errno appropriately.

EXAMPLE

	 #include <socket.h>

	 int s;
	 char ip[16];
	 uint16 p;

	 if ((s=socket_tcp6())==-1)
	   strerr_die2sys(111,FATAL,"unable to create TCP socket: ");
	 if (socket_bind6_reuse(s,(char *)V6any,8002,0) == -1)
	   strerr_die2sys(111,FATAL,"unable to bind: ");
	 if (socket_listen(s,1) == -1)
	   strerr_die2sys(111,FATAL,"unable to listen: ");

SEE ALSO

       socket_connect4(3), socket_connect6(3)

																  socket_listen(3)

SOCKET_BIND(3)								 1							    SOCKET_BIND(3)

socket_bind - Binds a name to a socket

SYNOPSIS

       bool socket_bind (resource  $socket, string  $address, [int  $port])

DESCRIPTION

	Binds  the  name  given  in  $address  to the socket described by $socket. This has to be done before a connection is be established using
       socket_connect(3) or socket_listen(3).

PARAMETERS

	      o $socket
		- A valid socket resource created with socket_create(3).

	      o $address
		- If the socket is of the AF_INET family, the $address is an IP in dotted-quad notation (e.g.  127.0.0.1).  If the  socket  is	of
		the AF_UNIX family, the $address is the path of a Unix-domain socket (e.g.  /tmp/my.sock).

	      o $port (Optional)
		- The $port parameter is only used when binding an AF_INET socket, and designates the port on which to listen for connections.

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

	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.

EXAMPLES

       Example #1

	      Using socket_bind(3) to set the source address

	      <?php
	      // Create a new socket
	      $sock = socket_create(AF_INET, SOCK_STREAM, SOL_TCP);

	      // An example list of IP addresses owned by the computer
	      $sourceips['kevin']    = '127.0.0.1';
	      $sourceips['madcoder'] = '127.0.0.2';

	      // Bind the source address
	      socket_bind($sock, $sourceips['madcoder']);

	      // Connect to destination address
	      socket_connect($sock, '127.0.0.1', 80);

	      // Write
	      $request = 'GET / HTTP/1.1' . "
" .
			 'Host: example.com' . "

";
	      socket_write($sock, $request);

	      // Close
	      socket_close($sock);

	      ?>

NOTES

       Note

	       This function must be used on the socket before socket_connect(3).

       Note

	       Windows 9x/ME compatibility note: socket_last_error(3) may return an invalid error code if trying to bind the  socket  to  a  wrong
	      address that does not belong to your machine.

SEE ALSO

       socket_connect(3), socket_listen(3), socket_create(3), socket_last_error(3), socket_strerror(3).

PHP Documentation Group 													    SOCKET_BIND(3)