<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
  <!ENTITY package "initpw">
  <!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>Initialize the auth2 password database</refpurpose>
</refnamediv>

<refsynopsisdiv>
    <cmdsynopsis>
	<command>initpw</command>
	<arg>-k <replaceable>key</replaceable></arg>
    </cmdsynopsis>
</refsynopsisdiv>

<refsect1>
    <title>DESCRIPTION</title>
    <para><command>initpw</command> initializes the <command>auth2</command>
    password database by reading entries as specified in
    <citerefentry>
	<refentrytitle>passwd.coda</refentrytitle>
	<manvolnum>5</manvolnum>
    </citerefentry>
    and writes the corresponding encrypted entries to stdout.
    </para>
    <para><command>initpw</command> supports the following command line
    options:
    </para>

    <variablelist>
	<varlistentry>
	<term><option>-k</option></term>
	<listitem>
	    <para>Using the <option>-k</option> option allows you to specify
	    the encryption key to use when encrypting cleartext passwords.
	    Currently you must give "drseuss " as the key.
	    </para>
	</listitem>
    </variablelist>
</refsect1>

<refsect1>
<title>EXAMPLE</title>
<para>initpw -k "drseuss " &lt; /vice/db/passwd.coda &gt;
/vice/db/auth2.pw</para>
</refsect1>

<refsect1>
    <title>SEE ALSO</title>
    <para>
    <citerefentry>
	<refentrytitle>auth2</refentrytitle>
	<manvolnum>8</manvolnum>
    </citerefentry>,
    <citerefentry>
	<refentrytitle>passwd.coda</refentrytitle>
	<manvolnum>5</manvolnum>
    </citerefentry>
    </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>Lesa Gresh, 1998, modified</para>
    </listitem>
    <listitem><para>Jan Harkes, 2004, converted to DocBook 4.1</para>
    </listitem>
    </itemizedlist>
    </para>
</refsect1>
</refentry>

