summaryrefslogtreecommitdiffstats
path: root/man7/time_namespaces.7
diff options
context:
space:
mode:
Diffstat (limited to 'man7/time_namespaces.7')
-rw-r--r--man7/time_namespaces.748
1 files changed, 24 insertions, 24 deletions
diff --git a/man7/time_namespaces.7 b/man7/time_namespaces.7
index 8a2817be5..5e92f0245 100644
--- a/man7/time_namespaces.7
+++ b/man7/time_namespaces.7
@@ -27,16 +27,16 @@ except that it also includes any time that the system is suspended.
Thus, the processes in a time namespace share per-namespace values
for these clocks.
This affects various APIs that measure against these clocks, including:
-.BR clock_gettime (2),
-.BR clock_nanosleep (2),
-.BR nanosleep (2),
-.BR timer_settime (2),
-.BR timerfd_settime (2),
+.MR clock_gettime 2 ,
+.MR clock_nanosleep 2 ,
+.MR nanosleep 2 ,
+.MR timer_settime 2 ,
+.MR timerfd_settime 2 ,
and
.IR /proc/uptime .
.P
Currently, the only way to create a time namespace is by calling
-.BR unshare (2)
+.MR unshare 2
with the
.B CLONE_NEWTIME
flag.
@@ -53,7 +53,7 @@ symbolic link shows the time namespace in which
the children of a process will be created.
(A process can use a file descriptor opened on
this symbolic link in a call to
-.BR setns (2)
+.MR setns 2
in order to move into the namespace.)
.\"
.SS \fI/proc/\fPpid\fI/timens_offsets\fP
@@ -113,7 +113,7 @@ records of the same form to the
file.
The file can be written to multiple times,
but after the first process has been created in or has entered the namespace,
-.BR write (2)s
+.MR write 2 s
on this file fail with the error
.BR EACCES .
In order to write to the
@@ -160,7 +160,7 @@ inside the namespace would exceed half of the value of the kernel constant
.RE
.P
In a new time namespace created by
-.BR unshare (2),
+.MR unshare 2 ,
the contents of the
.I timens_offsets
file are inherited from the time namespace of the creating process.
@@ -202,11 +202,11 @@ time:[4026531834]
.in
.P
Continuing in the initial time namespace, we display the system uptime using
-.BR uptime (1)
+.MR uptime 1
and use the
.I clock_times
example program shown in
-.BR clock_getres (2)
+.MR clock_getres 2
to display the values of various clocks:
.P
.in +4n
@@ -222,9 +222,9 @@ CLOCK_BOOTTIME : 76633.544 (21h 17m 13s)
.in
.P
We then use
-.BR unshare (1)
+.MR unshare 1
to create a time namespace and execute a
-.BR bash (1)
+.MR bash 1
shell.
From the new shell, we use the built-in
.B echo
@@ -246,7 +246,7 @@ ns2# \fBecho "boottime $((7*24*60*60)) 0" > /proc/$$/timens_offsets\fP
.in
.P
Above, we started the
-.BR bash (1)
+.MR bash 1
shell with the
.B \-\-norc
option so that no start-up scripts were executed.
@@ -256,12 +256,12 @@ shell before we have a chance to update the
file.
.P
We then use
-.BR cat (1)
+.MR cat 1
to display the contents of the
.I timens_offsets
file.
The execution of
-.BR cat (1)
+.MR cat 1
creates the first process in the new time namespace,
after which further attempts to update the
.I timens_offsets
@@ -278,7 +278,7 @@ bash: echo: write error: Permission denied
.in
.P
Continuing in the new namespace, we execute
-.BR uptime (1)
+.MR uptime 1
and the
.I clock_times
example program:
@@ -334,12 +334,12 @@ CLOCK_BOOTTIME : 76633.544 (21h 19m 23s)
.EE
.in
.SH SEE ALSO
-.BR nsenter (1),
-.BR unshare (1),
-.BR clock_settime (2),
+.MR nsenter 1 ,
+.MR unshare 1 ,
+.MR clock_settime 2 ,
.\" clone3() support for time namespaces is a work in progress
.\" .BR clone3 (2),
-.BR setns (2),
-.BR unshare (2),
-.BR namespaces (7),
-.BR time (7)
+.MR setns 2 ,
+.MR unshare 2 ,
+.MR namespaces 7 ,
+.MR time 7