From: Alejandro Colomar <alx@kernel.org>
Date: Tue, 28 May 2024 14:39:07 +0000 (+0200)
Subject: prctl.2, PR_GET_KEEPCAPS.2const: Split PR_GET_KEEPCAPS from prctl(2)
X-Git-Tag: man-pages-6.9~19^2~90
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=ca99b05aac06aa58da3fb4177cd2ef35fc0fe370;p=thirdparty%2Fman-pages.git

prctl.2, PR_GET_KEEPCAPS.2const: Split PR_GET_KEEPCAPS from prctl(2)

Signed-off-by: Alejandro Colomar <alx@kernel.org>
---

diff --git a/man/man2/prctl.2 b/man/man2/prctl.2
index e72635f33..99f65ca79 100644
--- a/man/man2/prctl.2
+++ b/man/man2/prctl.2
@@ -11,9 +11,6 @@
 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
 .\"
 .\" Modified Thu Nov 11 04:19:42 MET 1999, aeb: added PR_GET_PDEATHSIG
-.\" Modified 27 Jun 02, Michael Kerrisk
-.\" 	Added
-.\"	PR_GET_KEEPCAPS
 .\" Modified 2006-08-30 Guillem Jover <guillem@hadrons.org>
 .\"	Updated Linux versions where the options where introduced.
 .\"	Added PR_SET_TIMING, PR_GET_TIMING, PR_SET_NAME, PR_GET_NAME,
@@ -97,14 +94,8 @@ The first argument can be:
 .B PR_GET_IO_FLUSHER
 .TQ
 .B PR_SET_KEEPCAPS
-.\" prctl PR_GET_KEEPCAPS
-.TP
-.BR PR_GET_KEEPCAPS " (since Linux 2.2.18)"
-Return (as the function result) the current state of the calling thread's
-"keep capabilities" flag.
-See
-.BR capabilities (7)
-for a description of this flag.
+.TQ
+.B PR_GET_KEEPCAPS
 .\" prctl PR_MCE_KILL
 .TP
 .BR PR_MCE_KILL " (since Linux 2.6.32)"
@@ -1637,7 +1628,6 @@ of the calling process.
 for information on the protection mask bits.)
 .SH RETURN VALUE
 On success,
-.BR PR_GET_KEEPCAPS ,
 .BR PR_MCE_KILL_GET ,
 .BR PR_GET_NO_NEW_PRIVS ,
 .BR PR_GET_SECUREBITS ,
@@ -2002,4 +1992,5 @@ glibc 2.0.6
 .BR PR_SET_IO_FLUSHER (2const),
 .BR PR_GET_IO_FLUSHER (2const),
 .BR PR_SET_KEEPCAPS (2const),
+.BR PR_GET_KEEPCAPS (2const),
 .BR core (5)
diff --git a/man/man2const/PR_GET_KEEPCAPS.2const b/man/man2const/PR_GET_KEEPCAPS.2const
new file mode 100644
index 000000000..3b09d8fc5
--- /dev/null
+++ b/man/man2const/PR_GET_KEEPCAPS.2const
@@ -0,0 +1,43 @@
+.\" Copyright 2002, 2006, 2008, 2012, 2013, 2015, Michael Kerrisk <mtk.manpages@gmail.com>
+.\"
+.\" SPDX-License-Identifier: Linux-man-pages-copyleft
+.\"
+.\" Modified 27 Jun 02, Michael Kerrisk
+.\" 	Added
+.\"	PR_GET_KEEPCAPS
+.\"
+.TH PR_GET_KEEPCAPS 2const (date) "Linux man-pages (unreleased)"
+.SH NAME
+PR_GET_KEEPCAPS
+\-
+get the state of the "keep capabilities" flag
+.SH LIBRARY
+Standard C library
+.RI ( libc ", " \-lc )
+.SH SYNOPSIS
+.nf
+.B #include <sys/prctl.h>
+.P
+.BI "int prctl(int " op ", ...);"
+.fi
+.SH DESCRIPTION
+.TP
+.BR PR_GET_KEEPCAPS " (since Linux 2.2.18)"
+Return (as the function result) the current state of the calling thread's
+"keep capabilities" flag.
+See
+.BR capabilities (7)
+for a description of this flag.
+.SH RETURN VALUE
+On success,
+.BR PR_GET_KEEPCAPS ,
+return the nonnegative values described above.
+On error, \-1 is returned, and
+.I errno
+is set to indicate the error.
+.SH STANDARDS
+Linux.
+.SH HISTORY
+.SH SEE ALSO
+.BR signal (2),
+.BR PR_SET_KEEPCAPS (2const)