データストリームインターフェース

対象となるフィールドは以下のとおりです。

• フラグ：パケットがリクエスト（0x00）かレスポンス（0x01）かを示す。
• コマンド： 7つの可能なコマンドのうちの1つ（下記参照）
• リクエストID：リクエストに設定され、応答にもコピーされる連番の識別子
• エラーコード／含まれるデータオフセット：
  • リクエストの場合、DSIWriteコマンドを使用する場合を除き、この値は0のままになります。
  • 返信の場合、これはエラーコードです。
• 合計データ長： DSIヘッダー以降のデータ全体の長さ
• 予約済み：将来の拡張用
• ペイロード：ここに限定的なDSIデータ、またはより一般的にはAFPヘッダーが配置されます。

可能なコマンドは 7 つあります: ^{[ 2 ]}

ほとんどのDSIリクエストを受信すると、クライアントまたはサーバーは応答メッセージを送信します。この応答には以下の内容が含まれます。

• flagsフィールドが0x01に設定されました（返信）
• コマンドフィールドは、リクエストのコマンドフィールドと同じ値に設定されます。
• リクエストで送信されたリクエストIDと同じもの（クライアントが確認応答されたリクエストを見つけるために使用）
• totalDataLengthはペイロードの長さに設定されます（該当する場合）。
• 該当する場合、DSIヘッダーに続くデータペイロード自体。（詳細は各コマンドを参照してください。）

DSITickleコマンドとDSICloseSessionコマンドは応答を返しません。

セッションは、クライアントが DSIOpenSession を送信することによって確立されます。このセッションには、クライアントがパケット用に持つ受信バッファのサイズ (リクエストクォンタムと呼ばれ、通常は 1024 バイト) が含まれます。サーバーはリクエストを確認し、データ受信バッファのサイズ ( Mac OS X Leopardでは通常 256KB ) を返します。

セッションの終了は、どちらの側からでもDSICloseSessionを送信することで開始できます。送信側は応答を待つ必要はなく、メッセージ送信後すぐにセッションを閉じる必要があります。

接続の維持はティックルによって行われます。DSIは、クライアントとサーバーが互いにアクティブであることを確認するためのメカニズムを提供します。サーバーは、30秒間アクティビティがないと、クライアントにティックル要求を送信します。同様に、クライアントも独自のティックルを送信します（これは応答パケットではありません）。クライアントまたはサーバーは、120秒間相手からの応答がない場合、DSIセッションを終了できます。また、クライアントは、要求が送信中で、60秒以内に応答もティックルも受信されない場合にも切断できます（Mac OS X v.10.2以降）。

このDSIコマンドは、FPGetSrvrInfoパケットをカプセル化します。クライアントがログインしていないサーバーから情報を取得する際に使用されます。

データ要素は、構造化データを指すインデックスのカタログとともにパケット内に整理されています。^{[ 3 ]}

DSIGetStatusリクエストを実行すると、サーバーは以下の情報で応答します。

• 基本的なサーバー特性を示すフラグ
• サーバー名（7ビットASCIIおよびUTF-8）
• 署名: 他のAFPトランザクションでサーバーを一意に識別するために使用されます
• サーバーの種類：通常は「Macintosh」または「Netatalk」
• 音声で読み上げられるAFPバージョンを表す文字列のリスト（例：「AFP3.2」）
• UAMリスト：ユーザー認証方法を記述する文字列のリスト（例：「DHX2」）
• 64x64ピクセルのアイコン
• ディレクトリサーバー一覧

DSIGetStatus の応答フォーマットは AFP の FPGetSrvrInfo と同一であり、ASPGetStatus に使用されます。^{[ 4 ]}

返されるエラーコードはAFP結果コードです。^{[ 5 ]}