gen/NetBSD/utmpx.5.patch

   1 --- utmpx.5.orig        2004-09-20 17:32:52.000000000 -0700
   2 +++ utmpx.5     2005-12-26 11:25:30.000000000 -0800
   3 @@ -34,13 +34,11 @@
   4  .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
   5  .\" POSSIBILITY OF SUCH DAMAGE.
   6  .\"
   7 -.Dd September 26, 2002
   8 +.Dd Dec 26, 2005
   9  .Dt UTMPX 5
  10  .Os
  11  .Sh NAME
  12 -.Nm utmpx ,
  13 -.Nm wtmpx ,
  14 -.Nm lastlogx
  15 +.Nm utmpx
  16  .Nd user accounting database
  17  .Sh SYNOPSIS
  18  .In utmpx.h
  19 @@ -49,89 +47,51 @@
  20  .Aq Pa utmpx.h
  21  header defines the structures and functions for logging user.
  22  Currently logged in users are tracked in
  23 -.Pa /var/run/utmpx ,
  24 -a list of all logins and logouts, as well as all shutdowns, reboots
  25 -and date changes, is kept in
  26 -.Pa /var/log/wtmpx ,
  27 -and the last login of each user is noted in
  28 -.Pa /var/log/lastlogx .
  29 -The files are not automatically created if they do not exist; they
  30 -must be created manually.
  31 -.Pp
  32 +.Pa /var/run/utmpx .
  33  The interface to the
  34  .Nm utmpx
  35  file is described in
  36  .Xr endutxent 3 .
  37 +The file is not automatically created if they do not exist; it
  38 +must be created manually.
  39  .Pp
  40 -The
  41 -.Nm wtmpx
  42 -file can grow rapidly on busy systems, and is normally rotated with
  43 -.Xr newsyslog 8 .
  44 +Traditionally, separate files would be used to store the running log of
  45 +the logins and logouts
  46 +.Pf ( Pa wtmpx ) ,
  47 +and the last login of each user
  48 +.Pf ( Pa lastlogx ) .
  49 +With the availability of the Apple system log facility
  50 +.Xr asl 3 ,
  51 +these separate files can be replace with log entries, which are automatically
  52 +generated when
  53 +.Nm utmpx
  54 +entries are written.
  55 +The API to access the logins and logouts is described in
  56 +.Xr endutxent_wtmp 3
  57 +while the last login info is accessible with
  58 +.Xr getlastlogx 3 .
  59  .Pp
  60 -In the event of a date change, a shutdown, or a reboot, the following
  61 -items are logged in the
  62 -.Nm wtmpx
  63 -file:
  64 -.Bl -tag -width shutdownxx -compact -offset indent
  65 -.It Li date
  66 -The system time has been manually or automatically updated by
  67 -.Xr date 1 .
  68 -The command name
  69 -.Em date
  70 -is recorded in the field
  71 -.Fa ut_name .
  72 -In the field
  73 -.Fa ut_line ,
  74 -the character
  75 -.Ql \\*(Ba
  76 -indicates the time prior to the change, and the character
  77 -.Ql \&{
  78 -indicates the new time.
  79 -.It Li reboot
  80 -.It Li shutdown
  81 -A system reboot or shutdown has been initiated.
  82 -The character
  83 -.Ql \&~
  84 -is placed in the field
  85 -.Fa ut_line ,
  86 -and
  87 -.Li reboot
  88 -or
  89 -.Li shutdown
  90 -in the field
  91 -.Fa ut_name
  92 -(see
  93 -.Xr shutdown 8
  94 +For compatibility, changes to
  95 +.Nm utmpx
  96 +are reflected in
  97 +.Xr utmp 3
  98 +(in the
  99 +.Pa utmp ,
 100 +.Pa wtmp
 101  and
 102 -.Xr reboot 8 ) ,
 103 -using
 104 -.Xr logwtmpx 3 .
 105 -.Pp
 106 -.El
 107 +.Pa lastlog
 108 +files),
 109 +but not the other way around.
 110  .Sh FILES
 111 -.Bl -tag -width /var/log/lastlogx -compact
 112 +.Bl -tag -width /var/log/utmpx -compact
 113  .It Pa /var/run/utmpx
 114  The
 115  .Nm utmpx
 116  file.
 117 -.It Pa /var/log/wtmpx
 118 -The
 119 -.Nm wtmpx
 120 -file.
 121 -.It Pa /var/log/lastlogx
 122 -The
 123 -.Nm lastlogx
 124 -file.
 125  .El
 126  .Sh SEE ALSO
 127 -.Xr last 1 ,
 128 -.Xr login 1 ,
 129 -.Xr rwho 1 ,
 130 -.Xr w 1 ,
 131 -.Xr who 1 ,
 132 +.Xr asl 3 ,
 133  .Xr endutxent 3 ,
 134 -.Xr logwtmpx 3 ,
 135 -.Xr ac 8 ,
 136 -.Xr init 8 ,
 137 -.Xr newsyslog 8 ,
 138 -.Xr reboot 8
 139 +.Xr endutxent_wtmp 3 ,
 140 +.Xr getlastlogx 3 ,
 141 +.Xr utmp 5