alarm man page on SmartOS

Man page or keyword search:  
man Server   16655 pages
apropos Keyword Search (all sections)
Output format
SmartOS logo
[printable version]

ALARM(2)							      ALARM(2)

       alarm - schedule an alarm signal

       #include <unistd.h>

       unsigned int alarm(unsigned int seconds);

       The alarm() function causes the system to generate a SIGALRM signal for
       the process after the number of real-time seconds specified by  seconds
       have   elapsed  (see  signal.h(3HEAD)). Processor scheduling delays may
       prevent the process from handling the signal as soon as	it  is	gener‐

       If seconds is 0, a pending alarm request, if any, is cancelled. If sec‐
       onds  is	 greater  than	LONG_MAX/hz,  seconds  is  rounded   down   to
       LONG_MAX/hz. The value of hz is normally 100.

       Alarm  requests	are  not stacked; only one SIGALRM  generation can  be
       scheduled in this manner; if the SIGALRM signal has not yet been gener‐
       ated,  the  call	 will  result  in  rescheduling	 the time at which the
       SIGALRM signal will be generated.

       The fork(2) function clears pending alarms in the child process. A  new
       process image created by one of the exec(2) functions inherits the time
       left to an alarm signal in the old process's image.

       If there is a previous alarm  request  with  time   remaining,  alarm()
       returns	 a   non-zero  value  that  is the number of seconds until the
       previous request would  have  generated	a SIGALRM signal.   Otherwise,
       alarm() returns 0.

       The  alarm() function is always successful; no return value is reserved
       to indicate an error.

       See attributes(5) for descriptions of the following attributes:

       │Interface Stability │ Standard		│
       │MT-Level	    │ Async-Signal-Safe │

       exec(2), fork(2), signal.h(3HEAD), attributes(5), standards(5)

				  Jun 6, 2007			      ALARM(2)

List of man pages available for SmartOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
Vote for polarhome
Free Shell Accounts :: the biggest list on the net