LISTUSER

Restriction: This topic applies only when the Enterprise Server feature is enabled.

Description

List the users.

Required parameters

USER=pattern
User name, optionally with "*" wildcards.

Optional parameters

COMPUTED=NO
Disables the generation of the GROUPS attribute in the output, which lists groups the user belongs to. This attribute must be computed when processing the command, and can take a long time to generate if you are listing many users or have many groups.
CNSSTNT=NO
This parameter name is an abbreviation of the word "consistent". It disables locking the ESF group list while computing group membership. This introduces a small chance of returning inconsistent results for the user's group list, but it improves performance and enables multiple LISTUSER commands to run in parallel. This option has no effect if the parameter COMPUTED=NO is specified, this is because the group membership is omitted.

Inconsistent results will only occur if LISTUSER overlaps with the initial Verify operation for the same user, with an ESF Update operation which changes the user's group membership, or with an ESF Admin ALTGROUP, DELGROUP, or ALTUSER operation which happens to affect the group entry LISTUSER is currently examining. The most likely result is the appearance of an empty group name in the returned results.

Example

esfadmin listuser user="A*"

Lists all users with names beginning with "A".