xref: /freebsd/usr.bin/logins/logins.1 (revision 81ad6265)
1.\"-
2.\" Copyright (c) 2004 Dag-Erling Coïdan Smørgrav
3.\" All rights reserved.
4.\"
5.\" Redistribution and use in source and binary forms, with or without
6.\" modification, are permitted provided that the following conditions
7.\" are met:
8.\" 1. Redistributions of source code must retain the above copyright
9.\"    notice, this list of conditions and the following disclaimer.
10.\" 2. Redistributions in binary form must reproduce the above copyright
11.\"    notice, this list of conditions and the following disclaimer in the
12.\"    documentation and/or other materials provided with the distribution.
13.\" 3. The name of the author may not be used to endorse or promote products
14.\"    derived from this software without specific prior written permission.
15.\"
16.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
17.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
20.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26.\" SUCH DAMAGE.
27.\"
28.\" $FreeBSD$
29.\"
30.Dd March 6, 2004
31.Dt LOGINS 1
32.Os
33.Sh NAME
34.Nm logins
35.Nd display account information
36.Sh SYNOPSIS
37.Nm
38.Op Fl admopstux
39.Op Fl g Ar groups
40.Op Fl l Ar logins
41.Sh DESCRIPTION
42The
43.Nm
44utility displays information about user and system accounts.
45.Pp
46The following options are available:
47.Bl -tag -width ".Fl g Ar groups"
48.It Fl a
49Display information about the password change and account expiration
50times for each account.
51.It Fl d
52Select accounts with duplicate UIDs.
53.It Fl g Ar groups
54Select accounts that are members of the specified groups.
55If multiple group names are specified, they must be separated with
56commas.
57.It Fl l Ar logins
58Select accounts matching the specified login names.
59If multiple names are specified, they must be separated with commas.
60.It Fl m
61Show information about secondary groups.
62.It Fl o
63Display the information for each account on a single line of
64colon-separated fields.
65.It Fl p
66Select accounts with no password.
67.It Fl s
68Select system accounts.
69These are currently defined as accounts with UIDs below 1000, plus the
70.Dq Li nobody
71account (UID 65534).
72.It Fl t
73Sort selected accounts by name rather than by UID.
74.It Fl u
75Select user accounts.
76These are currently defined as accounts with UIDs above 1000, except
77the
78.Dq Li nobody
79account (UID 65534).
80.It Fl x
81Display information about each account's home directory and shell.
82.El
83.Pp
84If multiple selection options are specified, all accounts matching any
85of the selection criteria will be displayed.
86.Pp
87If no selection options are specified, all accounts will be displayed.
88.Sh SEE ALSO
89.Xr getgrent 3 ,
90.Xr getpwent 3 ,
91.Xr group 5 ,
92.Xr passwd 5 ,
93.Xr pw 8
94.Sh HISTORY
95The
96.Nm
97utility appeared in
98.Fx 4.10 .
99.Sh AUTHORS
100The
101.Nm
102utility was written by
103.An Dag-Erling Sm\(/orgrav Aq Mt des@FreeBSD.org
104based on similar utilities in other operating systems.
105