NOMBRE

       listen - espera conexiones en un conector (socket)

SINOPSIS

       #include <sys/socket.h>

       int listen(int s, int backlog);

DESCRIPCIÓN

       Para  aceptar  conexiones,  primero se crea un conector 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 conectores 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
       tenga éxito.

OBSERVACIONES

       El comportamiento del parámetro backlog sobre conectores TCP ha cambiado  con  la  versión
       2.2  de  Linux.   Ahora  indica  la  longitud  de  la  cola  para  conectores establecidos
       completamente que esperan ser aceptados, en lugar del número  de  peticiones  de  conexión
       incompletas. La longitud máxima de la cola para conectores incompletos se puede configurar
       con la sysctl tcp_max_syn_backlog.  Cuando los "syncookies" están activos, no  existe  una
       longitud  máxima  lógica y la configuración de esta sysctl se ignora.  Vea tcp(7) para más
       información.

VALOR DEVUELTO

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

ERRORES

       EADDRINUSE
              Otro conector ya se encuentra escuchando en el mismo puerto.

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

       ENOTSOCK
              El argumento s no es un conector.

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

CONFORME A

       Single  Unix,  4.4BSD, borrador POSIX 1003.1g. La llamada a función listen apareció por 1ª
       vez en 4.2BSD.

FALLOS

       Si el conector es de tipo AF_INET y  el  argumento  backlog  es  mayor  que  la  constante
       SOMAXCONN  (128  en  2.0 y 2.2), se trunca silenciosamente a SOMAXCONN.  Para aplicaciones
       transportables, no confíe en este valor puesto que BSD (y algunos  sistemas  derivados  de
       BSD) limitan backlog a 5.

VÉASE TAMBIÉN

       accept(2), connect(2), socket(2)