Provided by: manpages-es_1.55-8_all bug

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)