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

NOMBRE
       listen - espera conexiones en un conector (socket)


SINOPSIS
       #include <sys/socket.h>

       int listen(int s, int backlog);


DESCRIPCI'ON
       Para  aceptar  conexiones,  primero  se crea un conector con socket(2),
       luego se especifica con listen el deseo de aceptar conexiones entrantes
       y  un  limite  de  la  cola  para  dichas  conexiones, y por ultimo las
       conexiones son aceptadas mediante  accept(2).   La  llamada  listen  se
       aplica solamente a conectores de tipo SOCK_STREAM o SOCK_SEQPACKET.

       El parametro backlog define la longitud maxima a la que puede llegar la
       cola de conexiones  pendientes.  Si  una  peticion  de  conexion  llega
       estando  la  cola  llena,  el  cliente  puede  recibir un error con una
       indicacion  de  ECONNREFUSED  o,  si  el  protocolo  subyacente  acepta
       retransmisiones,  la  peticion  puede no ser tenida en cuenta, de forma
       que un reintento tenga exito.


OBSERVACIONES
       El  comportamiento  del  parametro  backlog  sobre  conectores  TCP  ha
       cambiado  con  la version 2.2 de Linux.  Ahora indica la longitud de la
       cola  para  conectores  establecidos  completamente  que  esperan   ser
       aceptados,  en  lugar del numero de peticiones de conexion incompletas.
       La longitud maxima de la cola  para  conectores  incompletos  se  puede
       configurar  con la sysctl tcp_max_syn_backlog.  Cuando los "syncookies"
       estan activos, no existe una longitud maxima logica y la  configuracion
       de esta sysctl se ignora.  Vea tcp(7) para mas informacion.


VALOR DEVUELTO
       En  caso de exito, 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 valido.

       ENOTSOCK
              El argumento s no es un conector.

       EOPNOTSUPP
              El conector no es de un tipo que admita la operacion listen.


CONFORME A
       Single Unix, 4.4BSD, borrador  POSIX  1003.1g.  La  llamada  a  funcion
       listen aparecio por 1a 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 confie en este valor
       puesto que BSD (y algunos sistemas derivados de BSD) limitan backlog  a
       5.


V'EASE TAMBI'EN
       accept(2), connect(2), socket(2)