docs/54200: [PATCH] utmp.5 needs to reflect pam changes

[Matthew George]

>Number:         54200
>Category:       docs
>Synopsis:       [PATCH] utmp.5 needs to reflect pam changes
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Jul 07 16:10:21 PDT 2003
>Closed-Date:
>Last-Modified:
>Originator:     Matthew George <mdg at secureworks.net>
>Release:        FreeBSD 5.1-RELEASE i386
>Organization:
>Environment:
System: FreeBSD mdg.secureworks.net 5.1-RELEASE FreeBSD 5.1-RELEASE #2: Tue Jun 10 11:13:46 EDT 2003 mdg at mdg.secureworks.net:/usr/src/sys/i386/compile/GENERIC i386


>Description:
	utmp.5 still has several references to login(1), although in 5.x and later lastlog/utmp/wtmp
	manipulation is performed via pam_lastlog(8).

>How-To-Repeat:
>Fix:

Index: utmp.5
===================================================================
RCS file: /home/ncvs/src/share/man/man5/utmp.5,v
retrieving revision 1.19
diff -u -r1.19 utmp.5
--- utmp.5	4 Oct 2002 00:25:50 -0000	1.19
+++ utmp.5	7 Jul 2003 22:36:11 -0000
@@ -100,20 +100,17 @@
 structures and is a binary log file,
 that is, grows linearly at its end.
 .Pp
-Each time a user logs in, the
-.Xr login 1
+By default, each time a user logs in, the
+.Xr pam_lastlog 8
 program looks up the user's
 .Tn UID
 in the file
 .Nm lastlog .
 If it is found, the timestamp of the last time the user logged
 in, the terminal line and the hostname
-are written to the standard output (unless the login is
-.Em quiet ,
-see
-.Xr login 1 ) .
+are written to the standard output.
 The
-.Xr login 1
+.Xr pam_lastlog 8
 program then records the new login time in the file
 .Nm lastlog .
 .Pp
@@ -140,7 +137,7 @@
 .Xr who 1 .
 .Pp
 Next, the
-.Xr login 1
+.Xr pam_lastlog 8
 program opens the file
 .Nm wtmp ,
 and appends the user's
@@ -216,7 +213,7 @@
 .Xr newsyslog 8 .
 .Pp
 If any one of these files does not exist, it is not created by
-.Xr login 1 .
+.Xr pam_lastlog 8 .
 They must be created manually.
 .Pp
 The supplied
@@ -248,7 +245,6 @@
 .El
 .Sh SEE ALSO
 .Xr last 1 ,
-.Xr login 1 ,
 .Xr w 1 ,
 .Xr who 1 ,
 .Xr login 3 ,
@@ -256,7 +252,8 @@
 .Xr logwtmp 3 ,
 .Xr ttyslot 3 ,
 .Xr ac 8 ,
-.Xr init 8
+.Xr init 8,
+.Xr pam_lastlog 8
 .Sh HISTORY
 A
 .Nm


-- 
Matthew George
SecureWorks Technical Operations

>Release-Note:
>Audit-Trail:
>Unformatted: