<?xml version="1.0" encoding="UTF-8"?>
<refentry id="afppasswd.1">
  <refmeta>
    <refentrytitle>afppasswd</refentrytitle>

    <manvolnum>1</manvolnum>

    <refmiscinfo class="date">01 May 2024</refmiscinfo>

    <refmiscinfo class="source">Netatalk</refmiscinfo>

    <refmiscinfo class="manual">Netatalk AFP ファイルサーバーのマニュアル</refmiscinfo>

    <refmiscinfo class="version">@netatalk_version@</refmiscinfo>
  </refmeta>

  <refnamediv>
    <refname>afppasswd</refname>

    <refpurpose>AFP Random Number UAM パスワード保守ユーティリティ</refpurpose>
  </refnamediv>

  <refsynopsisdiv>
    <cmdsynopsis>
      <command>afppasswd</command>

      <arg>-acfn</arg>

      <arg>-p <replaceable>afppasswdファイル</replaceable></arg>

      <arg>-u <replaceable>最低限 uid</replaceable></arg>

      <arg>-w <replaceable>パスワード文字列</replaceable></arg>
    </cmdsynopsis>
  </refsynopsisdiv>

  <refsect1>
    <title>説明</title>

    <para><command>afppasswd</command> は、「Randnum exchange」および「2-Way Randnum
    exchange」ユーザー認証モジュールのユーザー資格情報を提供する afppasswd ファイルを作成および管理する。</para>

    <para><command>afppasswd</command>は、rootがパラメータ付きで呼び出すことも、一般のユーザが自分のAFPパスワードを変更するためにパラメータなしで呼び出すこともできる。</para>

    <note>
      <para>このユーティリティでは、Random Number UAM
      の2種類が利用するパスワードのみ変更できる。かなり弱いパスワード暗号化を提供するため、非常に古いAFPクライアントをサポートしなければならない限り、より安全な"DHX"
      ("DHCAST128") 及び "DHX2" UAMを推奨する。</para>
    </note>
  </refsect1>

  <refsect1>
    <title>例</title>

    <para>ローカルユーザが自分のパスワードを変更する:</para>

    <screen><prompt>example%</prompt> <userinput>afppasswd</userinput>
<computeroutput>Enter NEW AFP password:</computeroutput> <userinput>(非表示)</userinput>
<computeroutput>Enter NEW AFP password again:</computeroutput> <userinput>(非表示)</userinput>
<computeroutput>afppasswd: updated password.</computeroutput>
</screen>
  </refsect1>

  <refsect1>
    <title>オプション</title>

    <variablelist remap="TP">
      <varlistentry>
        <term><option>-a</option></term>

        <listitem>
          <para><command>afppasswd</command>ファイルに新しいユーザを追加する。</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>-c</option></term>

        <listitem>
          <para><command>afppasswd</command>ファイルまたは特定ユーザを作成する。(さらに/または)初期化する。</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>-f</option></term>

        <listitem>
          <para>現在の動作を強制する。</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>-p</option><replaceable> パス</replaceable></term>

        <listitem>
          <para><command>afppasswd</command>ファイルのパス。</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>-n</option></term>

        <listitem>
          <para>もしcracklibサポートが<emphasis
          remap="B">netatalk</emphasis>に組み込まれており、cracklib辞書に対して実行されたパスワードを持つことをスーパユーザが望まないなら、このオプションはcracklibチェックを無効にできるだろう。</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>-u</option><replaceable> minimum
        uid</replaceable></term>

        <listitem>
          <para>これは、<command>afppasswd</command>がユーザを作成するときに使う最小の<emphasis
          remap="I">ユーザid</emphasis> (uid)である。</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>-w</option><replaceable> パスワード文字列</replaceable></term>

        <listitem>
          <para>パスワードを対話形式で入力するのではなく、文字列をパスワードとして使用する。
          パスワードは平文で端末履歴に残るため、このオプションは絶対に必要な場合にのみ使用してください。</para>
        </listitem>
      </varlistentry>
    </variablelist>
  </refsect1>

  <refsect1>
    <title>参照</title>

    <para><citerefentry>
        <refentrytitle>afpd</refentrytitle>

        <manvolnum>8</manvolnum>
      </citerefentry>, <citerefentry>
        <refentrytitle>afp.conf</refentrytitle>

        <manvolnum>5</manvolnum>
      </citerefentry>.</para>
  </refsect1>

  <refsect1>
    <title>著作者</title>

    <para><ulink url='https://netatalk.io/contributors'>CONTRIBUTORS</ulink> を参照</para>
  </refsect1>
</refentry>
