summaryrefslogtreecommitdiffstats
path: root/man2/timer_create.2
diff options
context:
space:
mode:
Diffstat (limited to 'man2/timer_create.2')
-rw-r--r--man2/timer_create.264
1 files changed, 32 insertions, 32 deletions
diff --git a/man2/timer_create.2 b/man2/timer_create.2
index 1109858b8..8749cc601 100644
--- a/man2/timer_create.2
+++ b/man2/timer_create.2
@@ -21,7 +21,7 @@ Real-time library
.P
.RS -4
Feature Test Macro Requirements for glibc (see
-.BR feature_test_macros (7)):
+.MR feature_test_macros 7 ):
.RE
.P
.BR timer_create ():
@@ -99,7 +99,7 @@ capability in order to set a timer against this clock.
A system-wide clock derived from wall-clock time but counting leap seconds.
.P
See
-.BR clock_getres (2)
+.MR clock_getres 2
for some further details on the above clocks.
.P
As well as the above values,
@@ -107,9 +107,9 @@ As well as the above values,
can be specified as the
.I clockid
returned by a call to
-.BR clock_getcpuclockid (3)
+.MR clock_getcpuclockid 3
or
-.BR pthread_getcpuclockid (3).
+.MR pthread_getcpuclockid 3 .
.P
The
.I sevp
@@ -118,7 +118,7 @@ argument points to a
structure that specifies how the caller
should be notified when the timer expires.
For the definition and general details of this structure, see
-.BR sigevent (3type).
+.MR sigevent 3type .
.P
The
.I sevp.sigev_notify
@@ -127,14 +127,14 @@ field can have the following values:
.B SIGEV_NONE
Don't asynchronously notify when the timer expires.
Progress of the timer can be monitored using
-.BR timer_gettime (2).
+.MR timer_gettime 2 .
.TP
.B SIGEV_SIGNAL
Upon timer expiration, generate the signal
.I sigev_signo
for the process.
See
-.BR sigevent (3type)
+.MR sigevent 3type
for general details.
The
.I si_code
@@ -144,7 +144,7 @@ structure will be set to
.BR SI_TIMER .
At any point in time,
at most one signal is queued to the process for a given timer; see
-.BR timer_getoverrun (2)
+.MR timer_getoverrun 2
for more details.
.TP
.B SIGEV_THREAD
@@ -152,7 +152,7 @@ Upon timer expiration, invoke
.I sigev_notify_function
as if it were the start function of a new thread.
See
-.BR sigevent (3type)
+.MR sigevent 3type
for details.
.TP
.BR SIGEV_THREAD_ID " (Linux-specific)"
@@ -164,9 +164,9 @@ which must be a thread in the same process as the caller.
The
.I sigev_notify_thread_id
field specifies a kernel thread ID, that is, the value returned by
-.BR clone (2)
+.MR clone 2
or
-.BR gettid (2).
+.MR gettid 2 .
This flag is intended only for use by threading libraries.
.P
Specifying
@@ -239,7 +239,7 @@ internally the NPTL implementation uses a
value of
.B SIGEV_THREAD_ID
along with a real-time signal that is reserved by the implementation (see
-.BR nptl (7)).
+.MR nptl 7 ).
.IP \[bu]
The implementation of the default case where
.I evp
@@ -272,9 +272,9 @@ A program may create multiple interval timers using
.BR timer_create ().
.P
Timers are not inherited by the child of a
-.BR fork (2),
+.MR fork 2 ,
and are disarmed and deleted during an
-.BR execve (2).
+.MR execve 2 .
.P
The kernel preallocates a "queued real-time signal"
for each timer created using
@@ -282,7 +282,7 @@ for each timer created using
Consequently, the number of timers is limited by the
.B RLIMIT_SIGPENDING
resource limit (see
-.BR setrlimit (2)).
+.MR setrlimit 2 ).
.P
The timers created by
.BR timer_create ()
@@ -292,17 +292,17 @@ The POSIX timers API consists of the following interfaces:
.BR timer_create ()
Create a timer.
.TP
-.BR timer_settime (2)
+.MR timer_settime 2
Arm (start) or disarm (stop) a timer.
.TP
-.BR timer_gettime (2)
+.MR timer_gettime 2
Fetch the time remaining until the next expiration of a timer,
along with the interval setting of the timer.
.TP
-.BR timer_getoverrun (2)
+.MR timer_getoverrun 2
Return the overrun count for the last timer expiration.
.TP
-.BR timer_delete (2)
+.MR timer_delete 2
Disarm and delete a timer.
.P
Since Linux 3.10, the
@@ -310,7 +310,7 @@ Since Linux 3.10, the
file can be used to list the POSIX timers for the process with PID
.IR pid .
See
-.BR proc (5)
+.MR proc 5
for further information.
.P
Since Linux 4.10,
@@ -473,15 +473,15 @@ main(int argc, char *argv[])
.SH SEE ALSO
.ad l
.nh
-.BR clock_gettime (2),
-.BR setitimer (2),
-.BR timer_delete (2),
-.BR timer_getoverrun (2),
-.BR timer_settime (2),
-.BR timerfd_create (2),
-.BR clock_getcpuclockid (3),
-.BR pthread_getcpuclockid (3),
-.BR pthreads (7),
-.BR sigevent (3type),
-.BR signal (7),
-.BR time (7)
+.MR clock_gettime 2 ,
+.MR setitimer 2 ,
+.MR timer_delete 2 ,
+.MR timer_getoverrun 2 ,
+.MR timer_settime 2 ,
+.MR timerfd_create 2 ,
+.MR clock_getcpuclockid 3 ,
+.MR pthread_getcpuclockid 3 ,
+.MR pthreads 7 ,
+.MR sigevent 3type ,
+.MR signal 7 ,
+.MR time 7