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.
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)