<!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="create-file-user-1">
<refmeta><refentrytitle>create-file-user</refentrytitle><manvolnum>1</manvolnum>&metainfo;
</refmeta>
<refnamediv><indexterm><primary sortas="create-file-user">create-file-user &mdash;
creates a new file user</primary></indexterm><indexterm><primary sortas="creates a new file user">
creates a new file user &mdash; create-file-user</primary></indexterm><refname>
create-file-user</refname><refpurpose> creates a new file user</refpurpose>
</refnamediv>
<refsynopsisdiv><title>&synp-tt;</title>
<cmdsynopsis><command><command>create-file-user</command></command>&synopsis-common;
<arg choice="opt">&Dash;&Dash;target <replaceable>target</replaceable></arg>
<arg>&Dash;&Dash;passwordfile<replaceable> passwordfile</replaceable></arg>
<arg choice="opt">&Dash;&Dash;authrealmname<replaceable> auth_realm_name</replaceable></arg>
<arg choice="opt">&Dash;&Dash;groups <replaceable>user_groups[:</replaceable><replaceable>
user_groups]</replaceable>*</arg><arg choice="plain"><replaceable>user_name
</replaceable></arg>
</cmdsynopsis></refsynopsisdiv>
<refsect1><title>&desc-tt;</title>
<para>Creates an entry in the keyfile with the specified username, password,
and groups. Multiple groups can be created by separating them with a colon
(:). If <replaceable>auth_realm_name</replaceable> is not specified, an entry
is created in the keyfile for the default realm. If <replaceable>auth_realm_name
</replaceable> is specified, an entry is created in the keyfile using the <classname>
auth_realm_name</classname>.</para>
<para>This command is supported in remote mode only.</para>
</refsect1>
<refsect1><title>OPTIONS</title>
<variablelist termlength="medium">&options-common;
<varlistentry><term><option role="nodash">&Dash;&Dash;target</option></term>
<listitem><para>This is the name of the target on which the command operates.
The valid targets are config, instance, cluster, or server. By default, the
target is the server.</para>
<para>&se-ee-only;</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;groups</option></term>
<listitem><para>This is the group associated with this file user.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;authrealmname</option></term>
<listitem><para>This is the file where the file users are stored.</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>OPERANDS</title>
<variablelist termlength="medium">
<varlistentry><term><replaceable>user_name</replaceable></term><listitem>
<para>This is the name of file user to be created.</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>EXAMPLES</title>
<example>
<title>Using the create-file-user command</title>
<para>It is assumed that an authentication realm has already been created
using the <command>create-auth-realm</command> command.</para>
<screen>asadmin> <userinput>create-file-user --user admin<?Pub Caret> --passwordfile passwords.txt
--host pigeon --port 5001 --groups staff:manager 
--authrealmname auth-realm1 sample_user</userinput>
Command create-file-user executed successfully</screen>
<para>Where, the <filename>sample_user</filename> is the file user created.
</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-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>, <link linkend="update-file-user-1"><citerefentry>
<refentrytitle>update-file-user</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>, <link
linkend="list-file-groups-1"><citerefentry><refentrytitle>list-file-groups
</refentrytitle><manvolnum>1</manvolnum></citerefentry></link></para>
</refsect1>
</refentry>
<?Pub *0000005011>
