bionic (2) listen.2.gz

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)