share/man/man8/logins.8

   1 '\" te
   2 .\"  Copyright 1989 AT&T Copyright (c) 1997 Sun Microsystems, Inc. All Rights Reserved.
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH LOGINS 8 "Sep 6, 2005"
   7 .SH NAME
   8 logins \- list user and system login information
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fB/usr/bin/logins\fR [\fB-admopstux\fR] [\fB-g\fR \fIgroup...\fR]
  13      [\fB-l\fR \fIlogin_name...\fR]
  14 .fi
  15
  16 .SH DESCRIPTION
  17 .sp
  18 .LP
  19 This command displays information on user and system logins known to the
  20 system. Contents of the output is controlled by the command options and can
  21 include the following: user or system login, user id number, \fBpasswd\fR
  22 account field value (user name or other information), primary group name,
  23 primary group id, multiple group names, multiple group ids, home directory,
  24 login shell, and four password aging parameters. The default information is the
  25 following: login id, user id, primary group name, primary group id and the
  26 account field value. Output is sorted by user id, system logins, followed by
  27 user logins.
  28 .SH OPTIONS
  29 .sp
  30 .LP
  31 Options may be used together. If so, any login that matches any criteria are
  32 displayed.
  33 .sp
  34 .LP
  35 The following options are supported:
  36 .sp
  37 .ne 2
  38 .na
  39 \fB\fB-a\fR\fR
  40 .ad
  41 .RS 20n
  42 Add two password expiration fields to the display. The fields show how many
  43 days a password can remain unused before it automatically becomes inactive, and
  44 the date that the password expires.
  45 .RE
  46
  47 .sp
  48 .ne 2
  49 .na
  50 \fB\fB-d\fR\fR
  51 .ad
  52 .RS 20n
  53 Selects logins with duplicate uids.
  54 .RE
  55
  56 .sp
  57 .ne 2
  58 .na
  59 \fB\fB\fR\fB-g\fR \fIgroup\fR\fR
  60 .ad
  61 .RS 20n
  62 Selects all users belonging to \fBgroup\fR, sorted by login. Multiple groups
  63 can be specified as a comma-separated list. When the \fB-l\fR and \fB-g\fR
  64 options are combined, a user is only listed once, even if the user belongs to
  65 more than one of the selected groups.
  66 .RE
  67
  68 .sp
  69 .ne 2
  70 .na
  71 \fB\fB\fR\fB-l\fR \fIlogin_name...\fR\fR
  72 .ad
  73 .RS 20n
  74 Selects the requested login. Multiple logins can be specified as a
  75 comma-separated list. Depending on the nameservice lookup types set in
  76 \fB/etc/nsswitch.conf\fR, the information can come from the \fB/etc/passwd\fR
  77 and \fB/etc/shadow\fR files and other nameservices. When the \fB-l\fR and
  78 \fB-g\fR options are combined, a user is only listed once, even if the user
  79 belongs to more than one of the selected groups.
  80 .RE
  81
  82 .sp
  83 .ne 2
  84 .na
  85 \fB\fB-m\fR\fR
  86 .ad
  87 .RS 20n
  88 Displays multiple group membership information.
  89 .RE
  90
  91 .sp
  92 .ne 2
  93 .na
  94 \fB\fB-o\fR\fR
  95 .ad
  96 .RS 20n
  97 Formats output into one line of colon-separated fields.
  98 .RE
  99
 100 .sp
 101 .ne 2
 102 .na
 103 \fB\fB-p\fR\fR
 104 .ad
 105 .RS 20n
 106 Selects logins with no passwords.
 107 .RE
 108
 109 .sp
 110 .ne 2
 111 .na
 112 \fB\fB-s\fR\fR
 113 .ad
 114 .RS 20n
 115 Selects all system logins.
 116 .RE
 117
 118 .sp
 119 .ne 2
 120 .na
 121 \fB\fB-t\fR\fR
 122 .ad
 123 .RS 20n
 124 Sorts output by login instead of by uid.
 125 .RE
 126
 127 .sp
 128 .ne 2
 129 .na
 130 \fB\fB-u\fR\fR
 131 .ad
 132 .RS 20n
 133 Selects all user logins.
 134 .RE
 135
 136 .sp
 137 .ne 2
 138 .na
 139 \fB\fB-x\fR\fR
 140 .ad
 141 .RS 20n
 142 Prints an extended set of information about each selected user. The extended
 143 information includes home directory, login shell and password aging
 144 information, each displayed on a separate line. The password information
 145 currently consists of password status:
 146 .sp
 147 .ne 2
 148 .na
 149 \fB\fBNP\fR\fR
 150 .ad
 151 .RS 6n
 152 Account has no password
 153 .RE
 154
 155 .sp
 156 .ne 2
 157 .na
 158 \fB\fBLK\fR\fR
 159 .ad
 160 .RS 6n
 161 Account is locked for \fBUNIX\fR authentication
 162 .RE
 163
 164 .sp
 165 .ne 2
 166 .na
 167 \fB\fBNL\fR\fR
 168 .ad
 169 .RS 6n
 170 Account is a no login account
 171 .RE
 172
 173 .sp
 174 .ne 2
 175 .na
 176 \fB\fBPS\fR\fR
 177 .ad
 178 .RS 6n
 179 Account probably has a valid password
 180 .RE
 181
 182 .sp
 183 .ne 2
 184 .na
 185 \fB\fBUN\fR\fR
 186 .ad
 187 .RS 6n
 188 Account password status is unknown. That is, it is not a recognizable hashed
 189 password or any of the above entries. See \fBcrypt\fR(3C) for valid password
 190 hashes.
 191 .RE
 192
 193 If the login is passworded, status is followed by the date the password was
 194 last changed, the number of days required between changes, and the number of
 195 days allowed before a change is required. The password aging information shows
 196 the time interval that the user receives a password expiration warning message
 197 (when logging on) before the password expires.
 198 .RE
 199
 200 .SH SEE ALSO
 201 .sp
 202 .LP
 203 \fBpasswd\fR(1), \fBcrypt\fR(3C), \fBattributes\fR(5)