NOMBRE

       poll - espera un evento en un descriptor de fichero

SINOPSIS

       #include <sys/poll.h>

       int poll(struct pollfd *ufds, unsigned int nfds, int timeout);

DESCRIPCIÓN

       poll es una variación de select.  Especifica un vector de nfds estructuras del tipo
               struct pollfd {
                       int fd;         /* Descriptor de fichero */
                       short events;   /* Eventos solicitados */
                       short revents;  /* Eventos ocurridos */
               };
       y  un  tiempo límite timeout en milisegundos. Un valor negativo indica un tiempo infinito.
       El campo fd contiene el descriptor de fichero de un fichero abierto.  El campo  events  es
       un  parámetro  de  entrada,  una  mascara de bits que especifica los eventos en los que la
       aplicación está interesada.  El campo revents es un parámetro de salida, completado por el
       núcleo  con los eventos que han ocurrido realmente, bien del tipo solicitado o bien de uno
       de los tipos POLLERR, POLLHUP o POLLNVAL.  (Estos tres bits carecen de significado  en  el
       campo  events  y  se  pondrán  a  1  en el campo revents en el momento en que la condición
       correspondiente sea cierta).  Si no se ha producido ninguno de los eventos solicitados  (y
       ningún  error)  para  ninguno  de  los  descriptores  de fichero, el núcleo espera durante
       timeout milisegundos a que se produzca uno de estos eventos.  Los bits posibles  en  estas
       máscaras están definidos en <sys/poll.h>:
           #define POLLIN    0x0001  /* Hay datos que leer */
           #define POLLPRI   0x0002  /* Hay datos urgentes que leer */
           #define POLLOUT   0x0004  /* La escritura ahora será no bloqueante */
           #define POLLERR   0x0008  /* Condición de error */
           #define POLLHUP   0x0010  /* Colgado */
           #define POLLNVAL  0x0020  /* Petición inválida: fd no está abierto */
       En  <asm/poll.h>  también  se  definen  los  valores  POLLRDNORM,  POLLRDBAND, POLLWRNORM,
       POLLWRBAND y POLLMSG.

VALOR DEVUELTO

       En caso de éxito, se devuelve un número positivo que indica el número de estructuras  cuyo
       campo  revents  tiene  un valor distinto de cero (en otras palabras, aquellos descriptores
       para los que se ha producido un evento o un error). Un valor 0 indica que se  ha  cumplido
       el  tiempo límite (timeout) de la llamada y que no se ha seleccionado ningún descriptor de
       fichero. En caso de error, se devuelve -1 y se asigna a errno un valor apropiado.

ERRORES

       EBADF  Se especificó un descriptor de fichero inválido en uno de los conjuntos.

       ENOMEM No hay espacio disponible para ubicar la tabla de descriptores del fichero.

       EFAULT El vector pasado como argumento no está ubicado en el espacio  de  direcciones  del
              programa invocador.

       EINTR  Se ha producido una señal antes de cualquier evento.

CONFORME A

       XPG4-UNIX.

DISPONIBILIDAD

       La  llamada  al  sistema  poll() se introdujo en la versión 2.1.23 de Linux. La función de
       biblioteca poll() se introdujo en la versión 5.4.28 de libc (y emula la llamada al sistema
       poll mediante select si su núcleo no tiene dicha llamada al sistema).

VÉASE TAMBIÉN

       select(2), select_tut(2)