Copyright (c) 2012 Alexey Sokolov firstname.lastname@example.org
Copyright (c) 2012 Stéphan Kochen email@example.com
Copyright (c) 2012 Kyle Fuller firstname.lastname@example.org
Additional optional tags are added to the start of each message. The message pseudo-BNF, as defined in RFC 1459, section 2.3.1 is extended to look as follows:
<message> ::= ['@' <tags> <SPACE>] [':' <prefix> <SPACE> ] <command> <params> <crlf> <tags> ::= <tag> [';' <tag>]* <tag> ::= <key> ['=' <value>] <key> ::= [ <vendor> '/' ] <sequence of letters, digits, hyphens (`-`)> <value> ::= <sequence of any characters except NUL, BELL, CR, LF, semicolon (`;`) and SPACE> <vendor> ::= <host>
Every message tag is enabled by a capability. The same capability can be used for several tags, if these tags are intended to be used together.
Every tag can have own rules when it can be used: from client to server only, from server to client only, or in both directions.
Server MUST NOT add a tag to messages, if client didn't request the capability which enables the tag using
Server MUST NOT add a tag to messages before replying to client's
CAP REQ with
If client requested a capability, which enables one or more message tags, client MUST be able to parse the tags syntax.
Client MUST NOT add a tag to messages before server replies to client's
CAP REQ with
If server accepted the capability request with
CAP ACK, server MUST be able to parse the tags syntax.
Client and server MAY parse the tags even without any capabilities enabled. They SHOULD ignore tags of capabilities which are not enabled.
This ensures back-compatibility with standard IRC protocol, because no capabilities are enabled by default, and therefore messages can't have any tags unless client explicitly enables such capabilities.
Size limit for the message tags MUST be 512 bytes, including
@ and the trailing space characters, leaving 510 bytes for tags themselves.
So the total size of a message becomes limited by 1024 bytes: 512 bytes for message tags, and 512 bytes for the rest as specified by RFC 1459.
If a message has multiple tags, order of the tags MUST NOT matter. The same tag MUST NOT appear on the same message two or more times.
There are two tag namespaces:
Vendor-Specific: Names which contain a slash character (
/) designate a vendor-specific
tag namespace. These names are prefixed by a valid DNS domain name.
znc.in/server-time. Vendor-Specific tags should be submitted to the
IRCv3 working group for consideration.
Standardized: Names for which a corresponding document sits in the IRCv3 Extension Registry. Names in the IRCv3 Extension Registry are reserved for your tag.
Message with 0 tags:
:email@example.com PRIVMSG me :Hello
Message with 3 tags:
aaa with value
message is tagged with standardized tag
ddd specific to software of
example.com with value
@aaa=bbb;ccc;example.com/ddd=eee :firstname.lastname@example.org PRIVMSG me :Hello
|home > specification > message-tags-3.2|