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).
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.