aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorAlejandro Colomar <alx@kernel.org>2024-05-28 00:50:48 +0200
committerAlejandro Colomar <alx@kernel.org>2024-05-30 15:31:13 +0200
commitff173b4b57b565119cb253ba8110fddec7e4f07d (patch)
treeaec45f0f4deaa01c1ac44b71534b0e5930e91e60
parent851307f5d00346437cc1ae380c49130cea423ab2 (diff)
downloadman-pages-ff173b4b57b565119cb253ba8110fddec7e4f07d.tar.gz
PR_CAP_AMBIENT.2const, PR_CAP_AMBIENT_LOWER.2const: Split PR_CAP_AMBIENT_LOWER from PR_CAP_AMBIENT(2const)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
-rw-r--r--man/man2const/PR_CAP_AMBIENT.2const8
-rw-r--r--man/man2const/PR_CAP_AMBIENT_LOWER.2const46
2 files changed, 48 insertions, 6 deletions
diff --git a/man/man2const/PR_CAP_AMBIENT.2const b/man/man2const/PR_CAP_AMBIENT.2const
index 8ec23f8d88..4a9d236770 100644
--- a/man/man2const/PR_CAP_AMBIENT.2const
+++ b/man/man2const/PR_CAP_AMBIENT.2const
@@ -24,11 +24,8 @@ according to the value of
which must be one of the following:
.TP
.B PR_CAP_AMBIENT_RAISE
-.TP
+.TQ
.B PR_CAP_AMBIENT_LOWER
-The capability specified in
-.I cap
-is removed from the ambient capability set.
.TP
.B PR_CAP_AMBIENT_IS_SET
The
@@ -61,8 +58,6 @@ is not a valid value.
.B EINVAL
.I sub-op
is
-.BR PR_CAP_AMBIENT_LOWER ,
-or
.B PR_CAP_AMBIENT_IS_SET
and
.I cap
@@ -84,6 +79,7 @@ Linux 4.3.
.SH SEE ALSO
.BR prctl (2),
.BR PR_CAP_AMBIENT_RAISE (2const),
+.BR PR_CAP_AMBIENT_LOWER (2const),
.BR libcap (3),
.BR cap_get_ambient (3),
.BR cap_set_ambient (3),
diff --git a/man/man2const/PR_CAP_AMBIENT_LOWER.2const b/man/man2const/PR_CAP_AMBIENT_LOWER.2const
new file mode 100644
index 0000000000..c723b72771
--- /dev/null
+++ b/man/man2const/PR_CAP_AMBIENT_LOWER.2const
@@ -0,0 +1,46 @@
+.\" Copyright 2015, Michael Kerrisk <mtk.manpages@gmail.com>
+.\" Copyright 2024, Alejandro Colomar <alx@kernel.org>
+.\"
+.\" SPDX-License-Identifier: Linux-man-pages-copyleft
+.\"
+.TH PR_CAP_AMBIENT_LOWER 2const (date) "Linux man-pages (unreleased)"
+.SH NAME
+PR_CAP_AMBIENT_LOWER
+\-
+lower the ambient capability set of the calling thread
+.SH LIBRARY
+Standard C library
+.RI ( libc ", " \-lc )
+.SH SYNOPSIS
+.nf
+.B #include <sys/prctl.h>
+.P
+.BI "int prctl(PR_CAP_AMBIENT, PR_CAP_AMBIENT_LOWER, long " cap ", 0L, 0L);"
+.fi
+.SH DESCRIPTION
+The capability specified in
+.I cap
+is removed from the ambient capability set.
+.SH RETURN VALUE
+On success,
+0 is returned.
+On error, \-1 is returned, and
+.I errno
+is set to indicate the error.
+.SH ERRORS
+.TP
+.B EINVAL
+.I cap
+does not specify a valid capability.
+.SH VERSIONS
+See
+.BR PR_CAP_AMBIENT (2const).
+.SH STANDARDS
+Linux.
+.SH HISTORY
+Linux 4.3.
+.\" commit 58319057b7847667f0c9585b9de0e8932b0fdb08
+.SH SEE ALSO
+.BR prctl (2),
+.BR PR_CAP_AMBIENT (2const),
+.BR libcap (3)