<!--Arbortext, Inc., 1988-2007, v.4002-->
<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD SolBook 3.5//EN" [
<!ENTITY options-common SYSTEM "options-common.sgm">
<!ENTITY synopsis-common SYSTEM "synopsis-common.sgm">
<!ENTITY % commonents SYSTEM "common.ent">
%commonents;
]>
<?Pub UDT _bookmark _target>
<?Pub CX solbook(>
<refentry id="list-file-groups-1"><?Pub Tag atict:info tracking="off" ref="2"><?Pub Tag
atict:user user="hl34125" fullname=""><?Pub Tag atict:user user="pmdavies"
fullname=""><?Pub Tag atict:user user="ah95648" fullname="">
<!-- @(#)list-file-groups.1 1.10 07/07/27 SMI; -->
<refmeta><refentrytitle>list-file-groups</refentrytitle><manvolnum>1</manvolnum>
<refmiscinfo class="date">30 Jan 2007</refmiscinfo>
<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
<refmiscinfo class="software">&software;</refmiscinfo>
<refmiscinfo class="arch">generic</refmiscinfo>
<refmiscinfo class="copyright">Copyright (c) 2007, Sun Microsystems, Inc.
All Rights Reserved</refmiscinfo>
</refmeta>
<refnamediv><indexterm><primary>list-file-groups</primary></indexterm>
<indexterm><primary>lists the file groups</primary></indexterm>
<refname>list-file-groups</refname><refpurpose>lists file groups</refpurpose>
</refnamediv>
<refsynopsisdiv><title></title>
<synopsis><command>list-file-groups</command> &synopsis-common; [<option
role="double-dash">name</option> <replaceable>username</replaceable>]
 [--authrealmname <replaceable>auth_realm_name</replaceable>] [ target]</synopsis>
</refsynopsisdiv>
<refsect1 role="description"><title></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="double-dash">name</option> option is not specified,
all groups are listed.</para>
<para>This command is supported in remote mode only.</para>
</refsect1>
<refsect1 role="options"><title></title>
<variablelist termlength="medium">&options-common;
</variablelist>
<variablelist termlength="medium">
<varlistentry><term><option role="double-dash">name</option></term>
<listitem><para>Identifies the name of the file user for whom the groups will
be listed. </para>
</listitem>
</varlistentry>
<varlistentry><term><option role="double-dash">authrealmname</option></term>
<listitem><para>Name, in the <filename>domain.xml</filename> file, where you
have different stores for file auth realm.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="operands"><title></title>
<variablelist termlength="medium">
<varlistentry><term><replaceable>target</replaceable></term>
<listitem><para>This operand specifies which configurations you can list.
Valid targets are:</para>
<itemizedlist>
<listitem><para><literal>server</literal>&hyphen; Specifies the default server
instance as the target.  <literal>server</literal> is the name of the default
server instance and is the default value.</para></listitem>
<listitem><para><replaceable>cluster_name</replaceable>&hyphen; Specifies
a certain cluster as the target.</para></listitem>
<listitem><para><replaceable>instance_name</replaceable>&hyphen; Specifies
a certain server instance as the target<?Pub Caret>.</para></listitem>
</itemizedlist>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="examples"><title></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 role="exit-status"><title></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 role="see-also"><title></title>
<para><olink targetdoc="asrefman" targetptr="delete-file-user-1">delete-file-user(1)
</olink>, <olink targetdoc="asrefman" targetptr="update-file-user-1">update-file-user(1)
</olink>, <olink targetdoc="asrefman" targetptr="create-file-user-1">create-file-user(1)
</olink>, <olink targetdoc="asrefman" targetptr="list-file-users-1">list-file-users(1)
</olink></para>
</refsect1>
</refentry>
<?Pub *0000004095 0>
