summaryrefslogtreecommitdiff
path: root/modules/pam_lastlog/pam_lastlog.8
diff options
context:
space:
mode:
Diffstat (limited to 'modules/pam_lastlog/pam_lastlog.8')
-rw-r--r--modules/pam_lastlog/pam_lastlog.8113
1 files changed, 113 insertions, 0 deletions
diff --git a/modules/pam_lastlog/pam_lastlog.8 b/modules/pam_lastlog/pam_lastlog.8
new file mode 100644
index 00000000..e822c84b
--- /dev/null
+++ b/modules/pam_lastlog/pam_lastlog.8
@@ -0,0 +1,113 @@
+.\" Title: pam_lastlog
+.\" Author:
+.\" Generator: DocBook XSL Stylesheets v1.73.1 <http://docbook.sf.net/>
+.\" Date: 04/16/2008
+.\" Manual: Linux-PAM Manual
+.\" Source: Linux-PAM Manual
+.\"
+.TH "PAM_LASTLOG" "8" "04/16/2008" "Linux-PAM Manual" "Linux\-PAM Manual"
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+pam_lastlog - PAM module to display date of last login
+.SH "SYNOPSIS"
+.HP 15
+\fBpam_lastlog\.so\fR [debug] [silent] [never] [nodate] [nohost] [noterm] [nowtmp]
+.SH "DESCRIPTION"
+.PP
+pam_lastlog is a PAM module to display a line of information about the last login of the user\. In addition, the module maintains the
+\fI/var/log/lastlog\fR
+file\.
+.PP
+Some applications may perform this function themselves\. In such cases, this module is not necessary\.
+.SH "OPTIONS"
+.PP
+\fBdebug\fR
+.RS 4
+Print debug information\.
+.RE
+.PP
+\fBsilent\fR
+.RS 4
+Don\'t inform the user about any previous login, just upate the
+\fI/var/log/lastlog\fR
+file\.
+.RE
+.PP
+\fBnever\fR
+.RS 4
+If the
+\fI/var/log/lastlog\fR
+file does not contain any old entries for the user, indicate that the user has never previously logged in with a welcome message\.
+.RE
+.PP
+\fBnodate\fR
+.RS 4
+Don\'t display the date of the last login\.
+.RE
+.PP
+\fBnoterm\fR
+.RS 4
+Don\'t display the terminal name on which the last login was attempted\.
+.RE
+.PP
+\fBnohost\fR
+.RS 4
+Don\'t indicate from which host the last login was attempted\.
+.RE
+.PP
+\fBnowtmp\fR
+.RS 4
+Don\'t update the wtmp entry\.
+.RE
+.SH "MODULE SERVICES PROVIDED"
+.PP
+Only the
+\fBsession\fR
+service is supported\.
+.SH "RETURN VALUES"
+.PP
+.PP
+PAM_SUCCESS
+.RS 4
+Everything was successfull\.
+.RE
+.PP
+PAM_SERVICE_ERR
+.RS 4
+Internal service module error\.
+.RE
+.PP
+PAM_USER_UNKNOWN
+.RS 4
+User not known\.
+.RE
+.SH "EXAMPLES"
+.PP
+Add the following line to
+\fI/etc/pam\.d/login\fR
+to display the last login time of an user:
+.sp
+.RS 4
+.nf
+ session required pam_lastlog\.so nowtmp
+
+.fi
+.RE
+.SH "FILES"
+.PP
+\fI/var/log/lastlog\fR
+.RS 4
+Lastlog logging file
+.RE
+.SH "SEE ALSO"
+.PP
+
+\fBpam.conf\fR(5),
+\fBpam.d\fR(8),
+\fBpam\fR(8)
+.SH "AUTHOR"
+.PP
+pam_lastlog was written by Andrew G\. Morgan <morgan@kernel\.org>\.