usr.bin/last/last.1

   1 .\"     $NetBSD: last.1,v 1.9 2002/09/30 11:09:04 grant Exp $
   2 .\"
   3 .\" Copyright (c) 1980, 1990, 1993
   4 .\"     The Regents of the University of California.  All rights reserved.
   5 .\"
   6 .\" Redistribution and use in source and binary forms, with or without
   7 .\" modification, are permitted provided that the following conditions
   8 .\" are met:
   9 .\" 1. Redistributions of source code must retain the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer.
  11 .\" 2. Redistributions in binary form must reproduce the above copyright
  12 .\"    notice, this list of conditions and the following disclaimer in the
  13 .\"    documentation and/or other materials provided with the distribution.
  14 .\" 3. All advertising materials mentioning features or use of this software
  15 .\"    must display the following acknowledgement:
  16 .\"     This product includes software developed by the University of
  17 .\"     California, Berkeley and its contributors.
  18 .\" 4. Neither the name of the University nor the names of its contributors
  19 .\"    may be used to endorse or promote products derived from this software
  20 .\"    without specific prior written permission.
  21 .\"
  22 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  23 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  24 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  25 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  26 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  27 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  28 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  29 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  30 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  31 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  32 .\" SUCH DAMAGE.
  33 .\"
  34 .\"     @(#)last.1      8.1 (Berkeley) 6/6/93
  35 .\"
  36 .Dd June 6, 1993
  37 .Dt LAST 1
  38 .Os
  39 .Sh NAME
  40 .Nm last
  41 .Nd indicate last logins of users and ttys
  42 .Sh SYNOPSIS
  43 .Nm
  44 .Op Fl Ns Ar n
  45 .Op Fl T
  46 .Op Fl f Ar file
  47 .Op Fl h Ar host
  48 .Op Fl t Ar tty
  49 .Op Fl L Ar linesize
  50 .Op Fl N Ar namesize
  51 .Op Fl H Ar hostsize
  52 .Op user ...
  53 .Sh DESCRIPTION
  54 .Nm
  55 will list the sessions of specified
  56 .Ar users ,
  57 .Ar ttys ,
  58 and
  59 .Ar hosts ,
  60 in reverse time order.
  61 Each line of output contains
  62 the user name, the tty from which the session was conducted, any
  63 hostname, the start and stop times for the session, and the duration
  64 of the session.
  65 If the session is still continuing or was cut short by
  66 a crash or shutdown,
  67 .Nm
  68 will so indicate.
  69 .Pp
  70 .Bl -tag -width indent-two
  71 .It Fl f Ar file
  72 .Nm
  73 reads the file
  74 .Ar file
  75 instead of the default,
  76 .Pa /var/log/wtmpx
  77 or
  78 .Pa /var/log/wtmp .
  79 If the file ends with `x', it is treated as a
  80 .Xr utmpx 5
  81 format file, else it is treated as a
  82 .Xr utmp 5
  83 format file.
  84 .It Fl Ar n
  85 Limits the report to
  86 .Ar n
  87 lines.
  88 .It Fl t Ar tty
  89 Specify the
  90 .Ar tty .
  91 Tty names may be given fully or abbreviated, for example,
  92 .Dq Li "last -t 03"
  93 is
  94 equivalent to
  95 .Dq Li "last -t tty03" .
  96 .It Fl h Ar host
  97 .Ar Host
  98 names may be names or internet numbers.
  99 .It Fl T
 100 Display better time information, including the year and seconds.
 101 .It Fl L Ar linesize
 102 Use the provided linesize as the width to format the tty field.
 103 .It Fl N Ar namesize
 104 Use the provided namesize as the width to format the login name field.
 105 .It Fl H Ar hostsize
 106 Use the provided hostsize as the width to format the host name field.
 107 .El
 108 .Pp
 109 If
 110 multiple arguments are given, the information which applies to any of the
 111 arguments is printed, e.g.,
 112 .Dq Li "last root -t console"
 113 would list all of
 114 .Dq Li root Ns 's
 115 sessions as well as all sessions on the console terminal.
 116 If no users, hostnames or terminals are specified,
 117 .Nm
 118 prints a record of
 119 all logins and logouts.
 120 .Pp
 121 The pseudo-user
 122 .Ar reboot
 123 logs in at reboots of the system, thus
 124 .Dq Li last reboot
 125 will give an indication of mean time between reboot.
 126 .Pp
 127 If
 128 .Nm
 129 is interrupted, it indicates to what date the search has
 130 progressed.
 131 If interrupted with a quit signal
 132 .Nm
 133 indicates how
 134 far the search has progressed and then continues.
 135 .Sh FILES
 136 .Bl -tag -width /var/log/wtmpx -compact
 137 .It Pa /var/log/wtmpx
 138 login data base
 139 .It Pa /var/log/wtmp
 140 login data base
 141 .El
 142 .Sh SEE ALSO
 143 .Xr lastcomm 1 ,
 144 .Xr utmpx 5 ,
 145 .Xr utmp 5 ,
 146 .Xr ac 8
 147 .Sh HISTORY
 148 .Nm
 149 appeared in
 150 .Bx 3.0 .