<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
  <!ENTITY package "au">
  <!ENTITY date    "April 2004">
]>

<refentry>
<refentryinfo>
    <address><email>coda@cs.cmu.edu</email></address>
    <copyright>
	<year>1987-2004</year>
	<holder>Carnegie Mellon University</holder>
    </copyright>
    <date>&date;</date>
</refentryinfo>

<refmeta>
    <refentrytitle>&package;</refentrytitle>
    <manvolnum>8</manvolnum>
    <refmiscinfo>Coda Distributed File System</refmiscinfo>
</refmeta>

<refnamediv>
    <refname>&package;</refname>
    <refpurpose>Activate user account</refpurpose>
</refnamediv>

<refsynopsisdiv>
    <cmdsynopsis>
	<command>au</command>
	<arg>-x</arg>
	<arg>-h <replaceable>host</replaceable></arg>
	<arg>-p <replaceable>port</replaceable></arg>
	<arg choice=req>nu | cp | cu | du</arg>
    </cmdsynopsis>
</refsynopsisdiv>

<refsect1>
    <title>DESCRIPTION</title>
    <para><command>au</command> is used by an administrator to add, delete, or
    change user information. <command>au</command> will first prompt for the
    administrators Coda user name and password. It will then connect to the
    <command>auth2</command> daemon on the server to perform the requested
    operation.
    </para>
    <para><command>au</command> supports the following options:
    </para>

    <variablelist>
	<varlistentry>
	<term><option>-x</option></term>
	<listitem>
	    <para>Turns on debugging.</para>
	</listitem>
	</varlistentry>

	<varlistentry>
	<term><option>-h</option></term>
	<listitem>
	    <para>Attach to <replaceable>host</replaceable> to do the
	    authentication. <replaceable>host</replaceable> should be the SCM
	    server.</para>
	</listitem>
	</varlistentry>

	<varlistentry>
	<term><option>-p</option></term>
	<listitem>
	    <para><replaceable>port</replaceable> to bind to. The default
	    port is codaauth2 (370/udp).</para>
	</listitem>
	</varlistentry>

	<varlistentry>
	<term><option>nu</option></term>
	<listitem>
	    <para>New user. The <option>nu</option> option tells the
	    <command>auth2</command> daemon to add a new password entry to the
	    Coda password database.</para>
	</listitem>
	</varlistentry>

	<varlistentry>
	<term><option>cp</option></term>
	<listitem>
	    <para>Change password. Use this to change a users vice
	    password.</para>
	</listitem>
	</varlistentry>

	<varlistentry>
	<term><option>cu</option></term>
	<listitem>
	    <para>Change user information. Use this to change password and
	    other user information.</para>
	</listitem>
	</varlistentry>

	<varlistentry>
	<term><option>du</option></term>
	<listitem>
	    <para>Delete user. The <option>du</option> option tells the
	    <command>auth2</command> daemon to remove the password from the
	    Coda password database, thereby disabling the account.</para>
	</listitem>
	</varlistentry>
    </variablelist>
</refsect1>

<refsect1>
    <title>DIAGNOSTICS</title>
    <para>You must be a Coda system administrator to ru <command>au</command>.
    </para>
</refsect1>

<refsect1>
    <title>BUGS</title>
    <para><command>au</command> echos new passwords to the terminal
    as they are typed in.
    </para>
</refsect1>

<refsect1>
    <title>AUTHORS</title>
    <para>
    <itemizedlist>
    <listitem><para>1987, Adapted from AFS-2</para>
    </listitem>
    <listitem><para>Joshua Raiff, 1993, Created man page</para>
    </listitem>
    <listitem><para>Jan Harkes, 2004, converted to DocBook 4.1</para>
    </listitem>
    </itemizedlist>
    <para>
</refsect1>
</refentry>

