İçeriğe geç
Dialova

IRC belgeleri · İleri

CAP komutu: uzantıları listelemek ve uzlaşmak

CAP, IRC uzantıları için uzlaşma komutudur. İstemci anladığı mekanizmaları etkinleştirmek için kullanır. IRCv3 CAP rehberi durum makinesini ayrıntılandırır; bu sayfa günlükte tanınacak sözdizimini sunar.

Dialova ekibi · Kontrol tarihi

Sözdizimi ve parametreler #

İstemcinin / işareti olmadan protokol sözdizimi
CAP <LS [302] | LIST | REQ :<yetenekler> | END>
ParametreAnlamı
LS 302Değerler ve gerekirse parçalı yanıtlar dahil modern duyuru yöntemiyle liste ister.
REQSeçilen yeteneklerin etkinleştirilmesini ister; ACK veya NAK ile yanıtlanır.
LIST / ENDLIST etkin yetenekleri gösterir; END kayıt bekletmesini sonlandırır.

Açıklamalı örnek #

IRC iletişimi: C = istemci, S = sunucu
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

Bu iletişimdeki takma adlar, sunucular ve metinler kurgusaldır. İstemciniz yanıtları burada gösterilen protokol satırlarından daha okunabilir biçimde sunabilir.

Olası yanıtlar ve hatalar #

YanıtAçıklama
CAP LSSunulan liste; aradaki * işareti devam ettiğini belirtir.
CAP ACK / NAKEtkinleştirme kabul edildi veya istek reddedildi.
CAP LISTEtkin yetenekler listesi.
HataYaygın neden
410Uygulamaya göre geçersiz CAP alt komutu.
421CAP’i tanımayan tarihî sunucu.

Yetkiler, uyumluluk ve önlemler #

LS duyurusu hiçbir şeyi etkinleştirmez. İstemci yeteneği ancak etkinleştirildikten sonra kullanmalıdır. CAP END kanala mesaj göndermez; bağlantının bir adımıdır.

CAP kayıttan sonra da çalışabilir. Ancak alt komutlar, duyurulan sürüm ve NEW/DEL bildirimleri belirtime göre yorumlanmalıdır. sasl=PLAIN gibi yetenek değeri, yeteneğin adı değildir.

Sık sorulan sorular #

CAP neden / olmadan görünüyor? Burada protokol gösterilir; arayüz bu komutu kendi içinde yönetir.

CAP ve 005 ISUPPORT aynı işi mi yapar? Hayır. ISUPPORT özellik ve sınırları açıklar; CAP üzerinde uzlaşılan uzantıları etkinleştirir.

Kaynaklar ve doğrulama

Açıkça belgelenen bağlantı adresleri dışında örneklerde kurgusal takma adlar ve alan adları kullanılır. Ağa özgü uzantılar ve ayarlar metinde belirtilir.