本文へ移動
Dialova

IRCドキュメント · 上級

CAP:IRC拡張機能を確認して交渉する

CAPはIRC拡張機能を交渉するコマンドです。クライアントが対応する仕組みを有効にできます。状態遷移の詳しい説明はIRCv3のCAPガイドにあります。このページではログを読むための構文を紹介します。

Dialova運営チーム · 確認日

構文とパラメーター #

プロトコル上の構文。クライアントの / は含みません。
CAP <LS [302] | LIST | REQ :<ケイパビリティ> | END>
パラメーター意味
LS 302値付きの機能や分割応答に対応する、現在の一覧通知方式で機能一覧を要求します。
REQ指定した機能の有効化を要求します。ACKまたはNAKで応答されます。
LIST / ENDLISTは有効な機能の一覧、ENDは登録処理の保留解除を示します。

通信例と解説 #

IRCの通信例:Cはクライアント、Sはサーバー
C: CAP LS 302
C: NICK Alice
C: USER alice 0 * :Alice
S: :irc.example CAP * LS :message-tags server-time
C: CAP REQ :server-time
S: :irc.example CAP Alice ACK :server-time
C: CAP END

この例のニックネーム、ホスト、本文は架空のものです。クライアント上では、生のプロトコルより読みやすい形で表示される場合があります。

主な応答とエラー #

応答説明
CAP LS利用できる機能の一覧。途中の * は一覧がまだ続くことを示します。
CAP ACK / NAK有効化の承認、または要求の拒否。
CAP LIST有効な機能の一覧。
エラー一般的な原因
410実装によっては、不正なCAPサブコマンドを示します。
421古いサーバーなど、CAPに対応していない場合の応答。

権限・互換性・注意点 #

LSで通知されただけでは機能は有効になりません。有効化を確認してから使用する必要があります。CAP ENDはチャンネルへの発言ではなく、接続手順の一部です。

CAPは登録完了後にも使える場合があります。ただしサブコマンド、通知されるバージョン、NEW/DEL通知は仕様に従って解釈してください。sasl=PLAINのような機能の値と、その機能名は区別します。

よくある質問 #

なぜCAPには / が付かないのですか?ここではプロトコルを表しており、クライアント内部で処理されるコマンドだからです。

CAPと005 ISUPPORTは同じですか?いいえ。ISUPPORTは特性や制限を通知し、CAPは交渉によって拡張機能を有効にします。

出典と確認

例では、明記した接続先を除き、架空のニックネームとドメインを使用しています。特定のネットワークだけにある拡張や設定は、本文で区別しています。