[11/39] kcmp.2: Use syscall(SYS_...); for system calls without a wrapper

Message ID 20210510175546.28445-12-alx.manpages@gmail.com
State New
Headers show
Series
  • man2: SYNOPSIS: Fix headers, use syscall(), and other fixes
Related show

Commit Message

Mark Brown via Libc-alpha May 10, 2021, 5:55 p.m.
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

---
 man2/kcmp.2 | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)

-- 
2.31.1

Patch

diff --git a/man2/kcmp.2 b/man2/kcmp.2
index 3cc7f7d6f..b0994758a 100644
--- a/man2/kcmp.2
+++ b/man2/kcmp.2
@@ -30,14 +30,19 @@ 
 kcmp \- compare two processes to determine if they share a kernel resource
 .SH SYNOPSIS
 .nf
-.B #include <linux/kcmp.h>
+.BR "#include <linux/kcmp.h>" "       /* Definition of " KCMP_* " constants */"
+.BR "#include <sys/syscall.h>" "      /* Definition of " SYS_* " constants */"
+.B #include <unistd.h>
 .PP
-.BI "int kcmp(pid_t " pid1 ", pid_t " pid2 ", int " type ,
-.BI "         unsigned long " idx1 ", unsigned long "  idx2 );
+.BI "int syscall(SYS_kcmp, pid_t " pid1 ", pid_t " pid2 ", int " type ,
+.BI "            unsigned long " idx1 ", unsigned long "  idx2 );
 .fi
 .PP
 .IR Note :
-There is no glibc wrapper for this system call; see NOTES.
+glibc provides no wrapper for
+.BR kcmp (),
+necessitating the use of
+.BR syscall (2).
 .SH DESCRIPTION
 The
 .BR kcmp ()
@@ -303,9 +308,6 @@  system call first appeared in Linux 3.5.
 .BR kcmp ()
 is Linux-specific and should not be used in programs intended to be portable.
 .SH NOTES
-Glibc does not provide a wrapper for this system call; call it using
-.BR syscall (2).
-.PP
 Before Linux 5.12,
 this system call is available only if the kernel is configured with
 .BR CONFIG_CHECKPOINT_RESTORE ,