Debian Codegraph @

doc/capability.conf.5

raw
1 .\" generated with Ronn-NG/v0.9.1
2 .\" http://github.com/apjanke/ronn-ng/tree/0.9.1
3 .TH "CAPABILITY\.CONF" "5" "2025-03-19" ""
4 .SH "NAME"
5 \fBcapability\.conf\fR \- pam_cap module configuration file
6 .SH "SYNOPSIS"
7 \fB/etc/security/capability\.conf\fR
8 .SH "DESCRIPTION"
9 The syntax for lines in this configuration file is:
10 .P
11 \fB# <\-\- \'#\' precedes a comment\fR
12 .P
13 \fB<IAB><SPACE><WHO>\fR
14 .P
15 Where \fB<IAB>\fR refers to the text format for an inheritable IAB
16 capability tuple, see
17 .BR cap_text_formats (7)
18 , or the words \fBall\fR or \fBnone\fR\.
19 .P
20 The reserved word \fBall\fR does \fInot\fR grant \fIall the
21 inheritable capabilities\fR, but acts as a simple \fIpass\-through\fR
22 for any prevailing IAB tuple capabilities\. The reserved word
23 \fBnone\fR refers to an empty \fIInheritable\fR capability set (and by
24 extension an empty \fIAmbient\fR vector)\.
25 .P
26 Here \fB<WHO>\fR refers to the space separated PAM username values
27 that will be granted the specified \fIIAB\fR tuple\. A name prefixed
28 with the character \fB@\fR refers to the locally defined
29 \fB/etc/group\fR \fIetc\fR users listed under that group name\. An
30 asterisk "\fB*\fR" can be used to denote all users\.
31 .P
32 The parsing of the file chooses the first line that applies to the
33 authenticating user, and attempts to apply that and only that\.
34 .P
35 Examples of valid syntax are:
36 .IP "" 4
37 .nf
38 # only root gets to keep what it had
39 all root
40
41 # this should fire for user beta only, who will have
42 # cap_chown dropped from their bounding set\.
43 !cap_chown beta
44
45 # the next one should snag the members of the \'three\' group
46 # granting them cap_setuid and cap_chown
47 cap_setuid,cap_chown @three
48
49 # this would apply to beta and gamma, but beta is already
50 # granted a lack of cap_chown above\. Further, if gamma is
51 # in the \'three\' group, it would not reach this line\.
52 cap_chown beta gamma
53
54 # members of the \'one\' group are granted the cap_setuid Inheritable
55 # capability, but cap_chown is dropped from their bounding set\.
56 !cap_chown,cap_setuid @one
57
58 # user alpha gets an ambient capability (unless it is also
59 # a member of the groups \'one\' or \'three\')\.
60 ^cap_setuid alpha
61
62 # user delta (if not a member of groups \'one\' and \'three\') will get
63 # cap_chown and cap_setgid Ambient capabilities, but have cap_setuid
64 # dropped from its bounding set\.
65 ^cap_chown,^cap_setgid,!cap_setuid delta
66
67 # any remaining members of group \'four\' will get the cap_setuid
68 # Inheritable capability\.
69 cap_setuid @four
70 .fi
71 .IP "" 0
72 .SH "SEE ALSO"
73 .BR pam_cap (8),
74 .BR cap_iab (3),
75 .BR cap_text_formats (7).