timer_getexpstatus()

Get the expiry status of a timer

Synopsis:

#include <time.h>

int timer_getexpstatus( timer_t timerid );

Arguments:

timerid
A timer_t object that holds a timer ID, as set by timer_create() .

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The timer_getexpstatus() function gets the expiry status of the time with the ID given by timerid.

  • This function is based on a POSIX draft. If you want your code to be more portable, then instead of calling timer_getexpstatus(), call timer_gettime() and check the amount of time left on the timer.
  • In order to get timer information, your process must have the PROCMGR_AID_TIMER ability enabled. For more information, see procmgr_ability() .

Returns:

0
The timer has expired.
-1
An error occurred ( errno is set).

Errors:

EINVAL
The timer specified by timerid doesn't exist.
EPERM
The calling process doesn't have the required permission; see procmgr_ability() .

Classification:

QNX Neutrino

Safety:  
Cancellation point No
Interrupt handler No
Signal handler Yes
Thread Yes

Last modified: 2013-12-23

comments powered by Disqus