summaryrefslogtreecommitdiffstats
path: root/man2/kcmp.2
diff options
context:
space:
mode:
Diffstat (limited to 'man2/kcmp.2')
-rw-r--r--man2/kcmp.242
1 files changed, 21 insertions, 21 deletions
diff --git a/man2/kcmp.2 b/man2/kcmp.2
index 0ea604eac..fe41f74c0 100644
--- a/man2/kcmp.2
+++ b/man2/kcmp.2
@@ -25,7 +25,7 @@ Standard C library
glibc provides no wrapper for
.BR kcmp (),
necessitating the use of
-.BR syscall (2).
+.MR syscall 2 .
.SH DESCRIPTION
The
.BR kcmp ()
@@ -45,7 +45,7 @@ checks against both
and
.IR pid2 ;
see
-.BR ptrace (2).
+.MR ptrace 2 .
.P
The
.I type
@@ -58,18 +58,18 @@ Check whether a file descriptor
in the process
.I pid1
refers to the same open file description (see
-.BR open (2))
+.MR open 2 )
as file descriptor
.I idx2
in the process
.IR pid2 .
The existence of two file descriptors that refer to the same
open file description can occur as a result of
-.BR dup (2)
+.MR dup 2
(and similar)
-.BR fork (2),
+.MR fork 2 ,
or passing file descriptors via a domain socket (see
-.BR unix (7)).
+.MR unix 7 ).
.TP
.B KCMP_FILES
Check whether the processes share the same set of open file descriptors.
@@ -81,7 +81,7 @@ are ignored.
See the discussion of the
.B CLONE_FILES
flag in
-.BR clone (2).
+.MR clone 2 .
.TP
.B KCMP_FS
Check whether the processes share the same filesystem information
@@ -94,7 +94,7 @@ are ignored.
See the discussion of the
.B CLONE_FS
flag in
-.BR clone (2).
+.MR clone 2 .
.TP
.B KCMP_IO
Check whether the processes share I/O context.
@@ -106,7 +106,7 @@ are ignored.
See the discussion of the
.B CLONE_IO
flag in
-.BR clone (2).
+.MR clone 2 .
.TP
.B KCMP_SIGHAND
Check whether the processes share the same table of signal dispositions.
@@ -118,7 +118,7 @@ are ignored.
See the discussion of the
.B CLONE_SIGHAND
flag in
-.BR clone (2).
+.MR clone 2 .
.TP
.B KCMP_SYSVSEM
Check whether the processes share the same
@@ -131,7 +131,7 @@ are ignored.
See the discussion of the
.B CLONE_SYSVSEM
flag in
-.BR clone (2).
+.MR clone 2 .
.TP
.B KCMP_VM
Check whether the processes share the same address space.
@@ -143,7 +143,7 @@ are ignored.
See the discussion of the
.B CLONE_VM
flag in
-.BR clone (2).
+.MR clone 2 .
.TP
.BR KCMP_EPOLL_TFD " (since Linux 4.13)"
.\" commit 0791e3644e5ef21646fe565b9061788d05ec71d4
@@ -152,7 +152,7 @@ Check whether the file descriptor
of the process
.I pid1
is present in the
-.BR epoll (7)
+.MR epoll 7
instance described by
.I idx2
of the process
@@ -175,7 +175,7 @@ struct kcmp_epoll_slot {
Within this structure,
.I efd
is an epoll file descriptor returned from
-.BR epoll_create (2),
+.MR epoll_create 2 ,
.I tfd
is a target file descriptor number, and
.I toff
@@ -191,7 +191,7 @@ the processes are currently running.
One should stop the processes by sending
.B SIGSTOP
(see
-.BR signal (7))
+.MR signal 7 )
prior to inspection with this system call to obtain meaningful results.
.SH RETURN VALUE
The return value of a successful call to
@@ -263,7 +263,7 @@ is invalid.
.TP
.B ENOENT
The target file is not present in
-.BR epoll (7)
+.MR epoll 7
instance.
.TP
.B EPERM
@@ -279,7 +279,7 @@ is 2, limits
.BR kcmp ()
to child processes;
see
-.BR ptrace (2).
+.MR ptrace 2 .
.TP
.B ESRCH
Process
@@ -299,14 +299,14 @@ since the original purpose of the system call was for the
checkpoint/restore in user space (CRIU) feature.
(The alternative to this system call would have been to expose suitable
process information via the
-.BR proc (5)
+.MR proc 5
filesystem; this was deemed to be unsuitable for security reasons.)
Since Linux 5.12,
this system call is also available if the kernel is configured with
.BR CONFIG_KCMP .
.SH NOTES
See
-.BR clone (2)
+.MR clone 2
for some background information on the shared resources
referred to on this page.
.SH EXAMPLES
@@ -416,5 +416,5 @@ main(void)
.EE
.\" SRC END
.SH SEE ALSO
-.BR clone (2),
-.BR unshare (2)
+.MR clone 2 ,
+.MR unshare 2