/usr.bin/logins/logins.1

  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 des@FreeBSD.org
104based on similar utilities in other operating systems.