# lslogins

## NAME



           lslogins - display information about known users in the system
    


## SYNOPSIS



           **lslogins**[options] [**-s** |**-u**[**=**_UID_]] [**-g** _groups_] [**-l** _logins_]
           [_username_]
    


## DESCRIPTION



           Examine the wtmp and btmp logs, _/etc/shadow_ (if necessary) and
           _/passwd_ and output the desired data.
    
           The optional argument _username_ forces **lslogins** to print all
           available details about the specified user only. In this case the
           output format is different than in case of **-l** or **-g** and unknown is
           _username_ reported as an error.
    
           The default action is to list info about all the users in the
           system.
    


## OPTIONS



           Mandatory arguments to long options are mandatory for short
           options too.
    
           **-a** , **--acc-expiration**
               Display data about the date of last password change and the
               account expiration date (see shadow(5) for more info).
               (Requires root privileges.)
    
           **--btmp-file** _path_
               Alternate path for btmp.
    
           **-c** , **--colon-separate**
               Separate info about each user with a colon instead of a
               newline.
    
           **-e** , **--export**
               Output data in the format of NAME=VALUE. See also option
               **--shell**.
    
           **-f** , **--failed**
               Display data about the users' last failed login attempts.
    
           **-G** , **--supp-groups**
               Show information about supplementary groups.
    
           **-g** , **--groups** _groups_
               Only show data of users belonging to _groups_. More than one
               group may be specified; the list has to be comma-separated.
               Unknown group names are ignored.
    
               Note that the relation between user and group may be invisible
               for the primary group if the user is not explicitly specified
               as group member (e.g., in _/etc/group_). If the command **lslogins**
               scans for groups then it uses the groups database only, and
               the user database with primary GID is not used at all.
    
           **-L** , **--last**
               Display data containing information about the users' last
               login sessions.
    
           **-l** , **--logins** _logins_
               Only show data of users with a login specified in _logins_ (user
               names or user IDs). More than one login may be specified; the
               list has to be comma-separated. Unknown login names are
               ignored.
    
           **-n** , **--newline**
               Display each piece of information on a separate line.
    
           **--noheadings**
               Do not print a header line.
    
           **--notruncate**
               Don’t truncate output.
    
           **-o** , **--output** _list_
               Specify which output columns to print. The default list of
               columns may be extended if _list_ is specified in the format
               _+list_.
    
           **--output-all**
               Output all available columns. **--help** to get a list of all
               supported columns.
    
           **-p** , **--pwd**
               Display information related to login by password (see also
               **-afL**).
    
           **-r** , **--raw**
               Raw output (no columnation).
    
           **-s** , **--system-accs**
               Show system accounts. These are by default all accounts with a
               UID between 101 and 999 (inclusive), with the exception of
               either nobody or nfsnobody (UID 65534). This hardcoded default
               may be overridden by the parameters **SYS_UID_MIN** and
               **SYS_UID_MAX** in the file _/etc/login.defs_.
    
           **--time-format** _type_
               Display dates in short, full or iso format. The default is
               short, this time format is designed to be space efficient and
               human readable.
    
           **-u** , **--user-accs**
               Show user accounts. These are by default all accounts with a
               UID above 1000 (inclusive), with the exception of either
               nobody or nfsnobody (UID 65534). This hardcoded default may be
               overridden by the parameters **UID_MIN** and **UID_MAX** in the file
               _/etc/login.defs_.
    
           **-h** , **--help**
               Display help text and exit.
    
           **-V** , **--version**
               Display version and exit.
    
           **--wtmp-file** _path_
               Alternate path for wtmp.
    
           **--lastlog** _path_
               Alternate path for lastlog(8).
    
           **-y** , **--shell**
               The column name will be modified to contain only characters
               allowed for shell variable identifiers. This is usable, for
               example, with **--export**. Note that this feature has been
               automatically enabled for **--export** in version 2.37, but due to
               compatibility issues, now it’s necessary to request this
               behavior by **--shell**.
    
           **-Z** , **--context**
               Display the users' security context.
    
           **-z** , **--print0**
               Delimit user entries with a nul character, instead of a
               newline.
    


## EXIT STATUS



           0
               if OK,
    
           1
               if incorrect arguments specified,
    
           2
               if a serious error occurs (e.g., a corrupt log).
    


## NOTES



           The default UID thresholds are read from _/etc/login.defs_.
    
       **Password status**
           Multiple fields describe password status.
    
           **"Password is locked"**
               The password is prefixed by '!!', and the user cannot login
               although the password is set or empty. This is common for new
               accounts without a set password.
    
           **"Password not required (empty)"**
               The password is not set (hash is missing); this is common for
               locked system accounts. Not requiring a password does not mean
               the user can log-in without a password. It depends on the
               password "lock" status.
    
           **"Login by password disabled"**
               'yes' means that there is no valid password. The password hash
               is missing, or the hash method is unknown or contains invalid
               chars.
    


## AVAILABILITY



           The **lslogins** command is part of the util-linux package which can
           be downloaded from Linux Kernel Archive
           <https://www.kernel.org/pub/linux/utils/util-linux/>. This page is
           part of the _util-linux_ (a random collection of Linux utilities)
           project. Information about the project can be found at 
           ⟨https://www.kernel.org/pub/linux/utils/util-linux/⟩. If you have a
           bug report for this manual page, send it to
           util-linux@vger.kernel.org. This page was obtained from the
           project's upstream Git repository
           ⟨git://git.kernel.org/pub/scm/utils/util-linux/util-linux.git⟩ on
           2025-08-11. (At that time, the date of the most recent commit that
           was found in the repository was 2025-08-05.) 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
    
    util-linux 2.42-start-521-ec46  2025-08-09                    _LSLOGINS_(1)
    


* * *