<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
<!--ArborText, Inc., 1988-1999, v.4002-->
<!ENTITY metainfo SYSTEM "metainfo.sgm">
<!ENTITY options-common SYSTEM "options-common.sgm">
<!ENTITY synopsis-common SYSTEM "synopsis-common.sgm">
<!ENTITY % commonents SYSTEM "smancommon.ent">
%commonents;
<!ENTITY % booktitles SYSTEM "booktitles.ent">
%booktitles;
<!ENTITY Dash "&ndash;">
]>
<?Pub UDT _bookmark _target>
<?Pub EntList brvbar bull cross dash diam diams frac12 frac13 frac14 hellip
 laquo lArr loz mdash nabla ndash para pound rArr raquo sect yen ne>
<?Pub Inc>
<refentry id="list-file-groups-1">
<refmeta><refentrytitle>list-file-groups</refentrytitle><manvolnum>1</manvolnum>&metainfo;
</refmeta>
<refnamediv><indexterm><primary sortas="list-file-groups">list-file-groups &mdash;
lists the file groups</primary></indexterm><indexterm><primary sortas="lists the file groups for the named instance">
lists the file groups &mdash; list-file-groups</primary></indexterm><refname>
list-file-groups</refname><refpurpose>lists file groups</refpurpose></refnamediv>
<refsynopsisdiv><title>&synp-tt;</title>
<cmdsynopsis><command>list-file-groups</command>&synopsis-common;
<arg choice="opt">&Dash;&Dash;name <replaceable>username</replaceable></arg>
<arg>--authrealmname <replaceable>auth_realm_name</replaceable></arg><arg
choice="opt"> target</arg>
</cmdsynopsis></refsynopsisdiv>
<refsect1><title>&desc-tt;</title>
<para>Use this command to administer file users and groups supported by the
file realm authentication. This command lists available groups in the file
user. If the <option role="nodash">-&ndash;name</option> option is not specified,
all groups are listed.</para>
<para>This command is supported in remote mode only.</para>
</refsect1>
<refsect1><title>OPTIONS</title>
<variablelist termlength="medium">&options-common;
</variablelist>
<variablelist termlength="medium">
<varlistentry><term><option role="nodash">-&ndash;name</option></term><listitem>
<para>Identifies the name of the file user for whom the groups will be be
listed. </para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&oper-tt;</title>
<variablelist termlength="medium">
<varlistentry><term><replaceable>target</replaceable></term><listitem><para>
This operand specifies which configurations you can list. Valid targets are:<itemizedlist>
<listitem><?Pub Caret1><para><literal>server</literal>, which lists the file
groups in the current server. This is the default value.</para>
</listitem>
<listitem><para><replaceable>cluster_name</replaceable>, which lists the file
groups in a cluster.</para>
</listitem>
<listitem><para><replaceable>instance_name</replaceable>, which lists the
file groups for a particular instance.</para>
</listitem>
</itemizedlist></para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&exam-tt;</title>
<example>
<title>Using the list-file-groups command</title>
<screen>asadmin><userinput>list-file-groups --user admin1 --passwordfile passwords.txt

</userinput>
staff
manager
Command list-file-groups executed successfully</screen>
</example>
</refsect1>
<refsect1><title>EXIT STATUS</title>
<variablelist termlength="medium">
<varlistentry><term>0</term><listitem><para>command executed successfully
</para>
</listitem></varlistentry>
<varlistentry><term>1</term><listitem><para>error in executing the command
</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&also-tt;</title>
<para><link linkend="delete-file-user-1"><citerefentry><refentrytitle>create-file-user
</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>, <link linkend="update-file-user-1"><citerefentry>
<refentrytitle>update-file-user</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>, <link
linkend="create-file-user-1"><citerefentry><refentrytitle>delete-file-user
</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>, <link linkend="list-file-users-1"><citerefentry>
<refentrytitle>list-file-users</refentrytitle><manvolnum>1</manvolnum></citerefentry></link></para>
</refsect1>
</refentry>
<?Pub *0000004160>
