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 #
CAP <LS [302] | LIST | REQ :<kapabilitas> | END>| Parameter | Arti |
|---|---|
| LS 302 | Meminta daftar melalui mekanisme pengumuman modern, termasuk nilai dan balasan yang mungkin terpecah. |
| REQ | Meminta aktivasi kemampuan yang dipilih; ACK atau NAK menjawab permintaan tersebut. |
| LIST / END | LIST menjelaskan kemampuan aktif; END mengakhiri penundaan pendaftaran. |
Contoh dengan penjelasan #
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 ENDNama 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 #
| Balasan | Penjelasan |
|---|---|
| CAP LS | Daftar yang ditawarkan; penanda * di tengah menunjukkan masih ada kelanjutannya. |
| CAP ACK / NAK | Aktivasi diterima atau permintaan ditolak. |
| CAP LIST | Daftar kemampuan aktif. |
| Kesalahan | Penyebab umum |
|---|---|
| 410 | Subperintah CAP tidak valid menurut implementasi. |
| 421 | Server 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.
- Modern IRC — spesifikasi protokol klien ↗Sumber spesifikasi · diakses pada 2026-10-29
- IRCv3 — negosiasi kapabilitas klien ↗Sumber spesifikasi · diakses pada 2026-10-29