userstat(1M)															      userstat(1M)

NAME

       userstat - check status of local user accounts

SYNOPSIS

       [parm]...

       [parm]...

DESCRIPTION

       checks the status of local user accounts and reports abnormal conditions, 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
       administrator 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  failures.   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 ALSO

       authadm(1M), passwd(4), security(4), shadow(4), userdb(4).

																      userstat(1M)