Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP-UX Reference > G

gettimer(3C)

HP-UX 11i Version 3: February 2007
» 

Technical documentation

» Feedback
Content starts here

 » Table of Contents

 » Index

NAME

gettimer — get value of a per-process timer

SYNOPSIS

#include <sys/timers.h>

int gettimer(timer_t timerid, struct itimerspec *value);

DESCRIPTION

The gettimer() function returns an itimerspec structure value to the value argument. The it_value member of the structure represents the amount of time in the current interval before the timer expires for the timer specified in timerid, or zero if the timer is disabled. The it_interval member has the value last set by reltimer() (see reltimer(3C)). The members of value are subject to the resolution of the timer (see mktimer(3C)).

The behavior of this function is undefined if value is NULL.

RETURN VALUE

Upon successful completion, gettimer() returns zero; otherwise, it returns -1 and sets errno to indicate the error.

ERRORS

gettimer() fails if any of the following conditions are encountered:

[EINVAL]

timerid does not correspond to an ID returned by mktimer().

[EIO]

An error occurred while accessing the clock device.

FILES

/usr/include/sys/timers.h

SEE ALSO

timers(2), timer_gettime(2), mktimer(3C), reltimer(3C), thread_safety(5).

STANDARDS CONFORMANCE

gettimer(): AES

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 1983-2007 Hewlett-Packard Development Company, L.P.