userls(ADM)

Syntax

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

Description

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

Options

-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

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

See also

Standards conformance