NAME | SYNOPSIS | DESCRIPTION | OPTIONS | NOTE | FILES | CAVEATS | COLOPHON

LASTLOG(8)               System Management Commands               LASTLOG(8)

NAME         top

       lastlog - reports the most recent login of all users or of a given
       user

SYNOPSIS         top

       lastlog [options]

DESCRIPTION         top

       lastlog formats and prints the contents of the last login log
       /var/log/lastlog file. The login-name, port, and last login time will
       be printed. The default (no flags) causes lastlog entries to be
       printed, sorted by their order in /etc/passwd.

OPTIONS         top

       The options which apply to the lastlog command are:

       -b, --before DAYS
           Print only lastlog records older than DAYS.

       -C, --clear
           Clear lastlog record of a user. This option can be used only
           together with -u (--user)).

       -h, --help
           Display help message and exit.

       -R, --root CHROOT_DIR
           Apply changes in the CHROOT_DIR directory and use the
           configuration files from the CHROOT_DIR directory.

       -S, --set
           Set lastlog record of a user to the current time. This option can
           be used only together with -u (--user)).

       -t, --time DAYS
           Print the lastlog records more recent than DAYS.

       -u, --user LOGIN|RANGE
           Print the lastlog record of the specified user(s).

           The users can be specified by a login name, a numerical user ID,
           or a RANGE of users. This RANGE of users can be specified with a
           min and max values (UID_MIN-UID_MAX), a max value (-UID_MAX), or
           a min value (UID_MIN-).

       If the user has never logged in the message ** Never logged in** will
       be displayed instead of the port and time.

       Only the entries for the current users of the system will be
       displayed. Other entries may exist for users that were deleted
       previously.

NOTE         top

       The lastlog file is a database which contains info on the last login
       of each user. You should not rotate it. It is a sparse file, so its
       size on the disk is usually much smaller than the one shown by "ls
       -l" (which can indicate a really big file if you have in passwd users
       with a high UID). You can display its real size with "ls -s".

FILES         top

       /var/log/lastlog
           Database times of previous user logins.

CAVEATS         top

       Large gaps in UID numbers will cause the lastlog program to run
       longer with no output to the screen (i.e. if in lastlog database
       there is no entries for users with UID between 170 and 800 lastlog
       will appear to hang as it processes entries with UIDs 171-799).

COLOPHON         top

       This page is part of the shadow-utils (utilities for managing
       accounts and shadow password files) project.  Information about the
       project can be found at ⟨http://pkg-shadow.alioth.debian.org/⟩.  If
       you have a bug report for this manual page, see 
       ⟨http://pkg-shadow.alioth.debian.org/getinvolved.php⟩.  This page was
       obtained from the project's upstream Git repository 
       ⟨git://anonscm.debian.org/git/pkg-shadow/shadow.git⟩ on 2017-09-15.
       If you discover any rendering problems in this HTML version of the
       page, or you believe there is a better or more up-to-date source for
       the page, or you have corrections or improvements to the information
       in this COLOPHON (which is not part of the original manual page),
       send a mail to man-pages@man7.org

shadow-utils 4.4                 09/15/2017                       LASTLOG(8)