osf1 man page for mktimer

mktimer(3)						     Library Functions Manual							mktimer(3)

NAME
       mktimer - Allocates a per-process timer

LIBRARY
       Standard C Library (libc.a)

SYNOPSIS
       #include <sys/timers.h>
       timer_t mktimer(      int clock_type,	  int notify_type,	void *reserved) ;

PARAMETERS
       Specifies  the system-wide clock to be used as a per-process time base for the new timer.  Specifies the mechanism by which a process is to
       be notified when the per-process timer times out.  Not used.

DESCRIPTION
       The mktimer() function is used to allocate a per-process timer using a specified system-wide clock as its timebase.  The mktimer() function
       returns a unique timer ID of type timer_t, which is used to identify the timer in per-process timer requests.

       Each  implementation  of per-process timers defines a set of clocks that can be used as a time base for per-process timers, and one or more
       mechanisms for notifying the process that a per-process timer has expired.  The Tru64 UNIX operating system allows each process to allocate
       one  per-process timer whose clock_type parameter is specified by the TIMEOFDAY symbolic constant, which is defined in the timers.h include
       file, using the notification mechanism whose notify_type parameter is specified by the DELIVERY_SIGNALS symbolic constant.

       When the notify_type parameter is specified as DELIVERY_SIGNALS, the system sends a SIGALRM  signal  to	the  process  whenever	the  timer
       expires.

NOTES
       Per-process timers are not inherited by a child process across fork() or exec() functions.

       The reserved parameter is not currently used, but is specified for future support of other delivery mechanisms.

       The  mktimer()  function  is  part  of  the POSIX 1003.4 real time extensions, which is not an approved standard.  As such, it is liable to
       change.	Trial use

RETURN VALUES
       Upon successful completion, the mktimer() function returns a timer_t value, which may be passed to a per-process  timer	call.	Otherwise,
       mktimer() returns a value of (timer_t)-1 and sets errno to indicate the error.

ERRORS
       If  the	mktimer() function fails, errno may be set to one of the following values: The calling process has already allocated all available
       timers.	The clock_type or notify_type parameter is invalid.

RELATED INFORMATION
       Functions: exec(2), fork(2), getclock(3), gettimer(3), reltimer(3), rmtimer(3), setclock(3) delim off

																	mktimer(3)