Langsung ke konten
Dialova

Dokumentasi IRC · Lanjutan

Perintah CAP: mendaftar dan menegosiasikan ekstensi

CAP adalah perintah negosiasi ekstensi IRC. Perintah ini memungkinkan klien mengaktifkan mekanisme yang dipahaminya. Panduan IRCv3 CAP menjelaskan alur statusnya; halaman ini memberikan sintaks yang perlu dikenali dalam catatan protokol.

Tim Dialova · Diperiksa pada

Sintaks dan parameter #

Sintaks protokol, tanpa / milik klien
CAP <LS [302] | LIST | REQ :<kapabilitas> | END>
ParameterArti
LS 302Meminta daftar melalui mekanisme pengumuman modern, termasuk nilai dan balasan yang mungkin terpecah.
REQMeminta aktivasi kemampuan yang dipilih; ACK atau NAK menjawab permintaan tersebut.
LIST / ENDLIST menjelaskan kemampuan aktif; END mengakhiri penundaan pendaftaran.

Contoh dengan penjelasan #

Pertukaran IRC: C = klien, S = server
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

Nama panggilan, host, dan teks dalam contoh ini bersifat rekaan. Klien dapat menampilkan balasan dalam bentuk yang lebih mudah dibaca daripada pesan protokol di sini.

Kemungkinan balasan dan kesalahan #

BalasanPenjelasan
CAP LSDaftar yang ditawarkan; penanda * di tengah menunjukkan masih ada kelanjutannya.
CAP ACK / NAKAktivasi diterima atau permintaan ditolak.
CAP LISTDaftar kemampuan aktif.
KesalahanPenyebab umum
410Subperintah CAP tidak valid menurut implementasi.
421Server lama tidak mengenali CAP.

Hak akses, kompatibilitas, dan hal yang perlu diperhatikan #

Pengumuman LS tidak mengaktifkan apa pun. Klien hanya boleh menggunakan kemampuan setelah diaktifkan. CAP END tidak mengirim pesan ke ruang: ini tahap dalam penyambungan.

CAP juga dapat digunakan setelah pendaftaran. Namun, subperintah, versi yang diumumkan, dan pemberitahuan NEW/DEL harus ditafsirkan sesuai spesifikasi. Nilai kemampuan, misalnya sasl=PLAIN, bukan nama kemampuannya.

Pertanyaan umum #

Mengapa CAP ditulis tanpa /? Yang ditampilkan adalah protokol; antarmuka menangani perintah ini secara internal.

Apakah CAP dan 005 ISUPPORT sama? Tidak: ISUPPORT menjelaskan properti dan batas; CAP mengaktifkan ekstensi melalui negosiasi.

Sumber dan verifikasi

Contoh menggunakan nama panggilan dan domain fiktif, kecuali titik koneksi yang didokumentasikan secara eksplisit. Ekstensi dan pengaturan khusus jaringan dijelaskan dalam teks.