From be428596d52d1ac18eece9f5aa8e0a17588ea76e Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Fri, 21 Oct 2016 09:42:13 +0200 Subject: [PATCH] keyctl.2: Add notes on libkeyutils wrapper functions Signed-off-by: Michael Kerrisk --- man2/keyctl.2 | 18 +++++++++++------- 1 file changed, 11 insertions(+), 7 deletions(-) diff --git a/man2/keyctl.2 b/man2/keyctl.2 index bee5ae131..1d678a4c2 100644 --- a/man2/keyctl.2 +++ b/man2/keyctl.2 @@ -28,6 +28,8 @@ keyctl \- manipulate the kernel's key management facility .BI " __kernel_ulong_t " arg3 ", __kernel_ulong_t " arg4 , .BI " __kernel_ulong_t " arg5 ); .fi + +No glibc wrapper is provided for this system call; see NOTES. .SH DESCRIPTION .BR keyctl () allows user-space programs to perform key manipulation. @@ -1458,13 +1460,15 @@ This system call first appeared in Linux 2.6.11. .SH CONFORMING TO This system call is a nonstandard Linux extension. .SH NOTES -Although this is a Linux system call, it is not present in -.I libc -but can be found rather in -.IR libkeyutils . -When linking, -.B \-lkeyutils -should be specified to the linker. +No wrapper for this system call is provided in glibc. +A wrapper is provided in the +.IR libkeyutils +package. +When employing the wrapper in that library, link with +.IR \-lkeyutils . +However, rather than using this system call directly, +you probably want to use the various library functions +mentioned in the descriptions of individual operations above. .SH SEE ALSO .ad l .nh