Go to main content

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

Exit Print View

Updated: Wednesday, August 8, 2018
 
 

pam_unix_session(7)

Name

pam_unix_session - session management PAM module for UNIX

Synopsis

pam_unix_session.so.1

Description

The pam_unix_session module implements pam_sm_open_session(3PAM) and pam_sm_close_session(3PAM).

pam_sm_open_session() reads the /var/adm/lastlog file to retrieve the last login time for the user and displays a PAM_TEXT_INFO message using the current PAM conversation function to display the time and date of the last login of the user. The format of the message is in either one of the following formats:

Last login: Wed Sep 17 14:57:54 2014 from abc.example.com
Last login: Wed Sep 17 14:57:54 2014 on /dev/console

pam_sm_open_session() also updates the /var/adm/lastlog file with the information contained in the PAM_USER, PAM_TTY, and PAM_RHOST items. pam_unix_account(7) uses this information to determine the previous time the user logged in when checking for account inactivity.

pam_sm_close_session() is a null function.

The following options can be passed to the module:

debug

syslog(3C) debugging information at the LOG_DEBUG level

nowarn

Disables any error messages or warnings including the last login PAM_TEXT_INFO message.

Errors

Upon successful completion, PAM_SUCCESS is returned. The following error codes are returned upon error:

PAM_SESSION_ERR

Cannot make or remove the entry for the specified session (PAM_TTY is not present).

PAM_USER_UNKNOWN

No account is present for user.

Attributes

See attributes(7) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Interface Stability
Committed
MT Level
MT-Safe with exceptions

See Also

syslog(3C), libpam(3LIB), pam(3PAM), pam_authenticate(3PAM), nsswitch.conf(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),

Notes

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