Index for Section 3

Alphabetical listing for M

Bottom of page

mktimer(3)
NAME
  mktimer - Allocate a per-process timer

SYNOPSIS
  #include <sys/timers.h>

  timer_t mktimer(
	  int clock_type,
	  int notify_type,
	  void *reserved );

LIBRARY
  Standard C Library (libc)

PARAMETERS
  clock_type
      Specifies the system-wide clock to be used as a per-process time base
      for the new timer.

  notify_type
      Specifies the mechanism by which a process is to be notified when the
      per-process timer times out.

  reserved
      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.

  AES Support Level:
      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:

  [EAGAIN]
      The calling process has already allocated all available timers.

  [EINVAL]
      The clock_type or notify_type parameter is invalid.

SEE ALSO
  Functions: exec(2), fork(2), getclock(3), gettimer(3), reltimer(3),
  rmtimer(3), setclock(3)

Index for Section 3

Alphabetical listing for M

Top of page