Listens for connections on a specified socket.


#include <prio.h> 

PRStatus PR_Listen(
  PRFileDesc *fd, 
  PRIntn backlog);


The function has the following parameters:

A pointer to a PRFileDesc object representing a socket that will be used to listen for new connections.
The maximum length of the queue of pending connections.


The function returns one of the following values:

  • Upon successful completion of listen request, PR_SUCCESS.
  • If unsuccessful, 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.

Document Tags and Contributors

Contributors to this page: wbamberg, mdnwebdocs-bot, teoli, alecananian
Last updated by: wbamberg,