]> jfr.im git - irc/rqf/shadowircd.git/blob - doc/technical/ts6-protocol.txt
76e3fc29e5ab014c0db9060e33e0f03c0c93b2f7
[irc/rqf/shadowircd.git] / doc / technical / ts6-protocol.txt
1 TS6 protocol description
2 Written by Jilles Tjoelker
3
4 General format: much like rfc1459
5 Maximum parameters for a command: 15 (this does not include the prefix
6 and command name)
7
8 SID: a server's unique ID. It is configured in each server and consists of
9 a digit and two alphanumerics. Sending SIDs with lowercase letters is
10 questionable.
11
12 UID: a client's unique ID. It consists of the server's SID and six
13 alphanumerics (so it is nine characters long). The first of the alphanumerics
14 should be a letter, numbers are legal but reserved for future use.
15
16 hunted: a parameter type used for various remote requests. From local users,
17 nicknames and server names are accepted, possibly with wildcards; from servers,
18 UIDs/SIDs (sending names or even wildcards is deprecated). This is done with
19 the function hunt_server(). Any rate limiting should be done locally.
20
21 duration: a parameter type used for ban durations. It is a duration in seconds.
22 A value of 0 means a permanent ban.
23
24 propagation: to which other servers the command is sent
25
26 For all commands with a hunted parameter, the propagation is determined by
27 that, and not otherwise specified.
28
29 For all commands with a target server mask parameter, the propagation is
30 determined by that, and not otherwise specified. The command is sent to all
31 servers with names matching the given mask (for example '*', '*.example.com',
32 'irc.example.com'). Those servers do not have to be directly connected.
33 Targets cannot be SIDs.
34
35 Propagation broadcast means the command is sent to all servers.
36
37 Propagation one-to-one means the command is only sent to the target or the
38 server the target is on.
39
40 Propagation none means the command is never sent to another server if it is
41 received.
42
43 For some other commands, the propagation depends on the parameters and is
44 described in text.
45
46 services server: server mentioned in a service{} block. There are no services
47 servers on EFnet.
48
49 service: client with umode +S. This implies that it is on a services server.
50
51 connection setup:
52 The initiator sends the PASS, CAPAB and SERVER messages. Upon receiving the
53 SERVER, the listener will check the information, and if it is valid, it will
54 send its own PASS, CAPAB and SERVER messages, followed by SVINFO and the burst.
55 Upon receiving the SERVER, the initiator will send SVINFO and the burst. If
56 ziplinks are used, SVINFO is the first compressed message.
57
58 The burst consists of SID and SERVER messages for all known servers, BAN
59 messages for all propagated bans, UID or EUID messages for all known users
60 (possibly followed by ENCAP REALHOST, ENCAP LOGIN and/or AWAY) and SJOIN
61 messages for all known channels (possibly followed by BMASK and/or TB).
62
63 user modes:
64 (all)
65 +D (deaf: does not receive channel messages)
66 +S (network service) (only settable on burst from a services server)
67 +a (appears as server administrator)
68 +i (invisible, see rfc1459)
69 +o (IRC operator, see rfc1459)
70 +w (wallops, see rfc1459) (always propagated for historical reasons)
71 (charybdis TS6)
72 +Q/+R/+g/+l/+s/+z (only locally effective)
73 +Z (ssl user) (only settable on burst)
74 possibly more added by modules
75
76 channel modes:
77 (all)
78 statuses
79 +o (prefix @) (ops)
80 +v (prefix +) (voice)
81 type A
82 +b (ban)
83 +e (ban exception) (capab: EX)
84 +I (invite exception) (capab: IE)
85 type B
86 +k (key: password required to join, <= 23 ascii chars, no : or , or whitespace)
87 type C
88 +l (limit: maximum number of members before further joins are disallowed)
89 type D
90 +m (moderated)
91 +n (no external messages)
92 +p (private: does not appear in /whois to non-members, no /knock allowed)
93 +r (only registered users may join) (only if a services server exists) (capab: SERVICES)
94 +s (secret)
95 +t (only chanops may change topic)
96 (charybdis TS6)
97 type A
98 +q (quiet)
99 type C
100 +f (forward: channel name <= 30 chars)
101 +j (join throttle: N:T with integer N and T)
102 type D
103 +F (free target for +f)
104 +L (large ban list)
105 +P (permanent: does not disappear when empty)
106 +Q (ignore forwards to this)
107 +c (strip colours)
108 +g (allow any member to /invite)
109 +z (send messages blocked by +m to chanops)
110
111 <numeric>
112 source: server
113 parameters: target, any...
114
115 The command name should be three decimal ASCII digits.
116
117 Propagates a "numeric" command reply, such as from a remote WHOIS request.
118
119 If the first digit is 0 (indicating a reply about the local connection), it
120 should be changed to 1 before propagation or sending to a user.
121
122 Numerics to the local server may be sent to opers.
123
124 To avoid infinite loops, servers should not send any replies to numerics.
125
126 The target can be:
127 - a client
128 propagation: one-to-one
129 - a channel name
130 propagation: all servers with -D users on the channel
131
132 Numerics to channels are broken in some older servers.
133
134 ADMIN
135 source: user
136 parameters: hunted
137
138 Remote ADMIN request.
139
140 AWAY
141 source: user
142 propagation: broadcast
143 parameters: opt. away reason
144
145 If the away reason is empty or not present, mark the user as not away.
146 Otherwise, mark the user as away.
147
148 Changing away reason from one non-empty string to another non-empty string
149 may not be propagated.
150
151 BAN
152 charybdis TS6
153 capab: BAN
154 source: any
155 propagation: broadcast (restricted)
156 parameters: type, user mask, host mask, creation TS, duration, lifetime, oper, reason
157
158 Propagates a network wide ban.
159
160 The type is K for K:lines, R for resvs and X for X:lines; other types are
161 reserved. The user mask field is only used for K:lines; for resvs and X:lines
162 the field is ignored in input and sent as an asterisk.
163
164 The creation TS indicates when this ban was last modified. An incoming ban MUST
165 be ignored and not propagated if the creation TS is older than the creation TS
166 of the current ban. If the ban is identical, it SHOULD NOT be propagated to
167 avoid unnecessary network traffic. (Two changes to bans that set the TS to the
168 same value may cause desynchronization.)
169
170 The duration is 0 for an unban and relative to the creation TS for a ban.
171 When the duration has passed, the ban is no longer active but it may still
172 be necessary to remember it.
173
174 The lifetime is relative to the creation TS and indicates for how long this
175 ban needs to be remembered and propagated. This MUST be at least the duration.
176 Initially, it is usually set the same as the duration but when the ban is
177 modified later, it SHOULD be set such that the modified ban is remembered at
178 least as long as the original ban. This ensures that the original ban does not
179 revive via split servers. This requirement is only a SHOULD to allow for
180 implementations that only inject bans and do not remember any; implementations
181 that remember and propagate bans MUST set the lifetime appropriately.
182
183 The oper field indicates the oper that originally set the ban. If this message
184 is the initial propagation of a change, it SHOULD be sent as * (an asterisk).
185
186 The reason field indicates the reason for the ban. Any part after a | (vertical
187 bar) MUST NOT be shown to normal users. The rest of the field and the creation
188 TS and duration MAY be shown to normal users.
189
190 BMASK
191 source: server
192 propagation: broadcast
193 parameters: channelTS, channel, type, space separated masks
194
195 If the channelTS in the message is greater (newer) than the current TS of
196 the channel, drop the message and do not propagate it.
197
198 Type is the mode letter of a ban-like mode. In efnet TS6 this is 'b', 'e' or
199 'I'. In charybdis TS6 additionally 'q' is possible.
200
201 Add all the masks to the given list of the channel.
202
203 All ban-like modes must be bursted using this command, not using MODE or TMODE.
204
205 CAPAB
206 source: unregistered server
207 propagation: none
208 parameters: space separated capability list
209
210 Sends capabilities of the server. This must include QS and ENCAP. It is also
211 strongly recommended to include EX, CHW, IE and KNOCK, and for charybdis TS6
212 also SAVE and EUID. For use with services, SERVICES and RSFNC are strongly
213 recommended.
214
215 The capabilities may depend on the configuration for the server they are sent
216 to.
217
218 CHGHOST
219 charybdis TS6
220 source: any
221 propagation: broadcast
222 parameters: client, new hostname
223
224 Changes the visible hostname of a client.
225
226 Opers are notified unless the source is a server or a service.
227
228 CONNECT
229 source: any
230 parameters: server to connect to, port, hunted
231
232 Remote connect request. A server WALLOPS should be sent by the receiving
233 server.
234
235 The port can be 0 for the default port.
236
237 DLINE
238 charybdis TS6
239 encap only
240 source: user
241 parameters: duration, mask, reason
242
243 Sets a D:line (IP ban checked directly after accepting connection).
244
245 The mask must be an IP address or CIDR mask.
246
247 ENCAP
248 source: any
249 parameters: target server mask, subcommand, opt. parameters...
250
251 Sends a command to matching servers. Propagation is independent of
252 understanding the subcommand.
253
254 Subcommands are listed elsewhere with "encap only".
255
256 ERROR
257 source: server or unregistered server
258 propagation: none
259 parameters: error message
260
261 Reports a (usually fatal) error with the connection.
262
263 Error messages may contain IP addresses and have a negative effect on server
264 IP hiding.
265
266 ETRACE
267 encap only
268 encap target: single server
269 source: oper
270 parameters: client
271
272 Remote ETRACE information request.
273
274 EUID
275 charybdis TS6
276 capab: EUID
277 source: server
278 parameters: nickname, hopcount, nickTS, umodes, username, visible hostname, IP address, UID, real hostname, account name, gecos
279 propagation: broadcast
280
281 Introduces a client. The client is on the source server of this command.
282
283 The account name is '0' if the user is not logged in with services.
284
285 Nick TS rules apply.
286
287 EUID is similar to UID but includes the ENCAP REALHOST and ENCAP LOGIN
288 information.
289
290 GCAP
291 encap only
292 encap target: *
293 source: server
294 parameters: space separated capability list
295
296 Capability list of remote server.
297
298 GLINE
299 efnet TS6
300 capab: GLN
301 source: user
302 parameters: user mask, host mask, reason
303 propagation: broadcast
304
305 Propagates a G:line vote. Once votes from three different opers (based on
306 user@host mask) on three different servers have arrived, trigger the G:line.
307 Pending G:lines expire after some time, usually ten minutes. Triggered G:lines
308 expire after a configured time which may differ across servers.
309
310 Requests from server connections must be propagated, unless they are found to
311 be syntactically invalid (e.g. '!' in user mask). Therefore, disabling glines
312 must not affect propagation, and too wide glines, double votes and glines that
313 already exist locally must still be propagated.
314
315 Of course, servers are free to reject gline requests from their own operators.
316
317 GUNGLINE
318 efnet TS6
319 encap only
320 encap target: *
321 source: user
322 parameters: user mask, host mask, reason
323 propagation: broadcast
324
325 Propagates a G:line removal vote. Once three votes have arrived (as with
326 G:lines), remove the G:line. Pending G:lines removals expire after some time,
327 usually ten minutes.
328
329 Pending G:line removals do not interact with pending G:lines. Triggering a
330 G:line does not affect a pending G:line removal. Triggering a G:line removal
331 does not affect a pending G:line.
332
333 INFO
334 source: user
335 parameters: hunted
336
337 Remote INFO request.
338
339 INVITE
340 source: user
341 parameters: target user, channel, opt. channelTS
342 propagation: one-to-one
343
344 Invites a user to a channel.
345
346 If the channelTS is greater (newer) than the current TS of the channel, drop
347 the message.
348
349 Not sending the channelTS parameter is deprecated.
350
351 JOIN
352 1.
353 source: user
354 parameters: '0' (one ASCII zero)
355 propagation: broadcast
356
357 Parts the source user from all channels.
358
359 2.
360 source: user
361 parameters: channelTS, channel, '+' (a plus sign)
362 propagation: broadcast
363
364 Joins the source user to the given channel. If the channel does not exist yet,
365 it is created with the given channelTS and no modes. If the channel already
366 exists and has a greater (newer) TS, wipe all simple modes and statuses and
367 change the TS, notifying local users of this but not servers (note that
368 ban-like modes remain intact; invites may or may not be cleared).
369
370 A JOIN is propagated with the new TS of the channel.
371
372 KICK
373 source: any
374 parameters: channel, target user, opt. reason
375 propagation: broadcast
376
377 Kicks the target user from the given channel.
378
379 Unless the channel's TS is 0, no check is done whether the source user has ops.
380
381 Not sending the reason parameter is questionable.
382
383 KILL
384 source: any
385 parameters: target user, path
386 propagation: broadcast
387
388 Removes the user from the network.
389
390 The format of the path parameter is some sort of description of the source of
391 the kill followed by a space and a parenthesized reason. To avoid overflow,
392 it is recommended not to add anything to the path.
393
394 KLINE
395 1.
396 encap only
397 source: user
398 parameters: duration, user mask, host mask, reason
399
400 Sets a K:line (ban on user@host).
401
402 2.
403 capab: KLN
404 source: user
405 parameters: target server mask, duration, user mask, host mask, reason
406
407 As form 1, deprecated.
408
409 KNOCK
410 capab: KNOCK
411 source: user
412 parameters: channel
413 propagation: broadcast
414
415 Requests an invite to a channel that is locked somehow (+ikl). Notifies all
416 operators of the channel. (In charybdis, on +g channels all members are
417 notified.)
418
419 This is broadcast so that each server can store when KNOCK was used last on
420 a channel.
421
422 LINKS
423 source: user
424 parameters: hunted, server mask
425
426 Remote LINKS request. The server mask limits which servers are listed.
427
428 LOCOPS
429 1.
430 encap only
431 source: user
432 parameters: text
433
434 Sends a message to operators (with umode +l set). This is intended to be
435 used for strict subsets of the network.
436
437 2.
438 capab: CLUSTER
439 source: user
440 parameters: target server mask, text
441
442 As form 1, deprecated.
443
444 LOGIN
445 encap only
446 source: user
447 parameters: account name
448
449 In a burst, states that the source user is logged in as the account.
450
451 LUSERS
452 source: user
453 parameters: server mask, hunted
454
455 Remote LUSERS request. Most servers ignore the server mask, treating it as '*'.
456
457 MLOCK
458 charybdis TS6
459 source: services server
460 parameters: channelTS, channel, mode letters
461 propagation: broadcast (restricted)
462
463 Propagates a channel mode lock change.
464
465 If the channelTS is greater (newer) than the current TS of the channel, drop
466 the message.
467
468 The final parameter is a list of mode letters that may not be changed by local
469 users. This applies to setting or unsetting simple modes, and changing or
470 removing mode parameters.
471
472 An MLOCK message with no modes disables the MLOCK, therefore the MLOCK message
473 always contains the literal MLOCK for simplicity.
474
475 MODE
476 1.
477 source: user
478 parameters: client, umode changes
479 propagation: broadcast
480
481 Propagates a user mode change. The client parameter must refer to the same user
482 as the source.
483
484 Not all umodes are propagated to other servers.
485
486 2.
487 source: any
488 parameters: channel, cmode changes, opt. cmode parameters...
489
490 Propagates a channel mode change.
491
492 This is deprecated because the channelTS is not included. If it is received,
493 it should be propagated as TMODE.
494
495 MOTD
496 source: user
497 parameters: hunted
498
499 Remote MOTD request.
500
501 NICK
502 1.
503 source: user
504 parameters: new nickname, new nickTS
505 propagation: broadcast
506
507 Propagates a nick change.
508
509 2.
510 source: server
511 parameters: nickname, hopcount, nickTS, umodes, username, hostname, server, gecos
512
513 Historic TS5 user introduction. The user is on the server indicated by the
514 server parameter; the source server is meaningless (local link).
515
516 NICKDELAY
517 charybdis TS6
518 encap only
519 encap target: *
520 source: services server
521 parameters: duration, nickname
522
523 If duration is greater than 0, makes the given nickname unavailable for that
524 time.
525
526 If duration is 0, removes a nick delay entry for the given nickname.
527
528 There may or may not be a client with the given nickname; this does not affect
529 the operation.
530
531 NOTICE
532 source: any
533 parameters: msgtarget, message
534
535 As PRIVMSG, except NOTICE messages are sent out, server sources are permitted
536 and most error messages are suppressed.
537
538 Servers may not send '$$', '$#' and opers@server notices. Older servers may
539 not allow servers to send to specific statuses on a channel.
540
541 OPERSPY
542 encap only
543 encap target: *
544 source: user
545 parameters: command name, parameters
546
547 Reports operspy usage.
548
549 OPERWALL
550 source: user
551 parameters: message
552 propagation: broadcast
553
554 Sends a message to operators (with umode +z set).
555
556 PART
557 source: user
558 parameters: comma separated channel list, message
559
560 Parts the source user from the given channels.
561
562 PASS
563 source: unregistered server
564 parameters: password, 'TS', TS version, SID
565
566 Sends the server link password, TS version and SID.
567
568 PING
569 source: any
570 parameters: origin, opt. destination server
571
572 Sends a PING to the destination server, which will reply with a PONG. If the
573 destination server parameter is not present, the server receiving the message
574 must reply.
575
576 The origin field is not used in the server protocol. It is sent as the name
577 (not UID/SID) of the source.
578
579 Remote PINGs are used for end-of-burst detection, therefore all servers must
580 implement them.
581
582 PONG
583 source: server
584 parameters: origin, destination
585
586 Routes a PONG back to the destination that originally sent the PING.
587
588 PRIVMSG
589 source: user
590 parameters: msgtarget, message
591
592 Sends a normal message (PRIVMSG) to the given target.
593
594 The target can be:
595 - a client
596 propagation: one-to-one
597 - a channel name
598 propagation: all servers with -D users on the channel
599 (cmode +m/+n should be checked everywhere, bans should not be checked
600 remotely)
601 - a status character ('@'/'+') followed by a channel name, to send to users
602 with that status or higher only.
603 capab: CHW
604 propagation: all servers with -D users with appropriate status
605 - '=' followed by a channel name, to send to chanops only, for cmode +z.
606 capab: CHW and EOPMOD
607 propagation: all servers with -D chanops
608 - a user@server message, to send to users on a specific server. The exact
609 meaning of the part before the '@' is not prescribed, except that "opers"
610 allows IRC operators to send to all IRC operators on the server in an
611 unspecified format.
612 propagation: one-to-one
613 - a message to all users on server names matching a mask ('$$' followed by mask)
614 propagation: broadcast
615 Only allowed to IRC operators.
616 - a message to all users with hostnames matching a mask ('$#' followed by mask).
617 Note that this is often implemented poorly.
618 propagation: broadcast
619 Only allowed to IRC operators.
620
621 In charybdis TS6, services may send to any channel and to statuses on any
622 channel.
623
624 PRIVS
625 charybdis TS6
626 encap only
627 encap target: single server
628 source: oper
629 parameters: client
630
631 Remote PRIVS information request.
632
633 QUIT
634 source: user
635 parameters: comment
636
637 Propagates quitting of a client. No QUIT should be sent for a client that
638 has been removed as result of a KILL message.
639
640 REALHOST
641 charybdis TS6
642 encap only
643 encap target: *
644 source: user
645 parameters: real hostname
646
647 In a burst, propagates the real host of a dynamically-spoofed user.
648
649 REHASH
650 charybdis TS6
651 encap only
652 source: user
653 parameters: opt. rehash type
654
655 Remote REHASH request. If the rehash type is omitted, it is equivalent to
656 a regular /rehash, otherwise it is equivalent to /rehash <rehash type>.
657
658 RESV
659 1.
660 encap only
661 source: user
662 parameters: duration, mask, reason
663
664 Sets a RESV, making a nickname mask or exact channel unavailable.
665
666 2.
667 capab: CLUSTER
668 source: user
669 parameters: target server mask, duration, mask, reason
670
671 As form 1, deprecated.
672
673 RSFNC
674 encap only
675 capab: RSFNC
676 encap target: single server
677 source: services server
678 parameters: target user, new nickname, old nickTS, new nickTS
679
680 Forces a nickname change and propagates it.
681
682 The command is ignored if the nick TS of the user is not equal to the old
683 nickTS parameter. If the new nickname already exists (and is not the target
684 user), it is killed first.
685
686 SASL
687 charybdis TS6
688 encap only
689 1.
690 encap target: *
691 source: server
692 parameters: source uid, '*', 'S', sasl mechanism name
693
694 Requests that a SASL agent (a service) initiate the authentication process.
695 The source uid is that of an unregistered client. This is why it is not sent
696 as the prefix.
697
698 2.
699 encap target: single server
700 source: server
701 parameters: source uid, target uid, mode, data
702
703 Part of a SASL authentication exchange. The mode is 'C' to send some data
704 (base64 encoded), or 'S' to end the exchange (data indicates type of
705 termination: 'A' for abort, 'F' for authentication failure, 'S' for
706 authentication success).
707
708 SAVE
709 capab: SAVE
710 source: server
711 propagation: broadcast
712 parameters: target uid, TS
713
714 Resolve a nick collision by changing a nickname to the UID.
715
716 The server should verify that the UID belongs to a registered user, the user
717 does not already have their UID as their nick and the TS matches the user's
718 nickTS. If not, drop the message.
719
720 SAVE should be propagated as a regular NICK change to links without SAVE capab.
721 present.
722
723 SERVER
724 1.
725 source: unregistered server
726 parameters: server name, hopcount, server description
727
728 Registers the connection as a server. PASS and CAPAB must have been sent
729 before, SVINFO should be sent afterwards.
730
731 If there is no such server configured or authentication failed, the connection
732 should be dropped.
733
734 This is propagated as a SID message.
735
736 2.
737 source: server
738 propagation: broadcast
739 parameters: server name, hopcount, server description
740
741 Introduces a new TS5 server, directly connected to the source of this command.
742 This is only used for jupes as TS5 servers may do little else than existing.
743
744 SID
745 source: server
746 propagation: broadcast
747 parameters: server name, hopcount, sid, server description
748
749 Introduces a new server, directly connected to the source of this command.
750
751 SIGNON
752 source: user
753 propagation: broadcast
754 parameters: new nickname, new username, new visible hostname, new nickTS, new login name
755
756 Broadcasts a change of several user parameters at once.
757
758 Currently only sent after an SVSLOGIN.
759
760 SJOIN
761 source: server
762 propagation: broadcast
763 parameters: channelTS, simple modes, opt. mode parameters..., nicklist
764
765 Broadcasts a channel creation or bursts a channel.
766
767 The nicklist consists of users joining the channel, with status prefixes for
768 their status ('@+', '@', '+' or ''), for example:
769 '@+1JJAAAAAB +2JJAAAA4C 1JJAAAADS'. All users must be behind the source server
770 so it is not possible to use this message to force users to join a channel.
771
772 The interpretation depends on the channelTS and the current TS of the channel.
773 If either is 0, set the channel's TS to 0 and accept all modes. Otherwise, if
774 the incoming channelTS is greater (newer), ignore the incoming simple modes
775 and statuses and join and propagate just the users. If the incoming channelTS
776 is lower (older), wipe all modes and change the TS, notifying local users of
777 this but not servers (invites may be cleared). In the latter case, kick on
778 split riding may happen: if the key (+k) differs or the incoming simple modes
779 include +i, kick all local users, sending KICK messages to servers.
780
781 An SJOIN is propagated with the new TS and modes of the channel. The statuses
782 are propagated if and only if they were accepted.
783
784 SJOIN must be used to propagate channel creation and in netbursts. For regular
785 users joining channels, JOIN must be used. Pseudoservers may use SJOIN to join
786 a user with ops.
787
788 SNOTE
789 charybdis TS6
790 encap only
791 source: server
792 parameters: snomask letter, text
793
794 Sends the text as a server notice from the source server to opers with the
795 given snomask set.
796
797 SQUIT
798 parameters: target server, comment
799
800 Removes the target server and all servers and users behind it from the network.
801
802 If the target server is the receiving server or the local link this came from,
803 this is an announcement that the link is being closed.
804
805 Otherwise, if the target server is locally connected, the server should send
806 a WALLOPS announcing the SQUIT.
807
808 STATS
809 source: user
810 parameters: stats letter, hunted
811
812 Remote STATS request. Privileges are checked on the server executing the
813 actual request.
814
815 SU
816 encap only
817 encap target: *
818 source: services server
819 parameters: target user, new login name (optional)
820
821 If the new login name is not present or empty, mark the target user as not
822 logged in, otherwise mark the target user as logged in as the given account.
823
824 SVINFO
825 source: server
826 propagation: none
827 parameters: current TS version, minimum TS version, '0', current time
828
829 Verifies TS protocol compatibility and clock. If anything is not in order,
830 the link is dropped.
831
832 The current TS version is the highest version supported by the source server
833 and the minimum TS version is the lowest version supported.
834
835 The current time is sent as a TS in the usual way.
836
837 SVSLOGIN
838 charybdis TS6
839 encap only
840 encap target: single server
841 source: services server
842 parameters: target, new nick, new username, new visible hostname, new login name
843
844 Sent after successful SASL authentication.
845
846 The target is a UID, typically an unregistered one.
847
848 Any of the "new" parameters can be '*' to leave the corresponding field
849 unchanged. The new login name can be '0' to log the user out.
850
851 If the UID is registered on the network, a SIGNON with the changes will be
852 broadcast, otherwise the changes will be stored, to be used when registration
853 completes.
854
855 TB
856 capab: TB
857 source: server
858 propagation: broadcast
859 parameters: channel, topicTS, opt. topic setter, topic
860
861 Propagates a channel topic as part of a burst.
862
863 If the channel had no topic yet or the topicTS in the message is older than
864 the topicTS of the current topic on the channel and the topics differ, set
865 the topic with topicTS and topic setter, and propagate the message. Otherwise
866 ignore the message and do not propagate it.
867
868 If the topic setter is not present, use a server name instead.
869
870 TIME
871 source: user
872 parameters: hunted
873
874 Remote TIME request.
875
876 TMODE
877 source: any
878 parameters: channelTS, channel, cmode changes, opt. cmode parameters...
879
880 Propagates a channel mode change.
881
882 If the channelTS is greater (newer) than the current TS of the channel, drop
883 the message.
884
885 On input, only the limit on parameters per line restricts how many cmode
886 parameters can be present. Apart from this, arbitrary modes shall be
887 processed. Redundant modes may be dropped. For example, +n-n may be applied and
888 propagated as +n-n, -n or (if the channel was already -n) nothing, but not as
889 +n.
890
891 The parameter for mode -k (removing a key) shall be ignored.
892
893 On output, at most ten cmode parameters should be sent; if there are more,
894 multiple TMODE messages should be sent.
895
896 TOPIC
897 source: user
898 propagation: broadcast
899 parameters: channel, topic
900
901 Propagates a channel topic change. The server may verify that the source has
902 ops in the channel.
903
904 The topicTS shall be set to the current time and the topic setter shall be
905 set indicating the source user. Note that this means that the topicTS of a
906 topic set with TOPIC is not necessarily consistent across the network.
907
908 TRACE
909 source: user
910 1.
911 parameters: hunted
912
913 Performs a trace to the target, sending 200 numerics from each server passing
914 the message on. The target server sends a description of the target followed
915 by a 262 numeric.
916
917 TRACE, STATS l and STATS L are the only commands using hunt_server that use the
918 hunted parameter for more than just determining which server the command
919 should be executed on.
920
921 2.
922 parameters: target name, hunted
923
924 Executes a trace command on the target server. No 200 numerics are sent.
925 The target name is a name, not a UID, and should be on the target server.
926
927 UID
928 source: server
929 propagation: broadcast
930 parameters: nickname, hopcount, nickTS, umodes, username, visible hostname, IP address, UID, gecos
931 propagation: broadcast
932
933 Introduces a client. The client is on the source server of this command.
934
935 Nick TS rules apply.
936
937 UNDLINE
938 charybdis TS6
939 encap only
940 source: user
941 parameters: mask
942
943 Removes a D:line (IP ban checked directly after accepting connection).
944
945 The mask must be an IP address or CIDR mask.
946
947 UNKLINE
948 1.
949 encap only
950 source: user
951 parameters: user mask, host mask
952
953 Removes a K:line (ban on user@host).
954
955 2.
956 capab: UNKLN
957 source: user
958 parameters: target server mask, user mask, host mask
959
960 As form 1, deprecated.
961
962 UNRESV
963 1.
964 encap only
965 source: user
966 parameters: mask
967
968 Removes a RESV.
969
970 2.
971 capab: CLUSTER
972 source: user
973 parameters: target server mask, mask
974
975 As form 1, deprecated.
976
977 UNXLINE
978 1.
979 encap only
980 source: user
981 parameters: mask
982
983 Removes an X:line (ban on realname).
984
985 2.
986 capab: CLUSTER
987 source: user
988 parameters: target server mask, mask
989
990 As form 1, deprecated.
991
992 USERS
993 source: user
994 parameters: hunted
995
996 Remote USERS request.
997
998 VERSION
999 source: any
1000 parameters: hunted
1001
1002 Remote VERSION request.
1003
1004 WALLOPS
1005 1.
1006 source: user
1007 parameters: message
1008 propagation: broadcast
1009
1010 In efnet TS6, sends a message to operators (with umode +z set). This is a
1011 deprecated equivalent to OPERWALL.
1012
1013 In charybdis TS6, sends a message to local users with umode +w set (or possibly
1014 another indication that WALLOPS messages should be sent), including non-opers.
1015
1016 2.
1017 source: server
1018 parameters: message
1019 propagation: broadcast
1020
1021 Sends a message to local users with umode +w set (or possibly another
1022 indication that WALLOPS messages should be sent).
1023
1024 In efnet TS6 this may include non-opers, in charybdis TS6 this may only be
1025 sent to opers.
1026
1027 WHOIS
1028 source: user
1029 parameters: hunted, target nick
1030
1031 Remote WHOIS request.
1032
1033 XLINE
1034 1.
1035 encap only
1036 source: user
1037 parameters: duration, mask, reason
1038
1039 Sets an X:line (ban on realname).
1040
1041 2.
1042 capab: CLUSTER
1043 source: user
1044 parameters: target server mask, duration, mask, reason
1045
1046 As form 1, deprecated.
1047
1048 Local only commands (charybdis 3.1):
1049
1050 ACCEPT
1051 AUTHENTICATE
1052 CAP
1053 CHALLENGE
1054 CHANTRACE
1055 CLOSE
1056 CNOTICE
1057 CPRIVMSG
1058 DIE
1059 GET
1060 HELP
1061 ISON
1062 LIST
1063 MAP
1064 MASKTRACE
1065 MODLIST
1066 MODLOAD
1067 MODRELOAD
1068 MODRESTART
1069 MODUNLOAD
1070 MONITOR
1071 NAMES
1072 OPER
1073 POST
1074 PUT
1075 RESTART
1076 SCAN
1077 SET
1078 TESTGECOS
1079 TESTLINE
1080 TESTMASK
1081 UHELP
1082 UNREJECT
1083 USER
1084 USERHOST
1085 WEBIRC
1086 WHO
1087 WHOWAS