163 lines
4.8 KiB
Groff
163 lines
4.8 KiB
Groff
.\" Copyright 2014 Ondrej Oprala (ondrej.oprala@gmail.com)
|
||
.\" May be distributed under the GNU General Public License
|
||
.TH LSLOGINS "1" "April 2014" "util-linux" "User Commands"
|
||
.SH NAME
|
||
lslogins \- display information about known users in the system
|
||
.SH SYNOPSIS
|
||
.B lslogins
|
||
[options]
|
||
.RB [ \-s | \-u [ =\fIUID ]]
|
||
.RB [ \-g " \fIgroups\fR]"
|
||
.RB [ \-l " \fIlogins\fR]"
|
||
.RI [ username ]
|
||
.SH DESCRIPTION
|
||
Examine the wtmp and btmp logs,
|
||
.I /etc/shadow
|
||
(if necessary) and
|
||
.I /passwd
|
||
and output the desired data.
|
||
|
||
The optional argument \fIusername\fR forces
|
||
.B lslogins
|
||
to print all available details about the specified user only. In this case the
|
||
output format is different than in case of \fB\-l\fR or \fB\-g\fR and unknown
|
||
is \fIusername\fR reported as an error.
|
||
|
||
.PP
|
||
The default action is to list info about all the users in the system.
|
||
.SH OPTIONS
|
||
Mandatory arguments to long options are mandatory for short options too.
|
||
.TP
|
||
\fB\-a\fR, \fB\-\-acc\-expiration\fR
|
||
Display data about the date of last password change and the account expiration
|
||
date (see \fBshadow\fR(5) for more info). (Requires root privileges.)
|
||
.TP
|
||
\fB\-\-btmp\-file \fIpath\fP
|
||
Alternate path for btmp.
|
||
.TP
|
||
\fB\-c\fR, \fB\-\-colon\-separate\fR
|
||
Separate info about each user with a colon instead of a newline.
|
||
.TP
|
||
\fB\-e\fR, \fB\-\-export\fR
|
||
Output data in the format of NAME=VALUE.
|
||
.TP
|
||
\fB\-f\fR, \fB\-\-failed\fR
|
||
Display data about the users' last failed login attempts.
|
||
.TP
|
||
\fB\-G\fR, \fB\-\-supp\-groups\fR
|
||
Show information about supplementary groups.
|
||
.TP
|
||
\fB\-g\fR, \fB\-\-groups\fR=\fIgroups\fR
|
||
Only show data of users belonging to \fIgroups\fR. More than one group
|
||
may be specified; the list has to be comma-separated. Unknown group
|
||
names are ignored.
|
||
|
||
Note that relation between user and group may be invisible for primary group if
|
||
the user is not explicitly specify as group member (e.g., in /etc/group). If the
|
||
command
|
||
.B lslogins
|
||
scans for groups than it uses groups database only, and user
|
||
database with primary GID is not used at all.
|
||
.TP
|
||
\fB\-h\fR, \fB\-\-help\fR
|
||
Display help information and exit.
|
||
.TP
|
||
\fB\-L\fR, \fB\-\-last\fR
|
||
Display data containing information about the users' last login sessions.
|
||
.TP
|
||
\fB\-l\fR, \fB\-\-logins\fR=\fIlogins\fR
|
||
Only show data of users with a login specified in \fIlogins\fR (user names or user
|
||
IDS). More than one login may be specified; the list has to be comma-separated.
|
||
Unknown login names are ignored.
|
||
.TP
|
||
\fB\-n\fR, \fB\-\-newline\fR
|
||
Display each piece of information on a separate line.
|
||
.TP
|
||
\fB\-\-noheadings\fR
|
||
Do not print a header line.
|
||
.TP
|
||
\fB\-\-notruncate\fR
|
||
Don't truncate output.
|
||
.TP
|
||
\fB\-o\fR, \fB\-\-output \fIlist\fP
|
||
Specify which output columns to print.
|
||
The default list of columns may be extended if \fIlist\fP is
|
||
specified in the format \fI+list\fP.
|
||
.TP
|
||
.B \-\-output\-all
|
||
Output all available columns.
|
||
.B \-\-help
|
||
to get a list of all supported columns.
|
||
.TP
|
||
\fB\-p\fR, \fB\-\-pwd\fR
|
||
Display information related to login by password (see also \fB\-afL).
|
||
.TP
|
||
\fB\-r\fR, \fB\-\-raw\fR
|
||
Raw output (no columnation).
|
||
.TP
|
||
\fB\-s\fR, \fB\-\-system\-accs\fR
|
||
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 overwritten by parameters SYS_UID_MIN and SYS_UID_MAX in
|
||
the file
|
||
.IR /etc/login.defs .
|
||
.TP
|
||
\fB\-\-time\-format\fR \fItype\fP
|
||
Display dates in short, full or iso format. The default is short, this time
|
||
format is designed to be space efficient and human readable.
|
||
.TP
|
||
\fB\-u\fR, \fB\-\-user\-accs\fR
|
||
Show user accounts. These are by default all accounts with UID above 1000
|
||
(inclusive), with the exception of either nobody or nfsnobody (UID 65534).
|
||
This hardcoded default maybe overwritten by parameters UID_MIN and UID_MAX in
|
||
the file
|
||
.IR /etc/login.defs .
|
||
.TP
|
||
\fB\-V\fR, \fB\-\-version\fR
|
||
Display version information and exit.
|
||
.TP
|
||
\fB\-\-wtmp\-file \fIpath\fP
|
||
Alternate path for wtmp.
|
||
.TP
|
||
\fB\-\-lastlog \fIpath\fP
|
||
Alternate path for lastlog.
|
||
.TP
|
||
\fB\-Z\fR, \fB\-\-context\fR
|
||
Display the users' security context.
|
||
.TP
|
||
\fB\-z\fR, \fB\-\-print0\fR
|
||
Delimit user entries with a nul character, instead of a newline.
|
||
|
||
.SH EXIT STATUS
|
||
.TP
|
||
0
|
||
if OK,
|
||
.TP
|
||
1
|
||
if incorrect arguments specified,
|
||
.TP
|
||
2
|
||
if a serious error occurs (e.g., a corrupt log).
|
||
.SH NOTES
|
||
The default UID thresholds are read from
|
||
.IR /etc/login.defs .
|
||
|
||
.SH HISTORY
|
||
The \fBlslogins\fP utility is inspired by the \fBlogins\fP utility, which first appeared in FreeBSD 4.10.
|
||
.SH AUTHORS
|
||
.MT ooprala@redhat.com
|
||
Ondrej Oprala
|
||
.ME
|
||
.br
|
||
.MT kzak@redhat.com
|
||
Karel Zak
|
||
.ME
|
||
|
||
.SH SEE ALSO
|
||
\fBgroup\fP(5), \fBpasswd\fP(5), \fBshadow\fP(5), \fButmp\fP(5)
|
||
.SH AVAILABILITY
|
||
The lslogins command is part of the util-linux package and is available from
|
||
.UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/
|
||
Linux Kernel Archive
|
||
.UE .
|