| 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). |