keyctl.2: Add notes on libkeyutils wrapper functions

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2016-10-21 09:42:13 +02:00
parent 57ce8d0fe3
commit be428596d5
1 changed files with 11 additions and 7 deletions

View File

@ -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 " arg3 ", __kernel_ulong_t " arg4 ,
.BI " __kernel_ulong_t " arg5 ); .BI " __kernel_ulong_t " arg5 );
.fi .fi
No glibc wrapper is provided for this system call; see NOTES.
.SH DESCRIPTION .SH DESCRIPTION
.BR keyctl () .BR keyctl ()
allows user-space programs to perform key manipulation. 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 .SH CONFORMING TO
This system call is a nonstandard Linux extension. This system call is a nonstandard Linux extension.
.SH NOTES .SH NOTES
Although this is a Linux system call, it is not present in No wrapper for this system call is provided in glibc.
.I libc A wrapper is provided in the
but can be found rather in .IR libkeyutils
.IR libkeyutils . package.
When linking, When employing the wrapper in that library, link with
.B \-lkeyutils .IR \-lkeyutils .
should be specified to the linker. 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 .SH SEE ALSO
.ad l .ad l
.nh .nh