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

  man pages->Tru64 Unix man pages -> reltimer (3)              



NAME    [Toc]    [Back]

       reltimer  -  Establishe timeout intervals of a per-process

SYNOPSIS    [Toc]    [Back]

       #include <sys/timers.h>

       int reltimer(
               timer_t tmrid,
               struct itimerspec *val,
               struct itimerspec *oval );

LIBRARY    [Toc]    [Back]

       Standard C Library (libc)

PARAMETERS    [Toc]    [Back]

       Specifies the per-process timer to access.   Points  to  a
       type  itimerspec  structure  containing  the values of the
       initial and offset timeout intervals.  Points  to  a  type
       itimerspec  structure where the current value of the timer
       timeout interval and the time-to-go are to be stored.

DESCRIPTION    [Toc]    [Back]

       The reltimer() function  establishes  initial  and  offset
       timeout  intervals of a per-process timer specified by the
       tmrid  parameter.  Initial  and  offset  timeout  interval
       information  is  stored in an itimerspec structure pointed
       to by the val parameter. When the per-process timer specified
  by  the  tmrid parameter is active, after timeout of
       the initial time interval,  all  subsequent  timeouts  are
       controlled  by  the offset timeout value; as long as tmrid
       continues to operate, the offset values pointed to by  the
       val  parameter  are used as the per-process timeout interval.
 The current timeout interval and the  time-to-go  are
       returned to the location pointed to by the oval parameter.

       Initial and offset time information  for  the  per-process
       timer  is  stored  in  space reserved by a type itimerspec
       structure pointed to by the val parameter. A type  itimerspec
  structure is also used to store returned time information
 specified by the  oval  parameter.  The  itimerspec
       structure is defined in the sys/timers.h include file.

NOTES    [Toc]    [Back]

       Time  values  smaller than the resolution of the specified
       timer are rounded up to the resolution value. Time  values
       larger  than  the  maximum  timeout value of the specified
       per-process timer are rounded down to that maximum  value.
       Trial use

RETURN VALUES    [Toc]    [Back]

       Upon   successful   completion,  the  reltimer()  function
       returns 0 (zero). Otherwise, -1 is returned and  errno  is
       set to indicate the error.

ERRORS    [Toc]    [Back]

       If  the reltimer() function fails, errno may be set to the
       following value: The timerid parameter does not specify an
       allocated  per-process  timer, or the val parameter points
       to a nanosecond value less than zero or  greater  than  or
       equal to 1000 million.

SEE ALSO    [Toc]    [Back]

       Functions: alarm(3), getclock(3), gettimer(3), mktimer(3)

[ Back ]
 Similar pages
Name OS Title
gettimer Tru64 Get value of a per-process timer
timer_create Tru64 Allocates a per-process timer
rmtimer Tru64 Free a per-process timer
mktimer Tru64 Allocate a per-process timer
nanosleep Tru64 Suspends a process from execution for the specified timer interval (P1003.1b)
timer_delete Tru64 Deallocates a previously allocated per-process timer (P1003.1b)
usleep Linux suspend execution for microsecond intervals
VkPeriodic IRIX Support for performing actions at regular periodic intervals
pfto HP-UX Powerfail Timeout
SSL_get_default_timeout OpenBSD get default session timeout value
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service