[Go to CFHT Home Page] Man Pages
Back to Software Index  BORDER=0Manpage Top Level
    ualarm(3C) manual page Table of Contents

Name

ualarm - schedule signal after interval in microseconds

Synopsis

#include <unistd.h>

unsigned int ualarm(unsigned int usecs,
   unsigned int interval);

Description

ualarm() sends signal SIGALRM (see signal(3C) ), to the caller in a number of microseconds given by the usecs argument. Unless caught or ignored, the signal terminates the caller.

If the interval argument is non-zero, the SIGALRM signal will be sent to the caller every interval microseconds after the timer expires (for instance, after usecs microseconds have passed).

Because of scheduling delays, resumption of execution when the signal is caught may be delayed an arbitrary amount.

Interactions between ualarm() and either alarm(2) or sleep(3C) are unspecified.

Return Values

The return value is the amount of time previously remaining in the alarm clock.

See Also

alarm(2) , getitimer(2) , setitimer(2) , sighold(3C) , signal(3C) , sleep(3C) , usleep(3C)

Notes

ualarm() is a simplified interface to setitimer(2) ; (see getitimer(2) ).

Table of Contents