Listens for connections on a specified socket.
The function returns one of the following values:
PR_SUCCESS
.
PR_FAILURE
. Further information can be obtained by calling PR_GetError
.
PR_Listen
turns the specified socket into a rendezvous socket. It creates a queue for pending connections and starts to listen for connection requests on the socket. The maximum size of the queue for pending connections is specified by the backlog
parameter. Pending connections may be accepted by calling PR_Accept
.