PAM_SHELLS(8)

  .SH "NAME" pam_shells - PAM module to check for valid login shell
  .SH "SYNOPSIS"
    .HP u
      pam_shells.so

  .SH "DESCRIPTION"

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

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

  .SH "OPTIONS"

    .PP This module does not recognise any options.

  .SH "MODULE TYPES PROVIDED"

    .PP The auth and account module types are provided.

  .SH "RETURN VALUES"

      .PP PAM_AUTH_ERR

              Access to the system was denied.

          .RE
          .PP PAM_SUCCESS

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

              .RE
              .PP PAM_USER_UNKNOWN

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

                  .RE
                  .PP PAM_SERVICE_ERR

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

                      .RE

                  .SH "EXAMPLES"

                    .PP
                    auth  required  pam_shells.so

                  .SH "SEE ALSO"

                    .PP shells(5), pam.conf(5), pam.d(5), pam(8)

                  .SH "AUTHOR"

                      .PP pam_shells was written by Erik Troan <ewt@redhat.com>.