next up previous contents index
Next: 8.2.7 getsockname: get socket Up: 8.2 oskit_socket: Socket Interface Previous: 8.2.5 shutdown: shut down

8.2.6 listen: listen for connections on a socket

 

SYNOPSIS

#include <oskit/net/socket.h>

oskit_error_t oskit_socket_listen(oskit_socket_t *s, oskit_u32_t backlog);

DESCRIPTION

A willingness to accept incoming connections and a queue limit for incoming connections are specified with listen, and then the connections are accepted with accept. The listen call applies only to sockets of type OSKIT_SOCK_STREAM or OSKIT_SOCK_SEQPACKET.

The backlog parameter defines the maximum length the queue of pending connections may grow to. If a connection request arrives with the queue full the client may receive an error with an indication of connection refused, or, if the underlying protocol supports retransmission, the request may be ignored so that retries may succeed.

PARAMETERS

s
The socket where connections will be accepted.

backlog
Maximum number of pending connections.

RETURNS

Returns 0 on success, or an error code specified in <oskit/error.h>, on error.



University of Utah Flux Research Group