|
|
HP-UX Reference > Mmktimer(3C)HP-UX 11i Version 2: December 2007 Update |
|
NAMEmktimer — allocate a per-process timer DESCRIPTIONThe mktimer() function is used to allocate a per-process timer using the specified system-wide clock as the timing base. mktimer() returns an unique timer ID of type timer_t used to identify the timer in timer requests (see gettimer(3C)). clock_type specifies the system-wide clock to be used as the timing base for the new timer. notify_type specifies the mechanism by which the process is to be notified when the timer expires. mktimer() supports one per-process timer with a clock_type of TIMEOFDAY and notify_type of DELIVERY_SIGNALS. If notify_type is DELIVERY_SIGNALS, the system causes a SIGALRM signal to be sent to the process whenever the timer expires. For clock_type TIMEOFDAY, the machine-dependent clock resolution and maximum value are 1/ HZ and MAX_ALARM seconds, respectively. These constants are defined in <sys/param.h>. RETURN VALUEUpon successful completion, mktimer() returns a timer_t, which can be passed to the per_process timer calls. If unsuccessful, mktimer() returns a value of (timer_t)-1 and sets errno to indicate the error. ERRORSmktimer() fails if any of the following conditions are encountered:
SEE ALSOtimers(2), getclock(3C), gettimer(3C), reltimer(3C), rmtimer(3C), setclock(3C), thread_safety(5). |
|