LISTEN(2)

NOMBRE
listen - espera conexiones en un zócalo

SINOPSIS
#include <sys/socket.h>

int listen(int s, int backlog);

DESCRIPCIÓN
Para aceptar conexiones, primero se crea un zócalo con socket(2), luego se especifica con listen el deseo de aceptar conexiones entrantes, y un límite de la cola para dichas conexiones, y por último las conexiones son aceptadas mediante accept(2). La llamada listen se aplica solamente a zócalos de tipo SOCK_STREAM o SOCK_SEQPACKET. El parámetro backlog define la longitud máxima a la que puede llegar la cola de conexiones pendientes. Si una petición de conexión llega estando la cola llena, el cliente puede recibir un error con una indicación de ECONNREFUSED, o, si el protocolo subyacente acepta retransmisiones, la petición puede no ser tenida en cuenta, de forma que un reintento pueda llegar a tener éxito.

VALOR DEVUELTO
En caso de éxito, se devuelve cero. En caso de error, se devuelve -1 y se pone en errno un valor apropiado.

ERRORS

EBADF
    El argumento s no es un descriptor válido.

ENOTSOCK
    El argumento s no es un zócalo.

EOPNOTSUPP
    El zócalo no es de un tipo que admita la operación listen.

CONFORME CON
SVr4, 4.4BSD (la llamada a función listen apareció por 1ª vez en 4.2BSD).

FALLOS
Si el zócalo es de tipo af_inet, y el argumento backlog es mayor que la constante SO_MAXCONN (128 en 2.0.23), se trunca silenciosamente a SO_MAXCONN. Para aplicaciones transportables, no confíe en este valor puesto que BSD (y algunos sistemas derivados de BSD) limitan backlog a 5.

CONSULTE TAMBIÉN
accept(2), connect(2), socket(2)