Đi đến nội dung
Dialova

Tài liệu IRC · Nâng cao

Lệnh CAP: liệt kê và thương lượng phần mở rộng

CAP là lệnh thương lượng các tiện ích mở rộng IRC. Nó cho phép trình khách bật những cơ chế mà mình hỗ trợ. Hướng dẫn IRCv3 CAP giải thích các bước chuyển trạng thái; trang này giúp nhận diện cú pháp trong nhật ký.

Đội ngũ Dialova · Đã kiểm tra ngày

Cú pháp và tham số #

Cú pháp giao thức, không có dấu / của trình khách
CAP <LS [302] | LIST | REQ :<kha-nang> | END>
Tham sốÝ nghĩa
LS 302Yêu cầu danh sách theo cơ chế công bố hiện đại, gồm giá trị và phản hồi có thể chia thành nhiều phần.
REQYêu cầu bật các khả năng đã chọn; ACK hoặc NAK trả lời yêu cầu.
LIST / ENDLIST mô tả các khả năng đang bật; END kết thúc việc tạm dừng đăng ký kết nối.

Ví dụ có giải thích #

Trao đổi IRC: C = trình khách, S = máy chủ
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

Biệt danh, tên máy và nội dung trong ví dụ đều là giả định. Trình khách có thể trình bày phản hồi dễ đọc hơn các dòng giao thức bên dưới.

Phản hồi và lỗi có thể gặp #

Phản hồiGiải thích
CAP LSDanh sách được cung cấp; dấu * ở phần trung gian cho biết còn phần tiếp theo.
CAP ACK / NAKChấp nhận bật hoặc từ chối yêu cầu.
CAP LISTDanh sách khả năng đang bật.
LỗiNguyên nhân thường gặp
410Lệnh con CAP không hợp lệ theo triển khai.
421Máy chủ cũ không nhận diện CAP.

Quyền hạn, khả năng tương thích và lưu ý #

Công bố LS không bật gì cả. Trình khách chỉ được dùng một khả năng sau khi đã bật thành công. CAP END không gửi tin nhắn vào kênh: đó là một bước của quá trình kết nối.

CAP cũng có thể dùng sau khi đăng ký kết nối. Tuy nhiên, cần diễn giải lệnh con, phiên bản được công bố và thông báo NEW/DEL theo đặc tả. Giá trị của khả năng, chẳng hạn sasl=PLAIN, không phải tên của nó.

Câu hỏi thường gặp #

Vì sao CAP không có dấu /? Đây là giao thức; giao diện xử lý lệnh ở bên trong.

CAP và 005 ISUPPORT có giống nhau không? Không: ISUPPORT mô tả thuộc tính và giới hạn; CAP bật các tiện ích đã được thương lượng.

Nguồn và kiểm chứng

Ví dụ dùng biệt danh và tên miền giả định, trừ các điểm kết nối được nêu rõ. Phần mở rộng và cấu hình riêng của một mạng được chỉ ra trong nội dung.