userstat(1M)userstat(1M)NAMEuserstat - check status of local user accounts
SYNOPSIS
[parm]...
[parm]...
DESCRIPTION
checks the status of local user accounts and reports abnormal condi‐
tions, such as account locks.
If any parm arguments are specified, abnormal status is displayed only
for those parameters, otherwise abnormal status is displayed for all
parameters. The section describes the various parameter values that
can be used for parm.
Each account with an abnormal status is displayed on a single line.
Each line contains the username followed by one or more parameters,
indicating what abnormal conditions exist for the account. The section
describes the various parameters that can be displayed.
Options
The following options are recognized:
Display the status of all users listed in
(Quiet) Do not print anything to standard output.
This can be used when interested only in the return value.
Check the status of only the specified user
name. The user must be a local user listed in
Parameters
The parameters that could be displayed to indicate abnormal account
status, or that could be used with the option, include the following:
is displayed if an administrator lock is present on the account. This
lock indicates that the encrypted password in or begins with An admin‐
istrator lock can be set, for example, with
is displayed if the account is locked because the account expiration
date has been reached. days is the number of days that the
account has been expired. See the description of the expiration
field in shadow(4).
is displayed if the account's password has expired.
days is the number of days that the password has been expired.
days is displayed only if its value can be determined.
is displayed if the account is locked because there have been no logins
to the account for a time interval that exceeds the maximum
allowed. days is the number of days that the account has been
inactive. See the description of the attribute in security(4).
is displayed if the account is locked because the number of
consecutive authentication failures exceeded the maximum
allowed. num is the number of consecutive authentication fail‐
ures. See the description of the attribute in security(4).
is displayed if the account is locked because the account has
a null password and is not allowed to have a null password. See
the description of the attribute in security(4).
is displayed if the account has a time-of-day login restriction.
times defines the time periods that the user may login. See the
description of the attribute in security(4).
Security Restrictions
Users invoking this command must have the authorization. See
authadm(1M).
is not supported for trusted systems.
RETURN VALUE
exits with one of the following values:
did not find abnormal status
found abnormal status
invalid usage or user not found
EXAMPLES
The following example reports all abnormal status for all local
accounts.
The following example shows that the account for user is not locked due
to too many consecutive authentication failures.
FILES
standard password file
shadow password file
user database
SEE ALSOauthadm(1M), passwd(4), security(4), shadow(4), userdb(4).
userstat(1M)
