diff options
Diffstat (limited to 'man7/time_namespaces.7')
-rw-r--r-- | man7/time_namespaces.7 | 48 |
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 |