Provided by:
manpages-es_1.55-10_all 
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'ON
poll es una variacion 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 limite 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 parametro de entrada, una
mascara de bits que especifica los eventos en los que la aplicacion
esta interesada. El campo revents es un parametro de salida,
completado por el nucleo 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 pondran a 1 en el campo revents en el momento en que la condicion
correspondiente sea cierta). Si no se ha producido ninguno de los
eventos solicitados (y ningun error) para ninguno de los descriptores
de fichero, el nucleo espera durante timeout milisegundos a que se
produzca uno de estos eventos. Los bits posibles en estas mascaras
estan 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 sera no bloqueante */
#define POLLERR 0x0008 /* Condicion de error */
#define POLLHUP 0x0010 /* Colgado */
#define POLLNVAL 0x0020 /* Peticion invalida: fd no esta abierto */
En <asm/poll.h> tambien se definen los valores POLLRDNORM, POLLRDBAND,
POLLWRNORM, POLLWRBAND y POLLMSG.
VALOR DEVUELTO
En caso de exito, se devuelve un numero positivo que indica el numero
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
limite (timeout) de la llamada y que no se ha seleccionado ningun
descriptor de fichero. En caso de error, se devuelve -1 y se asigna a
errno un valor apropiado.
ERRORES
EBADF Se especifico un descriptor de fichero invalido 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 esta ubicado en el espacio de
direcciones del programa invocador.
EINTR Se ha producido una senal antes de cualquier evento.
CONFORME A
XPG4-UNIX.
DISPONIBILIDAD
La llamada al sistema poll() se introdujo en la version 2.1.23 de
Linux. La funcion de biblioteca poll() se introdujo en la version
5.4.28 de libc (y emula la llamada al sistema poll mediante select si
su nucleo no tiene dicha llamada al sistema).
V'EASE TAMBI'EN
select(2), select_tut(2)