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)