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

  man pages->IRIX man pages -> timer_gettime (3c)              


timer_gettime(3C)					     timer_gettime(3C)

NAME    [Toc]    [Back]

     timer_gettime - get the time remaining before posix timer expiration

SYNOPSIS    [Toc]    [Back]

     #include <time.h>

     int timer_gettime (timer_t	timerid<b>, struct	itimerspec *value<b>);

DESCRIPTION    [Toc]    [Back]

     timer_gettime retrieves the time remaining	before the posix timer named
     by	timerid	expires, as well as, the periodic timer	interval between
     expirations and stores the	information at memory address value.

     The it_value field	of value contains the time remainder, while the
     it_interval field contains	the periodic timer interval.  If it_value
     contains zero after a successful return, then the timer is	disarmed.  If
     it_interval contains zero after a successful return, then the timer is
     not periodic.

     timer_gettime will	fail if	one or more of the following are true:

     [EINVAL]	 The timerid does not name a valid posix timer.

     [EFAULT]	 The address specified by value	is outside the range of	the
		 address space of the calling process.

SEE ALSO    [Toc]    [Back]

     timer_create(3C), timer_delete(3C), timer_getoverrun(3C),
     timer_settime(3C),	clock_settime(2), clock_gettime(2), clock_getres(2),
     getitimer(2), setiitimer(2)

DIAGNOSTICS    [Toc]    [Back]

     Upon successful completion, a value of 0 is returned to the calling
     process. Otherwise, a value of -1 is returned and errno is	set to
     indicate the error.

									PPPPaaaaggggeeee 1111
[ Back ]
 Similar pages
Name OS Title
timer_settime IRIX set the expiration time for a posix timer
create_link HP-UX Creates a soft link and optionally specifies an expiration time and an extension time
timer_create IRIX create a posix timer
timer_delete IRIX delete a posix timer
timer_getoverrun IRIX get the posix timer overrun count
pthread_get_expiration_np Tru64 Obtains a value representing a desired expiration time
tis_get_expiration Tru64 Obtains a value representing a desired expiration time
hardclock NetBSD real-time timer
clock_settime IRIX get/set date and time (POSIX)
aio_max_ops HP-UX maximum number of POSIX async I/O operations that can be queued at any time
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service