Manpages

NOMBRE

nanosleep − hace una pausa en la ejecución durante un tiempo especificado

SINOPSIS

#include <time.h>

int nanosleep(const struct timespec *req, struct timespec *rem);

DESCRIPCIÓN

nanosleep retarda la ejecución del programa durante al menos el tiempo especificado en *req. La función puede regresar antes si se ha mandado una señal al proceso. En este caso, devuelve −1, pone errno a EINTR, y escribe el tiempo restante en la estructura apuntada por rem a menos que rem sea NULL. El valor de *rem puede emplearse para llamar a nanosleep de nuevo y completar la pausa especificada.

La estructura timespec se emplea para especificar intervalos de tiempo con precisión de nanosegundo. Se especifica en <time.h> y tiene la forma

struct timespec
{

time_t

tv_sec;

/* segundos */

long

tv_nsec;

/* nanosegundos */

};

El valor del campo de nanosegundos debe estar en el rango de 0 a 999 999 999.

Comparado con sleep(3) y usleep(3), nanosleep tiene la ventaja de no afectar a ninguna señal, está normalizado por POSIX, proporciona una resolución del temporizador mayor, y permite que un ’sleep’ que ha sido interrumpido por una señal continúe más fácilmente.

ERRORES

En caso de un error o excepción, la llamada al sistema nanosleep devuelve −1 en vez de 0 y pone en errno uno de los valores siguientes:

EINTR

La pausa ha sido interrumpida por una señal no bloqueante que ha sido mandada al proceso. El tiempo restante de sueño ha sido escrito en *rem de modo que el proceso pueda llamar fácilmente de nuevo a nanosleep para continuar así con la pausa.

EINVAL

El valor en el campo tv_nsec no estaba en el rango de 0 a 999 999 999 ó tv_sec era un número negativo.

FALLOS

La implementación actual de nanosleep está basada en el mecanismo normal del temporizador del núcleo, que tiene una resolución de 1/HZ s (i.e., 10 ms en Linux/i386 y 1 ms en Linux/Alpha). Por lo tanto, nanosleep hace una pausa siempre de al menos el tiempo especificado, empero puede tardar hasta 10 ms más hasta que el proceso sea de nuevo ejecutable. Por la misma razón, el valor devuelto en *rem en el caso de una señal enviada, se redondea normalmente al siguiente múltiplo más grande de 1/HZ s.

Como algunas aplicaciones requieren pausas mucho más precisas (p. ej., para controlar algún hardware que requiere respuestas en tiempo real), nanosleep también es capaz de pausas cortas de alta precisión. Si el proceso se planifica bajo una política de tiempo real como SCHED_FIFO o SCHED_RR, entonces se harán pausas de hasta 2 ms como las esperas ocupadas con precisión de microsegundo.

CONFORME A

POSIX.1b (antes, POSIX.4).

VÉASE TAMBIÉN

sleep(3), usleep(3), sched_setscheduler(2), timer_create(2)