*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> nanosleep (3)              
Title
Content
Arch
Section
 

nanosleep(3)

Contents


NAME    [Toc]    [Back]

       nanosleep  -  Suspends  a  process  from execution for the
       specified timer interval (P1003.1b)

SYNOPSIS    [Toc]    [Back]

       #include <time.h>

       int nanosleep ( const struct timespec *rqtp, struct  timespec
 *rmtp);


LIBRARY    [Toc]    [Back]

       Realtime Library (librt.so, librt.a)

PARAMETERS    [Toc]    [Back]

       A  pointer to the timespec data structure that defines the
       time interval during which the  calling  process  is  suspended.
   A  pointer  to  the timespec data structure that
       receives the amount of time remaining  in  the  previously
       requested  interval,  or  zero  if  the  full interval has
       elapsed.

DESCRIPTION    [Toc]    [Back]

       The nanosleep function suspends a process until one of the
       following  conditions  is met: The time interval specified
       in rqtp has elapsed.  A signal is delivered to the calling
       process and the action is to deliver a signal to a signalcatching
 function (or to terminate the process).

       The suspension time may be longer than  requested  because
       the argument value is rounded up to an integer multiple of
       the clock resolution, or due to the  scheduling  of  other
       activity.  Except  when it is interrupted by a signal, the
       suspension time is not less than the time specified by the
       rqtp argument (as measured by the system clock).

RETURN VALUES    [Toc]    [Back]

       When  the nanosleep function returns because the requested
       time has elapsed, the call is successful and a value of  0
       (zero) is returned.

       If  the  nanosleep  function returns because it was interrupted
 by a signal, a value of -1  is  returned.   If  the
       rmtp  argument  is not NULL, the timespec structure referenced
 by the call is updated to contain the time remaining
       in the interval.
        If  the  rmtp argument is NULL, the remaining time is not
       returned.

       On an unsuccessful call, a value of  -1  is  returned  and
       errno is set to indicate that an error occurred.

ERRORS    [Toc]    [Back]

       The  nanosleep  function  fails under the following conditions:
 The nanosleep function was interrupted by a signal.
       The  rqtp  argument specified a nanosecond value less than
       zero or greater than or equal to 1000 million.




SEE ALSO    [Toc]    [Back]

      
      
       Functions: sleep(1)

       Guide to Realtime Programming



                                                     nanosleep(3)
[ Back ]
 Similar pages
Name OS Title
pxfpause IRIX Suspends process execution until signal
timer_delete Tru64 Deallocates a previously allocated per-process timer (P1003.1b)
sleep OpenBSD suspend process execution for interval of seconds
sleep NetBSD suspend process execution for interval of seconds
usleep FreeBSD suspend process execution for an interval measured in microseconds
sleep FreeBSD suspend process execution for an interval measured in seconds
nanosleep FreeBSD suspend process execution for an interval measured in nanoseconds
sched_rr_get_interval Tru64 Returns the current quantum for process execution under the SCHED_RR policy (P1003.1b)
sleep Tru64 Suspends execution for at least the specified time
timerclear OpenBSD get/set value of interval timer
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service