Data Stream Interface

パケット構造

それぞれのフィールド:

• フラグ:: パケットがリクエスト (0x00) かリプライ (0x01) かどうか
• コマンド: 7つの有効なコマンドのうちのひとつ (下記参照)
• リクエストID: リクエストおよびそれをリプライにコピーしたシーケンシャルな識別子
• エラーコード/ 含まれるデータのオフセット:
  • リクエストでは、これはゼロのままである。ただしDSIWriteコマンドを除く。
  • リプライでは、これはエラーコードである。
• 全データ長: DSIヘッダの後の全データ長
• 予約済: 将来の拡張のため
• ペイロード: ここがDSIデータの境界であるか、または更に一般的なAFPヘッダが置かれるかどうか

コマンド

7つの有効なコマンドがある:

リクエストとリプライ

処理された全てのDSIリクエストはリプライメッセージで応答される。リプライは以下を含む:

• 0x01（リプライ）に設定したフラグフィールド
• リクエストと同じ値に設定したコマンド
• リクエストで送られたものと同じリクエストID (了解済のリクエストをクライアント見つけるのに使われる)
• データ長及びデータ自身。これは任意。

セッションの確立、維持および解除

セッションはクライアントが送るDSIOpenSessionによって準備される。これはDSIAttentionパッケージのためのクライアントの受信バッファのサイズを含むであろう（Attention Quantumと呼ばれ、一般には1024である）。サーバは要求を受け入れ、データ受信バッファのサイズ（一般にはMac OS X Leopardで256k）を返す。

セッションの解除はDSICloseSessionを送ることにより、どちら側からでも行なうことができる。送り手はリプライを待つ必要はなく、メッセージを送った後にすぐセッションを閉じるべきである。

コネクションの維持はtickling（くすぐり）により行なわれる。DSIはクライアントとサーバが相手が今なおアクティブであることを知ることを保証するためのメカニズムを提供する。30秒毎の不活性期間をおいて、サーバはクライアントにtickleリクエストを送る。自分自身にtickleを返す。もしクライアントがそのようなリクエストを受け取らないなら、tickleを送る。クライアントもサーバも相手から120秒間tickleを聞くことがなければ、DSIセッションを終了できる。

GetStatusによるサーバ情報の取得

これは最も複雑なDSIコマンドである。クライアントがサーバにログインすることなしに、サーバからの情報を得るのに使われる。

データの要素は構造化データを示すインデックスのカタログをもつパケットの中にまとめられる。。

DSIGetStatus要求はサーバに以下の情報を返答させるであろう:

• 基本的なサーバの性質を示すフラグ
• サーバ名（7ビットASCIIとUTF-8）
• シグネチャ: 他のAFPトランザクションのサーバと一意的に識別するために使われる
• サーバタイプ: 典型的には "Macintosh" や "Netatalk"
• AFPバージョンを示す文字列のリスト (例: "AFP3.2")
• UAMリスト: ユーザ認証方法 (User Authentication Method) を示す文字列のリスト（例 : "DHX2"）
• 64x64ピクセルアイコン
• ディレクトリサーバのリスト

DSIGetStatusのリプライは、AFPやASPのFPGetSrvrParmsと同一である。

エラーコード

エラーコードはAFPリターンコードである。