blob: 380e9b5f69720f59930b61ca7d5c239d8317d993 [file] [log] [blame]
type=page
status=published
title=list-file-users
next=list-http-lb-configs.html
prev=list-file-groups.html
~~~~~~
= list-file-users
[[list-file-users-1]][[GSRFM00165]][[list-file-users]]
== list-file-users
Lists the file users
[[sthref1476]]
=== Synopsis
[source]
----
asadmin [asadmin-options] list-file-users [--help]
[--authrealmname auth_realm_name] [target]
----
[[sthref1477]]
=== Description
The `list-file-users` subcommand displays a list of file users supported
by file realm authentication.
[[sthref1478]]
=== Options
`--help`::
`-?`::
Displays the help text for the subcommand.
`--authrealmname`::
Lists only the users in the specified authentication realm.
[[sthref1479]]
=== Operands
target::
Specifies the target for which you want to list file users. The
following values are valid:
`server`;;
Lists the file users on the default server instance. This is the
default value.
configuration_name;;
Lists the file users in the specified configuration.
cluster_name;;
Lists the file users on all server instances in the specified
cluster.
instance_name;;
Lists the file users on a specified server instance.
[[sthref1480]]
=== Examples
[[GSRFM658]][[sthref1481]]
==== Example 1   Listing Users in a Specific File Realm
The following example lists the users in the file realm named
`sample_file_realm`.
[source]
----
asadmin> list-file-users --authrealmname sample_file_realm
sample_user05
sample_user08
sample_user12
Command list-file-users executed successfully
----
[[sthref1482]]
=== Exit Status
0::
subcommand executed successfully
1::
error in executing the subcommand
[[sthref1483]]
=== See Also
link:asadmin.html#asadmin-1m[`asadmin`(1M)]
link:create-file-user.html#create-file-user-1[`create-file-user`(1)],
link:delete-file-user.html#delete-file-user-1[`delete-file-user`(1)],
link:list-file-groups.html#list-file-groups-1[`list-file-groups`(1)],
link:update-file-user.html#update-file-user-1[`update-file-user`(1)]