userls(1M)


userls -- list user and system login information

Synopsis

/usr/sbin/userls -admo -g group,... -l user,... -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(1M).

Options

The following options are supported:

-a
Sends all options associated with the specified group accounts to standard output in extended option syntax (parsable from a datafile by the -X option). Lists all attributes associated with the specified user(s).

-d
Selects logins with duplicate UIDs.

-m
Display multiple group membership information.

-o
Format output into one line of colon-delimited fields.

-g group
Specify all users belonging to group. Multiple groups must be separated by commas. If group comprises entirely numeric characters it is treated as a group ID; otherwise it is treated as a group name.

-l user
Display the user name, user ID, group ID and comment in a format parsable by the extended option syntax. If user does not exist and it consists entirely of numeric characters, it is interpreted as a UID. Multiple login names must be separated by commas.

-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(1M) for a complete list of attributes.

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

Files


/etc/passwd
password file

/etc/group
group file

Diagnostics

The userls command exits with 0 on success, and either 1 or 2 on failure. Error messages for the following conditions are displayed:
   * Invalid command syntax.

References

groupadd(1M), groupdel(1M), groupls(1M), logins(1M), useradd(1M), userdel(1M), usermod(1M), userls(1M), users(1bsd), group(4).
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004