table of contents
other versions
- wheezy 3.44-1
- jessie 3.74-1
- jessie-backports 4.10-2~bpo8+1
- testing 4.10-2
- unstable 4.10-2
other languages
other sections
LISTEN(2) | Linux Programmer's Manual | LISTEN(2) |
NAME¶
listen - listen for connections on a socketSYNOPSIS¶
#include <sys/types.h> /* See NOTES */#include <sys/socket.h>int listen(int sockfd, int backlog);
DESCRIPTION¶
listen() marks the socket referred to by sockfd as a passive socket, that is, as a socket that will be used to accept incoming connection requests using accept(2).RETURN VALUE¶
On success, zero is returned. On error, -1 is returned, and errno is set appropriately.ERRORS¶
- EADDRINUSE
- Another socket is already listening on the same port.
- EBADF
- The argument sockfd is not a valid descriptor.
- ENOTSOCK
- The argument sockfd is not a socket.
- EOPNOTSUPP
- The socket is not of a type that supports the listen() operation.
CONFORMING TO¶
4.4BSD, POSIX.1-2001. The listen() function call first appeared in 4.2BSD.NOTES¶
To accept connections, the following steps are performed:- 1.
- A socket is created with socket(2).
- 2.
- The socket is bound to a local address using bind(2), so that other sockets may be connect(2)ed to it.
- 3.
- A willingness to accept incoming connections and a queue limit for incoming connections are specified with listen().
- 4.
- Connections are accepted with accept(2).
EXAMPLE¶
See bind(2).SEE ALSO¶
accept(2), bind(2), connect(2), socket(2), socket(7)COLOPHON¶
This page is part of release 3.44 of the Linux man-pages project. A description of the project, and information about reporting bugs, can be found at http://www.kernel.org/doc/man-pages/.2008-11-20 | Linux |