37 lines
833 B
Groff
37 lines
833 B
Groff
|
.TH LISTEN 2
|
||
|
|
.SH NAME
|
||
|
|
listen \- listens for incoming connections on a socket
|
||
|
|
.SH SYNOPSIS
|
||
|
|
.ft B
|
||
|
|
#include <sys/socket.h>
|
||
|
|
|
||
|
|
.in +5
|
||
|
|
.ti -5
|
||
|
|
int listen(int \fIsd\fP, int \fIbacklog\fP);
|
||
|
|
.br
|
||
|
|
.ft P
|
||
|
|
.SH DESCRIPTION
|
||
|
|
listen() puts socket \fIsd\fP into the listening state.
|
||
|
|
\fIbacklog\fP number of incoming connections may be
|
||
|
|
queued before new incoming connections are refused.
|
||
|
|
This function is usually called after bind(2) and before
|
||
|
|
accept(2).
|
||
|
|
.SH RETURN VALUES
|
||
|
|
On success, this function returns 0. On error, -1 is returned and
|
||
|
|
\fIerrno\fP is set.
|
||
|
|
.SH ERRORS
|
||
|
|
.TP 15
|
||
|
|
[EINVAL]
|
||
|
|
The socket is invalid or bind(2) has not been called yet
|
||
|
|
for the socket.
|
||
|
|
.TP 15
|
||
|
|
[EOPNOTSUPP]
|
||
|
|
The socket type (example SOCK_DGRAM) does not support listening.
|
||
|
|
.TP 15
|
||
|
|
[ENOSYS]
|
||
|
|
The socket does not support listening.
|
||
|
|
.SH SEE ALSO
|
||
|
|
.BR accept(2),
|
||
|
|
.BR bind(2),
|
||
|
|
.BR socket(2)
|