man/man2/listen.2

   1 .TH LISTEN 2
   2 .SH NAME
   3 listen \- listens for incoming connections on a socket
   4 .SH SYNOPSIS
   5 .ft B
   6 #include <sys/socket.h>
   7
   8 .in +5
   9 .ti -5
  10 int listen(int \fIsd\fP, int \fIbacklog\fP);
  11 .br
  12 .ft P
  13 .SH DESCRIPTION
  14 listen() puts socket \fIsd\fP into the listening state.
  15 \fIbacklog\fP number of incoming connections may be
  16 queued before new incoming connections are refused.
  17 This function is usually called after bind(2) and before
  18 accept(2).
  19 .SH RETURN VALUES
  20 On success, this function returns 0. On error, -1 is returned and
  21 \fIerrno\fP is set.
  22 .SH ERRORS
  23 .TP 15
  24 [EINVAL]
  25 The socket is invalid or bind(2) has not been called yet
  26 for the socket.
  27 .TP 15
  28 [EOPNOTSUPP]
  29 The socket type (example SOCK_DGRAM) does not support listening.
  30 .TP 15
  31 [ENOSYS]
  32 The socket does not support listening.
  33 .SH SEE ALSO
  34 .BR accept(2),
  35 .BR bind(2),
  36 .BR socket(2)