userls(ADM)

userls -- list user and system login information

Syntax

/etc/userls -AmopSsu -g group -l user[:hostname]

/etc/userls -ADo -S hostname -x extendedOptionString -X optionsFile

Description

userls lists the configured user accounts, the attributes associated with a user account, or the user accounts associated with a group.

The output of userls is attribute value pairs enclosed in braces, which is suitable for use in an option file for useradd(ADM).

Options

The following options are supported:

-A

Lists all attributes associated with the specified user(s).

-D

List the current default values for the system.

-d

Select logins with duplicate UIDs.

-g group

Specify all users belonging to group. Multiple groups must be separated by commas.

-l user

Specify the login names to be examined. Multiple login names must be separated by commas.

-m

Display multiple group membership information.

-o

Format output into one line of colon-delimited fields.

-p

Select logins with no passwords.

-s

Select all system logins (accounts with a UID of 199 or less).

-S hostname

Select the system from which the information is to be taken.

-u

Select all user logins (accounts with a UID of 200 or greater).

-x extendedOptionString

List extended account attributes. Most attributes are account parameters that can be changed; the userls command can only be used to query them. See useradd(ADM) for a complete list of attributes. The following attributes are status information available only with the userls command:

genPasswd: Generates a password using the password generator. This password is not stored, but can be used as input for useradd . If the account administrator is not authorized to run the password generator, this attribute is set to NULL. This parameter is only valid with the -D option.
installedShells: The list of shell programs available on the system. This is taken from the contents of /usr/lib/mkuser. This parameter is only valid with the -D option.
lastSuccessfulLoginTime: The time when an account was last logged into successfully. Also mirrored in .lastlogin located in the user's home directory.
lastSuccessfulLoginTty: The terminal device an account was last successfully logged in on.
lastUnsuccessfulLoginTime: The time at which the last failed login attempt occurred.
lastUnsuccessfulLoginTty: The terminal device at which the last failed login attempt occurred.
nextUid: The next available (unassigned) UID. This parameter is only valid with the -D option.
passwdSuccessfulChangeTime: The time at which an account's password attribute was last successfully changed.
passwdUnsuccessfulChangeTime: The time at which the last failed attempt to change the user password occurred.
unsuccessfulLoginAttempts: The number of consecutive unsuccessful login attempts for an account.

-X optionsFile

Specify the file from which the user attributes are to be taken.

Exit values

Upon completion, these utilities exit with one of the following values:

0: The action was successful.
>0: An error occurred.

Files

/etc/passwd: password file
/etc/group: group file
/tcb/files/auth/?/: Protected Password database
/etc/auth/?/: Subsystem Authorizations database

Standards conformance

userls is conformant with USL SVID Issue 3.