Debian Codegraph @

upstream/opensuse-tumbleweed/man8/pam_shells.8

raw
1 '\" t
2 .\" Title: pam_shells
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_SHELLS" "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_shells \- PAM module to check for valid login shell
32 .SH "SYNOPSIS"
33 .HP \w'\fBpam_shells\&.so\fR\ 'u
34 \fBpam_shells\&.so\fR
35 .SH "DESCRIPTION"
36 .PP
37 pam_shells is a PAM module that only allows access to the system if the user\*(Aqs shell is listed in
38 /etc/shells\&.
39 .PP
40 If this file does not exist, entries are taken from files
41 /usr/etc/shells,
42 /usr/etc/shells\&.d/*
43 and
44 /etc/shells\&.d/*
45 in that order\&.
46 .PP
47 It also checks if needed files (e\&.g\&.
48 /etc/shells) are plain files and not world writable\&.
49 .SH "OPTIONS"
50 .PP
51 This module does not recognise any options\&.
52 .SH "MODULE TYPES PROVIDED"
53 .PP
54 The
55 \fBauth\fR
56 and
57 \fBaccount\fR
58 module types are provided\&.
59 .SH "RETURN VALUES"
60 .PP
61 PAM_AUTH_ERR
62 .RS 4
63 Access to the system was denied\&.
64 .RE
65 .PP
66 PAM_SUCCESS
67 .RS 4
68 The user\*(Aqs login shell was listed as valid shell in
69 /etc/shells\&.
70 .RE
71 .PP
72 PAM_USER_UNKNOWN
73 .RS 4
74 The user does not exist or the user\*(Aqs login shell could not be determined\&.
75 .RE
76 .PP
77 PAM_SERVICE_ERR
78 .RS 4
79 The module was not able to get the name of the user\&.
80 .RE
81 .SH "EXAMPLES"
82 .PP
83 .if n \{\
84 .RS 4
85 .\}
86 .nf
87 auth required pam_shells\&.so
88
89 .fi
90 .if n \{\
91 .RE
92 .\}
93 .sp
94 .SH "SEE ALSO"
95 .PP
96 \fBshells\fR(5),
97 \fBpam.conf\fR(5),
98 \fBpam.d\fR(5),
99 \fBpam\fR(8)
100 .SH "AUTHOR"
101 .PP
102 pam_shells was written by Erik Troan <ewt@redhat\&.com>\&.