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

See also

groupadd(ADM), useradd(ADM)

Standards conformance

userls is conformant with USL SVID Issue 3.
© 2005 The SCO Group, Inc. All rights reserved.
SCO OpenServer Release 6.0.0 -- 03 June 2005