Join MDN and developers like you at Mozilla's View Source conference, 12-14 September in Berlin, Germany. Learn more at https://viewsourceconf.org

PR_Listen

Listens for connections on a specified socket.

Syntax

#include <prio.h> 

PRStatus PR_Listen(
  PRFileDesc *fd, 
  PRIntn backlog);

Parameters

The function has the following parameters:

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

Returns

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.

Description

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: teoli, Rappo
 Last updated by: teoli,