1.2.1.2.61 listen Function

int listen(
    SOCKET s, 
    int backlog
);

This function sets the specified socket in a listen mode. Calling the listen function indicates that the application is ready to accept connection requests arriving at a socket of type SOCK_STREAM. The connection request is queued (if possible) until accepted with an accept function. The backlog parameter defines the maximum number of pending connections that may be queued.

bind() must have been called on the s socket first.

|Parameters |Description | |s |Socket identifier returned from a prior socket() call. | |backlog |Maximum number of connection requests that can be queued. Note that each backlog requires a TCP socket to be allocated. |

• 0 - The function was successful.

• SOCKET_ERROR (-1) - Function failed. errno is set accordingly.

None.