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

    <manvolnum>1</manvolnum>

    <refmiscinfo class="date">27 October 2024</refmiscinfo>

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

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

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

  <refnamediv>
    <refname>afptest</refname>

    <refname>afp_lantest</refname>

    <refname>afp_logintest</refname>

    <refname>afp_spectest</refname>

    <refname>afp_speedtest</refname>

    <refname>afparg</refname>

    <refpurpose>AFP プロトコルテスト</refpurpose>
  </refnamediv>

  <refsynopsisdiv>
    <cmdsynopsis>
      <command>afp_lantest<indexterm>
          <primary>afptest</primary>
        </indexterm></command>

      <arg>-34567GgVv</arg>

      <arg>-h <replaceable>ホスト</replaceable></arg>

      <arg>-p <replaceable>ポート</replaceable></arg>

      <arg>-s <replaceable>ボリューム</replaceable></arg>

      <arg>-u <replaceable>ユーザー</replaceable></arg>

      <arg>-w <replaceable>パスワード</replaceable></arg>

      <arg>-n <replaceable>反復</replaceable></arg>

      <arg>-t <replaceable>実行するテスト</replaceable></arg>

      <arg>-F <replaceable>bigfile</replaceable></arg>
    </cmdsynopsis>

    <cmdsynopsis>
      <command>afp_logintest<indexterm>
          <primary>afptest</primary>
        </indexterm></command>

      <arg>-1234567CmVv</arg>

      <arg>-h <replaceable>ホスト</replaceable></arg>

      <arg>-p <replaceable>ポート</replaceable></arg>

      <arg>-s <replaceable>ボリューム</replaceable></arg>

      <arg>-u <replaceable>ユーザー</replaceable></arg>

      <arg>-w <replaceable>パスワード</replaceable></arg>
    </cmdsynopsis>

    <cmdsynopsis>
      <command>afp_spectest<indexterm>
          <primary>afptest</primary>
        </indexterm></command>

      <arg>-1234567aCiLlmVvXx</arg>

      <arg>-h <replaceable>ホスト</replaceable></arg>

      <arg>-H <replaceable>ホスト2</replaceable></arg>

      <arg>-p <replaceable>port</replaceable></arg>

      <arg>-s <replaceable>ボリューム</replaceable></arg>

      <arg>-c <replaceable>ボリュームへのパス</replaceable></arg>

      <arg>-S <replaceable>ボリューム2</replaceable></arg>

      <arg>-u <replaceable>ユーザー</replaceable></arg>

      <arg>-d <replaceable>user2</replaceable></arg>

      <arg>-w <replaceable>パスワード</replaceable></arg>

      <arg>-f <replaceable>テスト</replaceable></arg>
    </cmdsynopsis>

    <cmdsynopsis>
      <command>afp_speedtest<indexterm>
          <primary>afptest</primary>
        </indexterm></command>

      <arg>-1234567aeiLnVvy</arg>

      <arg>-h <replaceable>ホスト</replaceable></arg>

      <arg>-p <replaceable>ポート</replaceable></arg>

      <arg>-s <replaceable>ボリューム</replaceable></arg>

      <arg>-S <replaceable>ボリューム2</replaceable></arg>

      <arg>-u <replaceable>ユーザー</replaceable></arg>

      <arg>-w <replaceable>パスワード</replaceable></arg>

      <arg>-n <replaceable>反復</replaceable></arg>

      <arg>-d <replaceable>サイズ</replaceable></arg>

      <arg>-q <replaceable>quantum</replaceable></arg>

      <arg>-F <replaceable>ファイル</replaceable></arg>

      <arg>-f <replaceable>テスト</replaceable></arg>
    </cmdsynopsis>

    <cmdsynopsis>
      <command>afparg<indexterm>
          <primary>afptest</primary>
        </indexterm></command>

      <arg>-1234567lVv</arg>

      <arg>-h <replaceable>ホスト</replaceable></arg>

      <arg>-p <replaceable>ポート</replaceable></arg>

      <arg>-s <replaceable>ボリューム</replaceable></arg>

      <arg>-u <replaceable>ユーザー</replaceable></arg>

      <arg>-w <replaceable>パスワード</replaceable></arg>

      <arg>-f <replaceable>コマンド</replaceable></arg>
    </cmdsynopsis>
  </refsynopsisdiv>

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

    <para><emphasis remap="I">afptest</emphasis>
    ファミリーのすべてのツールは、同じ一般的な使用パターンとパラメータに従います。 AFP プロトコル リビジョン
    (<option>-1</option> から <option>-7</option>) を設定し、次にテストするホストのアドレスと資格情報
    (localhost も可) を設定します。一部のテストでは、2 番目のユーザーと 2 番目のボリュームを定義する必要があります。さらに別のテスト
    セットを localhost から実行し、テスト対象のボリュームへのローカル パスを指定する必要があります。 単一のテストまたはテスト
    セクションは、<option>-f</option> オプションで実行できます。使用可能なテストは、<option>-l</option>
    オプションで一覧表示できます。</para>

    <para><command>afp_spectest</command> は、300 を超えるテスト ケースを含む AFP 仕様テスト スイートの中核を
    構成します。これは、テストする AFP コマンド別、またはテストの前提条件別に分けられたテストセットに編成されています。
    たとえば、Tier 2 (T2) テストは、共有ボリュームへのパスを示す <option>-c</option> オプションを使用してホスト上で
    実行する必要があります。また、読み取り専用テストとスリープ テストも別々に実行する必要があります。</para>

    <para><command>afp_logintest</command> は、独自のランナーを持つ特定の AFP ログイン認証
    テストスイートです。</para>

    <para><command>afp_lantest</command> と <command>afp_speedtest</command>
    は、AFP サーバーのファイル転送ベンチマークです。前者は、さまざまなファイル転送パターンのバッチを実行する <emphasis
    remap="I">HELIOS LanTest</emphasis> にヒントを得たものです。後者は、いくつかのテスト
    ケースが用意された、よりシンプルなツールです。</para>

    <para><command>afparg</command> は、オプションの引数を持つ特定のコマンドを受け取り、AFP
    サーバーに単一のアクションを送信する AFP CLI クライアントです。これは、1
    回限りのトラブルシューティングやシステム管理に使用できます。</para>

    <para>各オプションの正確な使用方法については、各ツールのヘルプテキストを参照してください。</para>
  </refsect1>

  <refsect1>
    <title>例</title>

    <para>afp_spectest の FPSetForkParms_test テストセットを AFP 3.4 で実行します。</para>

    <screen><prompt>%</prompt> <userinput>afp_spectest -h 127.0.0.1 -p 548 -u user1 -d user2 -w passwd -s testvol1 -S testvol2 -c /srv/afptest1 -7 -f FPSetForkParms_test</userinput>
<computeroutput>===================
FPSetForkParms_test
-------------------
FPSetForkParms:test62: SetForkParams errors - PASSED
FPSetForkParms:test141: Setforkmode error - PASSED
FPSetForkParms:test217: Setfork size 64 bits - PASSED
FPSetForkParms:test306: set fork size, new size &gt; old size - PASSED</computeroutput>
</screen>

    <para>AFP 3.0 を使用して afp_lantest ベンチマークを実行します。</para>

    <screen><prompt>%</prompt> <userinput>afp_lantest -h 192.168.0.2 -s testvol1 -u user1 -w passwd -3</userinput>
<computeroutput>Run 0 =&gt; Opening, stating and reading 512 bytes from 1000 files   1799 ms
Run 0 =&gt; Writing one large file                                     30 ms for 100 MB (avg. 3495 MB/s)
Run 0 =&gt; Reading one large file                                      8 ms for 100 MB (avg. 13107 MB/s)
Run 0 =&gt; Locking/Unlocking 10000 times each                       1959 ms
Run 0 =&gt; Creating dir with 2000 files                             1339 ms
Run 0 =&gt; Enumerate dir with 2000 files                             217 ms
Run 0 =&gt; Create directory tree with 10^3 dirs                      496 ms

Netatalk Lantest Results (averages)
===================================

Opening, stating and reading 512 bytes from 1000 files   1799 ms
Writing one large file                                     30 ms for 100 MB (avg. 3495 MB/s)
Reading one large file                                      8 ms for 100 MB (avg. 13107 MB/s)
Locking/Unlocking 10000 times each                       1959 ms
Creating dir with 2000 files                             1339 ms
Enumerate dir with 2000 files                             217 ms
Create directory tree with 10^3 dirs                      496 ms</computeroutput>
</screen>
  </refsect1>

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

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

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

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

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