Go to main content

man pages section 7: Standards, Environments, Macros, Character Sets, and Miscellany

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

pam_dial_auth(7)

Name

pam_dial_auth - authentication management PAM module for dialups

Synopsis

pam_dial_auth.so.1 

Description

The pam_dial_auth module implements pam_sm_authenticate(3PAM) which authenticates the user according to the dialups(5) and d_passwd(5) files configuration.

Authentication service modules must implement both pam_sm_authenticate() and pam_sm_setcred(). pam_sm_setcred() in this module always returns PAM_IGNORE.

The value of the PAM_TTY item is checked against entries in dialups(5). If there is a match, the user's shell is compared against entries in d_passwd(5). If there is a matching entry, the user is prompted for a password which is validated against the entry found.

The following option may be passed in to this service module:

debug

syslog(3C) debugging information at LOG_DEBUG level.

Errors

If dialups(5) is not present, PAM_IGNORE is returned. Upon successful completion of pam_sm_authenticate(), PAM_SUCCESS is returned. The following error codes are returned upon error:

PAM_AUTH_ERR

Authentication failure.

PAM_SERVICE_ERR

Error in the calling service, PAM_TTY is not set.

PAM_SYSTEM_ERR

System error (d_passwd(5) is not present).

PAM_USER_UNKNOWN

No account is present for user.

Attributes

See attributes(7) for a description of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
MT Level
MT-Safe with exceptions

See Also

libpam(3LIB), pam(3PAM), pam_authenticate(3PAM), pam_sm_authenticate(3PAM), d_passwd(5), dialups(5), pam.conf(5), attributes(7), pam_authtok_check(7), pam_authtok_get(7), pam_authtok_store(7), pam_dhkeys(7), pam_passwd_auth(7), pam_unix_account(7), pam_unix_auth(7), pam_unix_session(7)

Notes

The interfaces in libpam(3LIB) are MT-Safe only if each thread within the multi-threaded application uses its own PAM handle.