pam_shells(8)

pam_shells8

Pam module to check for valid login shell

Usage

pam_shells.so

Overview

pam_shells is a PAM module that only allows access to the system if the user's shell is listed in /etc/shells.

It also checks if needed files (e.g. /etc/shells) are plain files and not world writable.

Options

This module does not recognise any options.

Module types provided

The auth and account module types are provided.

Return values

PAM_AUTH_ERR

Access to the system was denied.

PAM_SUCCESS

The user's login shell was listed as valid shell in /etc/shells.

PAM_USER_UNKNOWN

The user does not exist or the user's login shell could not be determined.

PAM_SERVICE_ERR

The module was not able to get the name of the user.

Examples

auth  required  pam_shells.so

Releases

12 releases since Debian 1.3 (Bo); the text changed 9 times.

  1. 1.3–2.0
  2. 5.0
  3. 6.0
  4. 7
  5. 8–9
  6. 10
  7. 11
  8. 12
  9. 13
  10. Arch

Author

pam_shells was written by Erik Troan <[email protected]>.

From pam 1.7.3-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.