<!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 Inc>
<refentry id="list-auth-realms-1">
<refmeta><refentrytitle>list-auth-realms</refentrytitle><manvolnum>1</manvolnum>&metainfo;
</refmeta>
<refnamediv><indexterm><primary sortas="list-auth-realms">list-auth-realms &mdash;
lists the authentication realms</primary></indexterm><indexterm><primary sortas="lists the authentication realms">
lists the authentication realms &mdash; list-auth-realms</primary></indexterm>
<refname>list-auth-realms</refname><refpurpose>lists the authentication realms
</refpurpose></refnamediv>
<refsynopsisdiv><title>&synp-tt;</title>
<cmdsynopsis><command>list-auth-realms</command>&synopsis-common;
<arg><replaceable>target_name</replaceable></arg>
</cmdsynopsis></refsynopsisdiv>
<refsect1><title>&desc-tt;</title>
<para>Lists the authentication realms. This command is supported in remote
mode only.</para>
</refsect1>
<refsect1><title>OPTIONS</title>
<variablelist termlength="medium">&options-common;
</variablelist></refsect1>
<refsect1><title>&oper-tt;</title>
<variablelist termlength="medium">
<varlistentry><term><replaceable>target_name</replaceable></term><listitem>
<para>name of the target on which you want to list the authentication realms.<itemizedlist>
<listitem><para><literal>server</literal>, which creates the realm for the
default server instance <literal>server</literal> and is the default value<?Pub Caret>
</para>
</listitem>
<listitem><para><replaceable>configuration_name</replaceable>, which creates
the realm for the named configuration</para>
</listitem>
<listitem><para><replaceable>cluster_name</replaceable>, which creates the
realm for every server instance in the cluster</para>
</listitem>
<listitem><para><replaceable>instance_name</replaceable>, which creates the
realm for a particular server instance</para>
</listitem>
</itemizedlist></para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&exam-tt;</title>
<example>
<title>Using list-auth-realms</title>
<screen>asadmin> <userinput>list-auth-realms --user admin --passwordfile password.txt 
--host localhost --port 4848</userinput>
file
ldap
certificate
db
Command list-auth-realms executed successfully</screen>
<para>Where file, ldap, certificate, and db are the listed authentication
realms.</para>
</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="create-auth-realm-1"><citerefentry><refentrytitle>create-auth-realm
</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>, <link linkend="delete-auth-realm-1"><citerefentry>
<refentrytitle>delete-auth-realm</refentrytitle><manvolnum>1</manvolnum></citerefentry></link></para>
</refsect1>
</refentry>
<?Pub *0000003449>
