Debian Codegraph @

upstream/opensuse-tumbleweed/man8/pam_sepermit.8

raw
1 '\" t
2 .\" Title: pam_sepermit
3 .\" Author: [see the "AUTHOR" section]
4 .\" Generator: DocBook XSL Stylesheets v1.79.2 <http://docbook.sf.net/>
5 .\" Date: 05/26/2026
6 .\" Manual: Linux-PAM Manual
7 .\" Source: Linux-PAM
8 .\" Language: English
9 .\"
10 .TH "PAM_SEPERMIT" "8" "05/26/2026" "Linux\-PAM" "Linux\-PAM Manual"
11 .\" -----------------------------------------------------------------
12 .\" * Define some portability stuff
13 .\" -----------------------------------------------------------------
14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15 .\" http://bugs.debian.org/507673
16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
18 .ie \n(.g .ds Aq \(aq
19 .el .ds Aq '
20 .\" -----------------------------------------------------------------
21 .\" * set default formatting
22 .\" -----------------------------------------------------------------
23 .\" disable hyphenation
24 .nh
25 .\" disable justification (adjust text to left margin only)
26 .ad l
27 .\" -----------------------------------------------------------------
28 .\" * MAIN CONTENT STARTS HERE *
29 .\" -----------------------------------------------------------------
30 .SH "NAME"
31 pam_sepermit \- PAM module to allow/deny login depending on SELinux enforcement state
32 .SH "SYNOPSIS"
33 .HP \w'\fBpam_sepermit\&.so\fR\ 'u
34 \fBpam_sepermit\&.so\fR [debug] [conf=\fI/path/to/config/file\fR]
35 .SH "DESCRIPTION"
36 .PP
37 The pam_sepermit module allows or denies login depending on SELinux enforcement state\&.
38 .PP
39 When the users which are logging in match an entry in the config file they are allowed access only when SELinux is in enforcing mode\&. Otherwise they are denied access\&. For users not matching any entry in the config file the pam_sepermit module returns PAM_IGNORE return value\&.
40 .PP
41 The config file contains a list of user names one per line with optional arguments\&. If the
42 \fIname\fR
43 is prefixed with
44 \fI@\fR
45 character it means that all users in the group
46 \fIname\fR
47 match\&. If it is prefixed with a
48 \fI%\fR
49 character the SELinux user is used to match against the
50 \fIname\fR
51 instead of the account name\&. Note that when SELinux is disabled the SELinux user assigned to the account cannot be determined\&. This means that such entries are never matched when SELinux is disabled and pam_sepermit will return PAM_IGNORE\&.
52 .PP
53 See
54 \fBsepermit.conf\fR(5)
55 for details\&.
56 .PP
57 If there is no explicitly specified configuration file and
58 /etc/security/sepermit\&.conf
59 does not exist,
60 /usr/etc/security/sepermit\&.conf
61 is used\&.
62 .SH "OPTIONS"
63 .PP
64 debug
65 .RS 4
66 Turns on debugging via
67 \fBsyslog\fR(3)\&.
68 .RE
69 .PP
70 conf=/path/to/config/file
71 .RS 4
72 Path to alternative config file overriding the default\&.
73 .RE
74 .SH "MODULE TYPES PROVIDED"
75 .PP
76 The
77 \fBauth\fR
78 and
79 \fBaccount\fR
80 module types are provided\&.
81 .SH "RETURN VALUES"
82 .PP
83 PAM_AUTH_ERR
84 .RS 4
85 SELinux is disabled or in the permissive mode and the user matches\&.
86 .RE
87 .PP
88 PAM_SUCCESS
89 .RS 4
90 SELinux is in the enforcing mode and the user matches\&.
91 .RE
92 .PP
93 PAM_IGNORE
94 .RS 4
95 The user does not match any entry in the config file\&.
96 .RE
97 .PP
98 PAM_USER_UNKNOWN
99 .RS 4
100 The module was unable to determine the user\*(Aqs name\&.
101 .RE
102 .PP
103 PAM_SERVICE_ERR
104 .RS 4
105 Error during reading or parsing the config file\&.
106 .RE
107 .SH "FILES"
108 .PP
109 /etc/security/sepermit\&.conf
110 .RS 4
111 Default configuration file
112 .RE
113 .SH "EXAMPLES"
114 .sp
115 .if n \{\
116 .RS 4
117 .\}
118 .nf
119 auth [success=done ignore=ignore default=bad] pam_sepermit\&.so
120 auth required pam_unix\&.so
121 account required pam_unix\&.so
122 session required pam_permit\&.so
123
124 .fi
125 .if n \{\
126 .RE
127 .\}
128 .SH "SEE ALSO"
129 .PP
130 \fBsepermit.conf\fR(5),
131 \fBpam.conf\fR(5),
132 \fBpam.d\fR(5),
133 \fBpam\fR(8)
134 \fBselinux\fR(8)
135 .SH "AUTHOR"
136 .PP
137 pam_sepermit and this manual page were written by Tomas Mraz <tmraz@redhat\&.com>\&.