Schedules an alarm signal.
#include <unistd.h>
unsigned int alarm (
unsigned int seconds);
(IN) Specifies the number of real time seconds to wait before generating the signal. If set to 0, a pending alarm request, if any, is canceled.
If there is a previous alarm request with time remaining, the alarm function returns the number of seconds remaining before the previous request would have generated an alarm signal. Otherwise, returns 0.
Alarm requests are not stacked; only one alarm generation can be scheduled in this manner. If the alarm signal has not yet been generated, the call reschedules the time at which the alarm signal is generated.
IMPORTANT:The alarm function is only supported when you compile your NLM with the posixpre prelude file or link with the POSIX semantics flag, which is supported on NetWare 6.5 SP3 or later.