Name

ualarm - schedule signal after given number of microseconds

Library

libc.lib

Synopsis

  #include <unistd.h>
  useconds_t ualarm (useconds_t microseconds, useconds_t interval);

Return values

When the signal has successfully been caught, ualarm returns the amount of time left on the clock.

Notes

A microsecond is 0.000001 seconds.

Detailed description

This is a simplified interface to setitimer.

The ualarm function waits a count of microseconds before asserting the terminating signal SIGALRM. System activity or time used in processing the call may cause a slight delay.

If the interval argument is non-zero, the SIGALRM signal will be sent to the process every interval microseconds after the timer expires (e.g. after microseconds number of microseconds have passed).

Due to setitimer restriction the maximum number of microseconds and interval is limited to 100000000000000 (in case this value fits in the unsigned integer).


See also

sleep, usleep
The ualarm function appeared in BSD 4.3 .

Feedback

For additional information or queries on this page send feedback

© 2007-2009 Nokia Corporation. All rights reserved. This documentation can be used in the connection with this Product to help and support the user.