The dppause man page
NAME
dppause - set alarm function and pause for a signal
SYNOPSIS
#include
void dppause(t, alrmfunc)
long t;
FUNCPTR alrmfunc;
DESCRIPTION
dppause() makes two settings: it sets the system alarm clock
to go off (which will generate the SIGALRM signal) at t
microseconds from now, and also sets the alarm signal han-
dling function. Then dppause() causes the current DP process
to sleep until a system signal arrives.
alrmfunc is the name of the function which will be invoked
when the alarm event occurs. If it is set to NULLFUNC
(defined, along with FUNCPTR, in dp.h), no action will be
taken regarding the invoking signal. If t is zero and alrm-
func is NULLFUNC, no alarm clock will be set and, unless the
application involves other system signals, the sleep will be
interrupted only by an incoming DP message.
Any value of t smaller than the resolution of the system
clock (often around 10 milliseconds) will be rounded up to
that figure.
Upon entry to dppause(), interrupts from incoming messages
are automatically re-enabled (if they had been blocked).
Upon exit from dppause(), the interrupt state is restored to
its condition before the call to dppause().
dppause() is usually used to wait for some condition to
become satisfied. For example, it can be placed inside a
while loop that exits when the specified number of messages
have been received.
SKETCH:
dpblock();
while ( !condition )
dppause(0, NULLFUNC);
dpunblock();
REMARK
This is a DP function call.
AUTHOR
David Arnow
FILES
/usr/include/dp/dp.h - DP header file
/usr/lib/libdp.a - DP library file
SEE ALSO
dpcall(3DP), dpblock(3DP), dpunblock(3DP)
Essential DP MAN Pages:
General/Essential:
Non-Interrupting Messages:
Interrupting Messages:
dpblock
dpcatchmsg
dpgetmsg
dppause
dpunblock
Other:
Return to
DP For Students
Return to
The DP Project
Return to
David Arnow's Home Page