Debian Codegraph @

upstream/debian-unstable/man2/PR_CAP_AMBIENT_LOWER.2const

raw
1 .\" Copyright 2015, Michael Kerrisk <[email protected]>
2 .\" Copyright, the authors of the Linux man-pages project
3 .\"
4 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
5 .\"
6 .TH PR_CAP_AMBIENT_LOWER 2const 2026-02-08 "Linux man-pages 6.18"
7 .SH NAME
8 PR_CAP_AMBIENT_LOWER
9 \-
10 lower the ambient capability set of the calling thread
11 .SH LIBRARY
12 Standard C library
13 .RI ( libc ,\~ \-lc )
14 .SH SYNOPSIS
15 .nf
16 .BR "#include <linux/prctl.h>" " /* Definition of " PR_* " constants */"
17 .B #include <sys/prctl.h>
18 .P
19 .BI "int prctl(PR_CAP_AMBIENT, PR_CAP_AMBIENT_LOWER, long " cap ", 0L, 0L);"
20 .fi
21 .SH DESCRIPTION
22 The capability specified in
23 .I cap
24 is removed from the ambient capability set.
25 .SH RETURN VALUE
26 On success,
27 0 is returned.
28 On error, \-1 is returned, and
29 .I errno
30 is set to indicate the error.
31 .SH ERRORS
32 .TP
33 .B EINVAL
34 .I cap
35 does not specify a valid capability.
36 .SH VERSIONS
37 See
38 .BR PR_CAP_AMBIENT (2const).
39 .SH STANDARDS
40 Linux.
41 .SH HISTORY
42 Linux 4.3.
43 .\" commit 58319057b7847667f0c9585b9de0e8932b0fdb08
44 .SH SEE ALSO
45 .BR prctl (2),
46 .BR PR_CAP_AMBIENT (2const),
47 .BR libcap (3)