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

  man pages->FreeBSD man pages -> ualarm (3)              



NAME    [Toc]    [Back]

     ualarm -- schedule signal after specified time

LIBRARY    [Toc]    [Back]

     Standard C Library (libc, -lc)

SYNOPSIS    [Toc]    [Back]

     #include <unistd.h>

     ualarm(useconds_t microseconds, useconds_t interval);

DESCRIPTION    [Toc]    [Back]

     This is a simplified interface to setitimer(2).

     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 value microseconds have passed).

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

RETURN VALUES    [Toc]    [Back]

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

NOTES    [Toc]    [Back]

     A microsecond is 0.000001 seconds.

SEE ALSO    [Toc]    [Back]

     getitimer(2), setitimer(2), sigpause(2), sigvec(2), alarm(3), signal(3),
     sleep(3), usleep(3)

HISTORY    [Toc]    [Back]

     The ualarm() function appeared in 4.3BSD.

FreeBSD 5.2.1			April 19, 1994			 FreeBSD 5.2.1
[ Back ]
 Similar pages
Name OS Title
pxfalarm IRIX Schedule alarm signal
miser_submit IRIX resource schedule list
sync FreeBSD schedule file system updates
uusched HP-UX schedule uucp transport files
crontab Tru64 Submits a schedule of commands to cron
ncplogout FreeBSD schedule permanent connection to close
swi FreeBSD register and schedule software interrupt handlers
miser_jinfo IRIX query miser about the schedule/description of a submitted job
swi_add FreeBSD register and schedule software interrupt handlers
swi_sched FreeBSD register and schedule software interrupt handlers
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service