doc/Commands.txt

   1
   2                      ngIRCd - Next Generation IRC Server
   3                            http://ngircd.barton.de/
   4
   5                (c)2001-2013 Alexander Barton and Contributors.
   6                ngIRCd is free software and published under the
   7                    terms of the GNU General Public License.
   8
   9                               -- Commands.txt --
  10
  11
  12 This file lists all commands available on ngIRCd. It is written in a format
  13 that is human readable as well as machine parseable and therefore can be used
  14 as "help text file" of the daemon.
  15
  16 In short, the daemon reads this file on startup and parses it as following
  17 when an user issues a "HELP <cmd>" command:
  18
  19  1. Search the file for a line "- <cmd>",
  20  2. Output all subsequent lines that start with a TAB (ASCII 9) character
  21     to the client using NOTICE commands, treat lines containing a single "."
  22     after the TAB as empty lines.
  23  3. Break at the first line not starting with a TAB character.
  24
  25 This format allows to have information to each command stored in this file
  26 which will not be sent to an IRC user requesting help which enables us to
  27 have additional annotations stored here which further describe the origin,
  28 implementation details, or limits of the specific command which are not
  29 relevant to an end-user but administrators and developers.
  30
  31 A special "Intro" block is returned to the user when the HELP command is
  32 used without a command name:
  33
  34
  35 - Intro
  36         This is ngIRCd, a server software for Internet Relay Chat (IRC)
  37         networks. You can find more information about ngIRCd on its homepage:
  38                 <http://ngircd.barton.de>
  39         .
  40         Use "HELP COMMANDS" to get a list of all available commands and
  41         "HELP <command-name>" to get help for a specific IRC command, for
  42         example "HELP quit" or "HELP privmsg".
  43
  44
  45 Connection Handling Commands
  46 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  47
  48 - CAP
  49         CAP LS
  50         CAP LIST
  51         CAP REQ <capabilities>
  52         CAP ACK <capabilities>
  53         CAP NAK <capabilities>
  54         CAP CLEAR
  55         CAP END
  56         .
  57         List, request, and clear "IRC Capabilities".
  58         .
  59         Using this command, an IRC client can request additional "IRC
  60         capabilities" during login or later on, which influences the
  61         communication between server and client. Normally, these commands
  62         aren't directly used by humans, but automatically by their client
  63         software. And please note that issuing such commands manually can
  64         irritate the client software used, because of the "non-standard"
  65         behavior of the server!
  66         .
  67         - CAP LS: list all available capabilities.
  68         - CAP LIST: list active capabilities of this connection.
  69         - CAP REQ: Request particular capabilities.
  70         - CAP ACK: Acknowledge a set of capabilities to be enabled/disabled.
  71         - CAP NAK: Reject a set of capabilities.
  72         - CAP CLEAR: Clear all set capabilities.
  73         - CAP END: Indicate end of capability negotiation during login,
  74           ignored in an fully registered session.
  75
  76         Please note that the <capabilities> must be given in a single
  77         parameter but whitespace separated, therefore a command could look
  78         like this: "CAP REQ :capability1 capability2 capability3" for example.
  79
  80         References:
  81          - <http://ircv3.atheme.org/specification/capability-negotiation-3.1>
  82          - <http://ngircd.barton.de/doc/Capabilities.txt>
  83          - doc/Capabilities.txt
  84
  85 - CHARCONV
  86         CHARCONV <client-charset>
  87         .
  88         Set client character set encoding to <client-charset>.
  89         .
  90         After receiving such a command, the server translates all message
  91         data received from the client using the set <client-charset> to the
  92         server encoding (UTF-8), and all message data which is to be sent to
  93         the client from the server encoding (UTF-8) to <client-charset>.
  94         .
  95         This enables older clients and clients using "strange" character sets
  96         to transparently participate in channels and direct messages to
  97         clients using UTF-8, which should be the default today.
  98
  99         References:
 100          - IRC+, <http://ngircd.barton.de/doc/Protocol.txt>
 101          - IRC+, doc/Protocol.txt
 102
 103 - NICK
 104         NICK <nickname>
 105         NICK <nickname> [<hops>]
 106         NICK <nickname> <hops> <username> <host> <servertoken> <usermodes> <realname>
 107         .
 108         Set or change the <nickname> of a client (first form) and register
 109         remote clients (second and third form; servers only).
 110
 111         References:
 112          - RFC 1459, 4.1.2 "Nick message" (old client and server protocol)
 113          - RFC 2812, 3.1.2 "Nick message" (client protocol)
 114          - RFC 2813, 4.1.3 "Nick" (server protocol)
 115
 116 - PASS
 117         PASS <password>
 118         PASS <password> <version> <flags> [<options>]
 119         .
 120         Set a connection <password>. This command must be the first command
 121         sent to the server, even before the NICK/USER or SERVER commands.
 122         .
 123         The first form is used by user sessions or (old) RFC 1459 servers,
 124         the second form is used by RFC 2812 or IRC+ compliant servers and
 125         enables the server to indicate its version and supported protocol
 126         features.
 127
 128         References:
 129          - RFC 1459, 4.1.1 "Password message" (old client and server protocol)
 130          - RFC 2812, 3.1.1 "Password message" (client protocol)
 131          - RFC 2813, 4.1.1 "Password message" (server protocol)
 132          - IRC+, <http://ngircd.barton.de/doc/Protocol.txt>
 133          - IRC+, doc/Protocol.txt
 134
 135 - PING
 136         PING <token> [<target>]
 137         .
 138         Tests the presence of a connection to a client or server.
 139         .
 140         If no <target> has been given, the local server is used. User clients
 141         can only use other servers as <target>, no user clients.
 142         .
 143         A PING message results in a PONG reply containing the <token>, which
 144         can be arbitrary text.
 145
 146         Please note:
 147         The RFCs state that the <token> parameter is used to specify the
 148         origin of the PING command when forwarded in the network, but this
 149         is not the case: the sender is specified using the prefix as usual,
 150         and the parameter is used to identify the PONG reply in practice.
 151
 152         References:
 153          - RFC 2812, 3.7.2 "Ping message"
 154
 155 - PONG
 156         PONG <target> [<token>]
 157         .
 158         Reply to a "PING" command, indicate that the connection is alive.
 159         .
 160         The <token> is the arbitrary text received in the "PING" command and
 161         can be used to identify the correct PONG sent as answer.
 162         .
 163         When the "PONG" command is received from a user session, the <target>
 164         parameter is ignored; otherwise the PONG is forwarded to this client.
 165
 166         References:
 167          - RFC 2812, 3.7.3 "Pong message"
 168
 169 - QUIT
 170         QUIT [<quit-message>]
 171         .
 172         Terminate a user session.
 173         .
 174         When received from a user, the server acknowledges this by sending
 175         an "ERROR" message back to the client and terminates the connection.
 176         .
 177         When a <quit-message> has been given, it is sent to all the channels
 178         that the client is a member of when leaving.
 179
 180         References:
 181          - RFC 2812, 3.1.7 "Quit"
 182          - RFC 2813, 4.1.5 "Quit"
 183
 184 - USER
 185         USER <username> <hostname> <unused> <realname>
 186         .
 187         Register (and authenticate) a new user session with a short <username>
 188         and a human-readable <realname>.
 189         .
 190         The parameter <hostname> is only used when received by an other server
 191         and ignored otherwise; and the parameter <unused> is always ignored.
 192         But both parameters are required on each invocation by the protocol
 193         and can be set to arbitrary characters/text when not used.
 194         .
 195         If <username> contains an "@" character, the full <username> is used
 196         for authentication, but only the first part up to this character is
 197         set as "user name" for this session.
 198
 199         References:
 200          - RFC 2812, 3.1.3 "User message"
 201
 202 - WEBIRC
 203         WEBIRC <password> <username> <hostname> <ip-address>
 204         .
 205         Allow Web-to-IRC gateway software (for example) to set the correct
 206         user name and host name of users instead of their own.
 207         .
 208         It must be the very first command sent to the server, even before
 209         USER and NICK commands!
 210         .
 211         The <password> must be set in the server configuration file to prevent
 212         unauthorized clients to fake their identity; it is an arbitrary string.
 213
 214         References:
 215          - IRC+, <http://ngircd.barton.de/doc/Protocol.txt>
 216          - IRC+, doc/Protocol.txt
 217
 218
 219 General Commands
 220 ~~~~~~~~~~~~~~~~
 221
 222 - AWAY
 223         AWAY [<message>]
 224         .
 225         Provides the server with a message to automatically send in reply to a
 226         PRIVMSG directed at the user, but not to a channel they are on.
 227         .
 228         If <message> is omitted, the away status is removed.
 229
 230         References:
 231          - RFC 2812, 4.1 "Away"
 232
 233 - HELP
 234         HELP [<command>]
 235         .
 236         Show help information for a specific IRC <command>. The <command> name
 237         is case-insensitive.
 238         .
 239         Use the command "HELP Commands" to get a list of all available commands.
 240
 241         The HELP command isn't specified by any RFC but implemented by most
 242         daemons. If no help text could be read in, ngIRCd outputs a list of all
 243         implemented commands when receiving a plain "HELP" command as well as
 244         on "HELP Commands".
 245
 246         ngIRCd replies using "NOTICE" commands like ircd 2.10/2.11; other
 247         implementations are using numerics 704, 705, and 706.
 248
 249 - MODE
 250         MODE <nickname> [{+|-}<mode>[<mode>] [{+|-}<mode>[<mode>] [...]]]
 251         MODE <channel> [{+|-}<mode>[<mode>] [<arg> [<arg> [...]]] [{+|-}<mode>[<mode>] [<arg> [<arg> [...]]] [...]]]
 252         .
 253         Set and get user and channel modes.
 254         .
 255         When no mode parameters are given, the currently set user or channel
 256         modes are returned. Otherwise the modes are adjusted accordingly
 257         and the changes will be reported back to the client.
 258         .
 259         All user and channel "modes" are indicated by single case-sensitive
 260         characters.
 261         .
 262         Please note that a user can only get and set his own modes, and not
 263         all user "levels" are allowed to change all channel modes ...
 264         .
 265         The mode parameters can become quite complex, especially when dealing
 266         with channel modes that require additional arguments:
 267         .
 268           {+|-}<mode(s}>  -- set or unset one or more modes.
 269           +<mode(s)> -<mode(s)>  -- set some modes and unset others.
 270           +<modes> <arg1> <arg2>  -- set (at least) two modes with arguments.
 271         .
 272         Some examples:
 273         .
 274           MODE nick +i  -- set user to "invisible".
 275           MODE #chan +tn  -- set "topic lock" and "no external messages".
 276           MODE #chan -t +l 50  -- remove "topic lock", set "user limit" to 50.
 277           MODE #chan +ov nick1 nick2  -- set "channel op" and "voice" mode
 278                                          to nick1 and nick2 in channel #chan.
 279         .
 280         A complete list of all modes supported by ngIRCd can be found online
 281         here: <http://ngircd.barton.de/doc/Modes.txt>.
 282
 283         References:
 284          - RFC 2811, 4. "Channel Modes"
 285          - RFC 2812, 3.1.5 "User mode message"
 286          - RFC 2812, 3.2.3 "Channel mode message"
 287          - <http://ngircd.barton.de/doc/Modes.txt>
 288          - doc/Modes.txt
 289
 290 - NOTICE
 291         NOTICE <target>[,<target>[,...]] <message>
 292         .
 293         Send a <message> to a given <target>, which can be a user or a
 294         channel, but DON'T report any error.
 295         .
 296         The "NOTICE" command exactly behaves like the "PRIVMSG" command, but
 297         doesn't report any errors it encounters (like an unknown <target>).
 298         Please see the help text of the "PRIVMSG" command for a detailed
 299         description of the parameters!
 300
 301         References:
 302          - RFC 2812, 2.3.1 "Message format in Augmented BNF"
 303          - RFC 2812, 3.3 "Sending messages"
 304          - RFC 2812, 3.3.2 "Notice"
 305
 306 - PRIVMSG
 307         PRIVMSG <target>[,<target>[,...]] <message>
 308         .
 309         Send a <message> to a given <target>, which can be a user or a
 310         channel, and report all errors.
 311         .
 312         The <target> must follow one of these syntax variants:
 313         .
 314          - <nickname>
 315          - <channel>
 316          - <user>[%<host>]@<server>
 317          - <user>%<host>
 318          - <nickname>!<user>@<host>
 319         .
 320         If the <target> is a user, a private message is sent directly to this
 321         user; if it resolves to a channel name, a public message is sent
 322         to all the members of that channel.
 323         .
 324         In addition, IRC Ops can use these two forms to specify the <target>:
 325         .
 326          - #<hostmask>
 327          - #<servermask>
 328         .
 329         The <mask> can contain the wildcard characters "*" and "?", but must
 330         contain at least one dot (".") and no wildcard after the last one.
 331         Then, the <message> is sent to all users matching this <mask>.
 332         .
 333         All warnings and errors are reported back to the initiator using
 334         numeric status codes, which is the only difference to the "NOTICE"
 335         command, which doesn't report back any errors or warnings at all.
 336         .
 337         Please note that clients often use "MSG" as an alias to PRIVMSG, and
 338         a command "QUERY <nick> [<message>]" to initiate private chats. Both
 339         are command extensions of the client and never sent to the server.
 340
 341         References:
 342          - RFC 2812, 2.3.1 "Message format in Augmented BNF"
 343          - RFC 2812, 3.3 "Sending messages"
 344          - RFC 2812, 3.3.1 "Private messages"
 345
 346 Status and Informational Commands
 347 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 348
 349 - ADMIN
 350         ADMIN [<target>]
 351         .
 352         Show administrative information about an IRC server in the network.
 353         .
 354         <target> can be a server name, the nickname of a client connected to
 355         a specific server, or a mask matching a server name in the network.
 356         The server of the current connection is used when <target> is omitted.
 357
 358         References:
 359          - RFC 2812, 3.4.9 "Admin command"
 360
 361 - INFO
 362         INFO [<target>]
 363         .
 364         Show the version, birth & online time of an IRC server in the network.
 365         .
 366         <target> can be a server name, the nickname of a client connected to
 367         a specific server, or a mask matching a server name in the network.
 368         The server of the current connection is used when <target> is omitted.
 369
 370         References:
 371          - RFC 2812, 3.4.10 "Info command"
 372
 373 - ISON
 374         ISON <nickname> [<nickname> [...]]
 375         .
 376         Query online status of a list of nicknames. The server replies with
 377         a list only containing nicknames actually connected to a server in
 378         the network. If no nicknames of the given list are online, an empty
 379         list is returned to the client requesting the information.
 380
 381         Please note that "all" IRC daemons even parse separate nicknames in
 382         a single parameter (like ":nick1 nick2"), and therefore ngIRCd
 383         implements this behaviour, too.
 384
 385         References:
 386          - RFC 2812, 4.9 "Ison message"
 387
 388 - LINKS
 389         LINKS [[<target>] [<mask>]
 390         .
 391         List all servers currently registered in the network matching <mask>,
 392         or all servers if <mask> has been omitted, as seen by the server
 393         specified by <target> or the local server when <target> is omitted.
 394         .
 395         <target> can be a server name, the nickname of a client connected to
 396         a specific server, or a mask matching a server name in the network.
 397
 398         References:
 399          - RFC 2812, 3.4.5 "Links message"
 400
 401 - LUSERS
 402         LUSERS [<mask> [<target>]]
 403         .
 404         Return statistics about the number of clients (users, servers,
 405         services, ...) in the network as seen by the server <target>.
 406         .
 407         <target> can be a server name, the nickname of a client connected to
 408         a specific server, or a mask matching a server name in the network.
 409         The server of the current connection is used when <target> is omitted.
 410
 411         Please note that ngIRCd ignores the <mask> parameter entirely: it
 412         is not possible to get information for a part of the network only.
 413
 414         References:
 415          - RFC 2812, 3.4.2 "Lusers message"
 416
 417 - MOTD
 418         MOTD [<target>]
 419         .
 420         Show the "Message of the Day" (MOTD) of an IRC server in the network.
 421         .
 422         <target> can be a server name, the nickname of a client connected to
 423         a specific server, or a mask matching a server name in the network.
 424         The server of the current connection is used when <target> is omitted.
 425
 426         References:
 427          - RFC 2812, 3.4.1 "Motd message"
 428
 429 - NAMES
 430         NAMES [<channel>[,<channel>[,...]] [<target>]]
 431         .
 432         Show the list of users that are members of a particular <channel>
 433         (and that are visible for the client requesting this information) as
 434         seen by the server <target>. More than one <channel> can be given
 435         separated by "," (but not whitespaces!).
 436         .
 437         If <channel> has been omitted, all visible users are shown, grouped
 438         by channel name, and all visible users not being members of at least
 439         one channel are shown as members of the pseudo channel "*".
 440         .
 441         <target> can be a server name, the nickname of a client connected to
 442         a specific server, or a mask matching a server name in the network.
 443         The server of the current connection is used when <target> is omitted.
 444
 445         References:
 446          - RFC 2812, 3.2.5 "Names message"
 447
 448 - STATS
 449         STATS [<query> [<target>]]
 450         .
 451         Show statistics and other information of type <query> of a particular
 452         IRC server in the network.
 453         .
 454         The following <query> types are supported (case-insensitive):
 455         .
 456          - g  Network-wide bans ("G-Lines").
 457          - k  Server-local bans ("K-Lines").
 458          - l  Link status (parent server and own link only).
 459          - m  Command usage count.
 460          - u  Server uptime.
 461         .
 462         <target> can be a server name, the nickname of a client connected to
 463         a specific server, or a mask matching a server name in the network.
 464         The server of the current connection is used when <target> is omitted.
 465
 466         References:
 467          - RFC 2812, 3.4.4 "Stats message"
 468
 469 - TIME
 470         TIME [<target>]
 471         .
 472         Show the local time of an IRC server in the network.
 473         .
 474         <target> can be a server name, the nickname of a client connected to
 475         a specific server, or a mask matching a server name in the network.
 476         The server of the current connection is used when <target> is omitted.
 477
 478         References
 479          - RFC 2812, 3.4.6 "Time message"
 480
 481 - TRACE
 482         TRACE [<target>]
 483         .
 484         Find the route to a specific server and send information about its
 485         peers. Each server that processes this command reports back to the
 486         sender about it: the replies from pass-through servers form a chain
 487         which shows the route to the destination.
 488         .
 489         <target> can be a server name, the nickname of a client connected to
 490         a specific server, or a mask matching a server name in the network.
 491         The server of the current connection is used when <target> is omitted.
 492
 493         References:
 494          - RFC 2812, 3.4.8 "Trace message"
 495
 496 - USERHOST
 497         USERHOST <nickname> [<nickname> [...]]
 498         .
 499         Show flags and the hostmasks (<user>@<host>) of the <nickname>s,
 500         separated by spaces. The following flags are used:
 501         .
 502          - "-"  The client is "away" (the mode "+a" is set on this client).
 503          - "+"  Client seems to be available, at least it isn't marked "away".
 504          - "*"  The client is an IRC operator (the mode "+o" is set).
 505
 506         References:
 507          - RFC 2812, 4.8 "Userhost message"
 508
 509 - VERSION
 510         VERSION [<target>]
 511         .
 512         Show version information about a particular IRC server in the network.
 513         .
 514         <target> can be a server name, the nickname of a client connected to
 515         a specific server, or a mask matching a server name in the network.
 516         The server of the current connection is used when <target> is omitted.
 517         .
 518         Please note: in normal operation, the version number ends in a dot
 519         (".", for example "ngIRCd-20.1."). If it ends in ".1" (for example
 520         "ngIRCd-20.1.1", same version than before!), the server is running in
 521         debug-mode; and if it ends in ".2", the "network sniffer" is active!
 522         Keep your privacy in mind ...
 523
 524         References:
 525          - RFC 2812, 3.4.3 "Version message"
 526
 527 - WHO
 528         WHO [<mask> ["o"]]
 529         .
 530         Show a list of users who match the <mask>, or all visible users when
 531         the <mask> has been omitted. (Special case: the <mask> "0" is
 532         equivalent to "*")
 533         .
 534         If the flag "o" is given, the server will only return information about
 535         IRC Operators.
 536
 537         References:
 538          - RFC 2812, 3.6.1 "Who query"
 539
 540 - WHOIS
 541         WHOIS [<target>] <mask>[,<mask>[,...]]
 542         .
 543         Query information about users matching the <mask> parameter(s) as seen
 544         by the server <target>; up to 3 <masks> are supported.
 545         .
 546         <target> can be a server name, the nickname of a client connected to a
 547         specific server, or a mask matching a server name in the network. The
 548         server of the current connection is used when <target> is omitted.
 549
 550         References:
 551          - RFC 2812, 3.6.2 "Whois query"
 552
 553 - WHOWAS
 554         WHOWAS <nickname>[,<nickname>[,...]] [<count> [<target>]]
 555         .
 556         Query information about nicknames no longer in use in the network,
 557         either because of nickname changes or disconnects. The history is
 558         searched backwards, returning the most recent entry first. If there
 559         are multiple entries, up to <count> entries will be shown (or all of
 560         them, if no <count> has been given).
 561         .
 562         <target> can be a server name, the nickname of a client connected to a
 563         specific server, or a mask matching a server name in the network. The
 564         server of the current connection is used when <target> is omitted.
 565
 566         References:
 567          - RFC 2812, 3.6.3 "Whowas"
 568
 569
 570 Channel Commands
 571 ~~~~~~~~~~~~~~~~
 572
 573 - INVITE
 574         INVITE <nickname> <channel>
 575         .
 576         Invite <nickname> to join channel <channel>.
 577         .
 578         <channel> does not have to exist, but if it does, only members of the
 579         channel are allowed to invite other users. If the channel mode "+i"
 580         is set, only channel "half-ops" (and above) may invite other clients,
 581         and if channel mode "+V" is set, nobody can invite other users.
 582
 583         References:
 584          - RFC 2812, 3.2.7 "Invite message"
 585
 586 - JOIN
 587         JOIN {<channel>[,<channel>[,...]] [<key>[,<key>[,...]]] | 0}
 588         .
 589         Makes the client join the <channel> (comma-separated list), specifying
 590         the channel keys ("passwords"). A <channel-key> is only needed if the
 591         <channel> has the mode "+k" set.
 592         .
 593         If the channel(s) do not exist, then they will be created.
 594         .
 595         Using "JOIN 0" parts all channels at once.
 596
 597         References:
 598          - RFC 2812, 3.2.1 "Join message" (client protocol)
 599          - RFC 2813, 4.2.1 "Join message" (server protocol)
 600
 601 - KICK
 602         KICK <channel>[,<channel>[,...]] <nickname>[,<nickname>[,...]] [<reason>]
 603         .
 604         Remove users(s) with <nickname>(s) from <channel>(s).
 605         .
 606         There must be either exactly one <channel> parameter and multiple
 607         <nickname> parameters, or as many <channel> parameters as there are
 608         <nickname> parameters. The <reason> is shown to the users being
 609         kicked, and the nickname of the current user is used when <reason>
 610         is omitted.
 611
 612         References:
 613          - RFC 2812, 3.2.8 "Kick command"
 614
 615 - LIST
 616         LIST [<channel>[,<channel>[,...]] [<server>]]
 617         .
 618         List all visible <channels> (comma-separated list).
 619         .
 620         If <server> is given, the command will be forwarded to <server> for
 621         evaluation.
 622
 623         References:
 624          - RFC 2812, 3.2.6 "List message"
 625
 626 - PART
 627         PART <channel>[,<channel>[,...]] [<part-message>]
 628         .
 629         Leave <channel> (comma-separated list), optionally with sending a
 630         <part-message> to all the other channel members.
 631
 632         References:
 633          - RFC 2812, 3.2.2 "Part message"
 634
 635 - TOPIC
 636         TOPIC <channel> [<topic>]
 637         .
 638         Change or view the topic of a channel.
 639         .
 640         The topic for channel <channel> is returned if there is no <topic>
 641         given. If the <topic> parameter is present, the topic for that
 642         channel will be changed, if this action is allowed for the user
 643         requesting it. If the <topic> parameter is an empty string, the
 644         topic for that channel will be removed.
 645
 646         References:
 647          - RFC 2812, 3.2.4 "Topic message"
 648
 649
 650 Administrative Commands
 651 ~~~~~~~~~~~~~~~~~~~~~~~
 652
 653 - CONNECT
 654         CONNECT <server> [<port> [<remote-server> [<my-pwd> <peer-pwd>]]]
 655         .
 656         Instructs the current server, or <remote-server> if specified,
 657         to connect to the server named <server>, which must be configured
 658         in the server configuration file.
 659         .
 660         To use this command, the user must be an IRC Operator. To establish
 661         a connection on a <remote-server>, you must have remote IRC operator
 662         privileges.
 663         .
 664         If <port>, <my-pwd> and <peer-pwd> are given, these values override
 665         the ones specified in the server configuration file.
 666
 667         References:
 668          - RFC 2812, 3.4.7 "Connect message"
 669
 670 - DIE
 671         DIE
 672         .
 673         Instructs the server to shut down.
 674         .
 675         To use this command, the user must be an IRC Operator.
 676
 677         References:
 678          - RFC 2812, 4.3 "Die message"
 679
 680 - DISCONNECT
 681         DISCONNECT <server>
 682         .
 683         Disconnect and disable a locally linked server.
 684         .
 685         To use this command, the user must be an IRC Operator.
 686
 687         References:
 688          - This command is not specified in the IRC RFCs, it is an extension
 689            of ngIRCd.
 690
 691 - GLINE
 692         GLINE <nick!user@hostmask> [<timeout> :<reason>]
 693         .
 694         This command provides timed G-Lines (network-wide bans).
 695         .
 696         If a client matches a G-Line, it cannot connect to any server on
 697         the IRC network for <timeout> seconds. When <timeout> is 0, it make
 698         the G-Line permanent.
 699         .
 700         If no <timeout> and no <reason> is given, the G-Line is removed.
 701         .
 702         To use this command, the user must be an IRC Operator.
 703         .
 704         "STATS g" can be used to list all currently active G-Lines.
 705
 706         References:
 707          - This command is not specified in the IRC RFCs, it is an extension
 708            of ngIRCd.
 709
 710 - KILL
 711         KILL <nickname> <reason>
 712         .
 713         Forcibly remove all users with a given <nickname> from the IRC
 714         network and display the given <reason> to them.
 715         .
 716         This command is used internally between servers, too, for example
 717         to disconnect duplicate <nickname>'s after a "net split".
 718         .
 719         To use this command, the user must be an IRC Operator.
 720
 721         References:
 722          - RFC 2812, 3.7.1 "Kill message"
 723
 724 - KLINE
 725         KLINE <nick!user@hostmask> [<timeout> :<reason>]
 726         .
 727         This command provides timed K-Lines (server-local bans).
 728         .
 729         If a client matches a K-Line, it cannot connect to this server for
 730         <timeout> seconds. When <timeout> is 0, it makes the K-Line permanent.
 731         .
 732         If no <timeout> and no <reason> is given, the K-Line is removed.
 733         .
 734         To use this command, the user must be an IRC Operator.
 735         .
 736         "STATS k" can be used to list all currently active K-Lines.
 737
 738         References:
 739          - This command is not specified in the IRC RFCs, it is an extension
 740            of ngIRCd.
 741
 742 - OPER
 743         OPER <name> <password>
 744         .
 745         Authenticates a user named <name> as an IRC operator on the current
 746         server/network.
 747         .
 748         This operator <name> must be configured in the server configuration.
 749         .
 750         Please note that <name> is NOT related to a nickname at all!
 751
 752         References:
 753          - RFC 2812, 3.1.4 "Oper message"
 754
 755 - REHASH
 756         REHASH
 757         .
 758         Causes the server to re-read and re-process its configuration file(s).
 759         .
 760         While rehashing, no new connections are accepted, but all already
 761         established connections stay connected.
 762         .
 763         To use this command, the user must be an IRC Operator.
 764
 765         References:
 766          - RFC 2812, 4.2 "Rehash message"
 767
 768 - RESTART
 769         RESTART
 770         .
 771         Restart the server.
 772         .
 773         While restarting, all connections are reset and no new connections
 774         are accepted.
 775         .
 776         To use this command, the user must be an IRC Operator.
 777
 778         References:
 779          - RFC 2812, 4.4 "Restart message"
 780
 781 - WALLOPS
 782         WALLOPS <message>
 783         .
 784         Sends <message> to all users with user mode "+w".
 785         .
 786         To use this command, the user must be an IRC Operator.
 787
 788         References:
 789          - RFC 2812, 4.7 "Operwall message"
 790
 791 IRC Service Commands
 792 ~~~~~~~~~~~~~~~~~~~~
 793
 794 - SERVICE
 795         SERVICE <name> <reserved1> <distribution> <type> <reserved2> <info>
 796         SERVICE <name> <servertoken> <distribution> {<type>|+<modes>} <hops> <info>
 797         .
 798         Register a new service in the network.
 799         .
 800         The first form is used by directly linked services and isn't supported
 801         by ngIRCd at the moment. The second form announces services connected
 802         to remote "pseudo-servers" ("services hubs").
 803         .
 804         The <distribution> and <type> parameters are ignored by ngIRCd.
 805
 806         References:
 807          - RFC 2812, 3.1.6 "Service message"
 808          - RFC 2813, 4.1.4 "Service message"
 809
 810 - SERVLIST
 811         SERVLIST [<mask> [<type>]]
 812         .
 813         List all IRC services currently registered in the network.
 814         .
 815         The optional <mask> and <type> parameters can be used to limit the
 816         listing to services matching the <mask> and that are of type <type>.
 817         .
 818         Please note that ngIRCd doesn't use any service types at the moment
 819         and therefore all services are of type "0".
 820
 821         References:
 822          - RFC 2812, 3.5.1 "Servlist message"
 823
 824 - SQUERY
 825         SQUERY <target>[,<target>[,...]] <message>
 826         .
 827         Send a <message> to a given <target> IRC service, and report all
 828         errors.
 829         .
 830         The "SQUERY" command exactly behaves like the "PRIVMSG" command, but
 831         enforces that the <target> of the <message> is an IRC service.
 832         Please see the help text of the "PRIVMSG" command for a detailed
 833         description of the parameters!
 834         .
 835         If a user wants to interact with IRC services, he should use "SQUERY"
 836         instead of "PRIVMSG" or "NOTICE": only "SQUERY makes sure that no
 837         regular user, which uses the nickname of an IRC service, receives
 838         the command in error, for example during a "net split"!
 839
 840         References:
 841          - RFC 2812, 2.3.1 "Message format in Augmented BNF"
 842          - RFC 2812, 3.3 "Sending messages"
 843          - RFC 2812, 3.3.2 "Notice"
 844
 845 - SVSNICK
 846         SVSNICK <oldnick> <newnick>
 847         .
 848         Forcefully change foreign user nicknames. This command is allowed
 849         for servers only.
 850         .
 851         The "SVSNICK" command is forwarded to the server to which the user
 852         with nickname <oldnick> is connected to, which in turn generates a
 853         regular "NICK" command that then is sent to the client, so no special
 854         support in the client software is required.
 855
 856         References:
 857          - ngIRCd GIT commit e3f300d3231f
 858
 859
 860 Server Protocol Commands
 861 ~~~~~~~~~~~~~~~~~~~~~~~~
 862
 863 - CHANINFO
 864         CHANINFO <channel> +<modes> [[<key> <limit>] <topic>]
 865         .
 866         CHANINFO is used by servers to inform each other about a channel:
 867         its modes, channel key, user limits and its topic.
 868         .
 869         The CHANINFO command is allowed on server-links only.
 870
 871         References:
 872          - IRC+, <http://ngircd.barton.de/doc/Protocol.txt>
 873          - IRC+, doc/Protocol.txt
 874
 875 - ERROR
 876         ERROR [<message> [<> [...]]]
 877         .
 878         Inform a client or a server about an error condition. The first
 879         parameter, if given, is logged by the server receiving the message,
 880         all other parameters are silently ignored.
 881         .
 882         This command is silently ignored on non-server and non-service links
 883         and shouldn't be used by regular IRC clients.
 884         .
 885         The ERROR message is also sent before terminating a regular client
 886         connection.
 887
 888         References:
 889          - RFC 2812, 3.7.4 "Error message"
 890
 891 - METADATA
 892         METADATA <target> <key> <value>
 893         .
 894         The METADATA command is used on server-links to update "metadata"
 895         information of clients, like the hostname, the info text ("real name"),
 896         or the user name.
 897         .
 898         The METADATA command is allowed on server-links only.
 899
 900         References:
 901          - IRC+, <http://ngircd.barton.de/doc/Protocol.txt>
 902          - IRC+, doc/Protocol.txt
 903
 904 - NJOIN
 905         NJOIN <channel> [<mode>]<nick>[,[<mode>]<nick>[,...]]
 906         .
 907         The NJOIN command is used on server-links to add users with <nick>
 908         and <mode> to a <channel> while peering.
 909         .
 910         The NJOIN command is allowed on server-links only.
 911
 912         References:
 913          - RFC 2813, 4.2.2 "Njoin message"
 914
 915 - SERVER
 916         SERVER <servername> <info>
 917         SERVER <servername> <hopcount> <info>
 918         SERVER <servername> <hopcount> <token> <info>
 919         .
 920         The first form registers the local connection as a new server in the
 921         network, the second (RFC 1459) and third (RFC 2812) form announce a
 922         new remote server in the network.
 923         .
 924         The SERVER command is allowed on unregistered or server-links only.
 925
 926         References:
 927          - RFC 1459, 4.1.4 "Server message"
 928          - RFC 2813, 4.1.2 "Server message"
 929
 930 - SQUIT
 931         SQUIT <server> <comment>
 932         .
 933         Disconnects an IRC Server from the network.
 934         .
 935         This command is used on server-links, but can be used by IRC Operators
 936         to forcefully disconnect servers from the network, too.
 937
 938         References:
 939          - RFC 2812, 3.1.8 "Squit"
 940          - RFC 2813, 4.1.6 "Server quit message"
 941
 942 Dummy Commands
 943 ~~~~~~~~~~~~~~
 944
 945 - SUMMON
 946         SUMMON <user> [<target> [<channel>]]
 947         .
 948         This command was intended to call people into IRC who are directly
 949         connected to the terminal console of the IRC server -- but is
 950         deprecated today. Therefore ngIRCd doesn't really implement this
 951         command and always returns an error message, regardless of the
 952         parameters given.
 953
 954         References:
 955          - RFC 2812, 4.5 "Summon message"
 956
 957 - USERS
 958         USERS [<target>]
 959         .
 960         This command was intended to list users directly logged in into the
 961         console of the IRC server -- but is deprecated today. Therefore ngIRCd
 962         doesn't really implement this command and always returns an error
 963         message, regardless of the parameters given.
 964
 965         References:
 966          - RFC 2812, 4.6 "Users"
 967
 968 - GET
 969         GET [...]
 970         .
 971         Fake HTTP GET command. When received, the connection is shut down
 972         immediately again to protect against crazy web browsers ...
 973
 974         References:
 975          - ngIRCd GIT commit 33e8c2480649
 976
 977 - POST
 978         POST [...]
 979         .
 980         Fake HTTP POST command. When received, the connection is shut down
 981         immediately again to protect against crazy web browsers ...
 982
 983         References:
 984          - ngIRCd GIT commit 33e8c2480649