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

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

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

<refnamediv>
    <refname>&package;</refname>
    <refpurpose>Coda user identification file</refpurpose>
</refnamediv>

<refsect1>
    <title>DESCRIPTION</title>
    <para>This file specifies initial cleartext passwords for Coda
    users.  The format of the file is:  
<programlisting>
uid&lt;TAB&gt;actual cleartext password&lt;TAB&gt;any desired info
</programlisting>
    </para>

    <para>Where:</para>

    <variablelist>
	<varlistentry>
	<term><replaceable>ViceId</replaceable></term>
	<listitem><para>is a Coda user id.</para>
	</listitem>
	</varlistentry>

	<varlistentry>
	<term><replaceable>Cleartext Password</replaceable></term>
	<listitem>
	    <para>is the password to use for this
	    <replaceable>ViceId</replaceable>.</para>
	</listitem>
	</varlistentry>

	<varlistentry>
	<term><replaceable>Other user info</replaceable></term>
	<listitem>
	    <para>is the other information about the user you want to
	    include, e.g. the user name.</para>
	</listitem>
	</varlistentry>
    </variablelist>

    <para><emphasis>WARNING</emphasis> this file must be owned by root
    and not be readable by any other user.
    </para>
    <para>This file is translated into a Coda encrypted password file by
    <citerefentry>
	<refentrytitle>initpw</refentrytitle>
	<manvolnum>8</manvolnum>
    </citerefentry>.
    </para>
</refsect1>

<refsect1>
    <title>SEE ALSO</title>
    <para>
    <citerefentry>
	<refentrytitle>initpw</refentrytitle>
	<manvolnum>8</manvolnum>
    </citerefentry>,
    <citerefentry>
	<refentrytitle>pdbtool</refentrytitle>
	<manvolnum>8</manvolnum>
    </citerefentry>
    </para>
</refsect1>

<refsect1>
    <title>AUTHORS</title>
    <para>
    <itemizedlist>
    <listitem><para>Lesa Gresh, 1998, created</para>
    </listitem>
    <listitem><para>Jan Harkes, 2004, converted to DocBook 4.1</para>
    </listitem>
    </itemizedlist>
    </para>
</refsect1>
</refentry>

