doc/sgml/oper-guide/commands.sgml

   1   <chapter id="commands">
   2     <title>Operator Commands</title>
   3     <sect1>
   4       <title>Network management commands</title>
   5       <note>
   6         <para>
   7           Except STATS letters, all commands and names are case insensitive.
   8         </para>
   9       </note>
  10       <sect2>
  11         <title>CONNECT</title>
  12         <cmdsynopsis><command>CONNECT</command>
  13           <arg choice=plain><replaceable>target</replaceable></arg>
  14           <arg><replaceable>port</replaceable></arg>
  15           <arg><replaceable>source</replaceable></arg>
  16         </cmdsynopsis>
  17         <para>
  18           Initiate a connection attempt to server <replaceable class=parameter>target</replaceable>. If a port is
  19           given, connect to that port on the target, otherwise use the one given in <filename>ircd.conf</filename>. If
  20           <replaceable class=parameter>source</replaceable> is given, tell that server to initiate the connection
  21           attempt, otherwise it will be made from the server you are attached to.
  22         </para>
  23       </sect2>
  24       <sect2>
  25         <title>SQUIT</title>
  26         <cmdsynopsis>
  27           <command>SQUIT</command>
  28           <arg choice=plain><replaceable>server</replaceable></arg>
  29           <arg><replaceable>reason</replaceable></arg>
  30         </cmdsynopsis>
  31         <para>
  32           Closes down the link to <replaceable>server</replaceable> from this side of the network. If a reason is
  33           given, it will be sent out in the server notices on both sides of the link.
  34         </para>
  35       </sect2>
  36       <sect2>
  37         <title>REHASH</title>
  38         <cmdsynopsis>
  39           <command>REHASH</command>
  40           <group>
  41             <arg>BANS</arg>
  42             <arg>DNS</arg>
  43             <arg>MOTD</arg>
  44             <arg>OMOTD</arg>
  45             <arg>TKLINES</arg>
  46             <arg>TDLINES</arg>
  47             <arg>TXLINES</arg>
  48             <arg>TRESVS</arg>
  49             <arg>REJECTCACHE</arg>
  50             <arg>HELP</arg>
  51           </group>
  52           <arg><replaceable>server</replaceable></arg>
  53         </cmdsynopsis>
  54         <para>
  55           With no parameter given, <filename>ircd.conf</filename> will be reread and parsed.
  56           The server argument is a wildcard match of server names.
  57         </para>
  58         <variablelist>
  59           <title>Parameters</title>
  60           <varlistentry>
  61             <term>BANS</term>
  62             <listitem>
  63               <para>Rereads <filename>kline.conf</filename>, <filename>dline.conf</filename>, <filename>xline.conf</filename>, <filename>resv.conf</filename> and their .perm variants</para>
  64             </listitem>
  65           </varlistentry>
  66           <varlistentry>
  67             <term>DNS</term>
  68             <listitem>
  69               <para>Reread <filename>/etc/resolv.conf</filename>.</para>
  70             </listitem>
  71           </varlistentry>
  72           <varlistentry>
  73             <term>MOTD</term>
  74             <listitem>
  75               <para>Reload the MOTD file</para>
  76             </listitem>
  77           </varlistentry>
  78           <varlistentry>
  79             <term>OMOTD</term>
  80             <listitem>
  81               <para>Reload the operator MOTD file</para>
  82             </listitem>
  83           </varlistentry>
  84           <varlistentry>
  85             <term>TKLINES</term>
  86             <listitem>
  87               <para>Clears temporary K:lines.</para>
  88             </listitem>
  89           </varlistentry>
  90           <varlistentry>
  91             <term>TDLINES</term>
  92             <listitem>
  93               <para>Clears temporary D:lines.</para>
  94             </listitem>
  95           </varlistentry>
  96           <varlistentry>
  97             <term>TXLINES</term>
  98             <listitem>
  99               <para>Clears temporary X:lines.</para>
 100             </listitem>
 101           </varlistentry>
 102           <varlistentry>
 103             <term>TRESVS</term>
 104             <listitem>
 105               <para>Clears temporary reservations.</para>
 106             </listitem>
 107           </varlistentry>
 108           <varlistentry>
 109             <term>REJECTCACHE</term>
 110             <listitem>
 111               <para>Clears the client rejection cache.</para>
 112             </listitem>
 113           </varlistentry>
 114           <varlistentry>
 115             <term>HELP</term>
 116             <listitem>
 117               <para>Refreshes the help system cache.</para>
 118             </listitem>
 119           </varlistentry>
 120         </variablelist>
 121       </sect2>
 122       <sect2>
 123         <title>RESTART</title>
 124         <cmdsynopsis>
 125           <command>RESTART</command>
 126           <arg choice=plain><replaceable>server</replaceable></arg>
 127         </cmdsynopsis>
 128         <para>
 129           Cause an immediate total shutdown of the IRC server, and restart from scratch as if it had just been executed.
 130         </para>
 131         <para>
 132           This reexecutes the ircd using the compiled-in path, visible
 133           as SPATH in INFO.
 134         </para>
 135         <note>
 136           <para>This command cannot be used remotely. The server name is used only as a safety measure.</para>
 137         </note>
 138       </sect2>
 139       <sect2>
 140         <title>DIE</title>
 141         <cmdsynopsis>
 142           <command>DIE</command>
 143           <arg choice=plain><replaceable>server</replaceable></arg>
 144         </cmdsynopsis>
 145         <para>Immediately terminate the IRC server, after sending notices to all connected clients and servers</para>
 146         <note>
 147           <para>This command cannot be used remotely. The server name is used only as a safety measure.</para>
 148         </note>
 149       </sect2>
 150       <sect2>
 151         <title>SET</title>
 152         <cmdsynopsis>
 153           <command>SET</command>
 154           <group>
 155             <arg>LOG</arg>
 156             <arg>MAX</arg>
 157             <arg>SPLITDELAY</arg>
 158             <arg>SMALLNET</arg>
 159             <arg>SPAMNUM</arg>
 160             <arg>SPAMTIME</arg>
 161           </group>
 162           <arg choice=plain><replaceable>value</replaceable></arg>
 163         </cmdsynopsis>
 164         <para>The SET command sets a runtime-configurable value</para>
 165         <variablelist>
 166           <varlistentry>
 167             <term>LOG</term>
 168             <listitem>
 169               <para>Logging level for ircd.log and syslog</para>
 170             </listitem>
 171           </varlistentry>
 172         </variablelist>
 173         <variablelist>
 174           <varlistentry>
 175             <term>MAX</term>
 176             <listitem>
 177               <para>Set the maximum connections allowed (may not exceed the compiled-in value HARD_FDLIMIT)</para>
 178             </listitem>
 179           </varlistentry>
 180           <varlistentry>
 181             <term>DRONETIME</term>
 182             <listitem>
 183               <para>Number of seconds in which DRONECOUNT messages must occur to trip the drone alarm</para>
 184             </listitem>
 185           </varlistentry>
 186           <varlistentry>
 187             <term>DRONECOUNT</term>
 188             <listitem>
 189               <para>Number of messages which constitutes a drone flood. 0 disables drone flood checking.</para>
 190             </listitem>
 191           </varlistentry>
 192           <varlistentry>
 193             <term>SPLITDELAY</term>
 194             <listitem>
 195               <para>Number of minutes after a connect burst begins until joining an empty channel will give you ops</para>
 196             </listitem>
 197           </varlistentry>
 198           <varlistentry>
 199             <term>SMALLNET</term>
 200             <listitem>
 201               <para>Sets the number of servers which are needed to constitute <quote>attached to the network</quote>, as opposed to <quote>split</quote></para>
 202             </listitem>
 203           </varlistentry>
 204           <varlistentry>
 205             <term>SPAMNUM</term>
 206             <listitem>
 207               <para>Sets the number of JOINs/PARTs which constitutes a possible spambot</para>
 208             </listitem>
 209           </varlistentry>
 210           <varlistentry>
 211             <term>SPAMTIME</term>
 212             <listitem>
 213               <para>Staying on a channel for less than this length of time adds to the SPAMNUM count</para>
 214             </listitem>
 215           </varlistentry>
 216         </variablelist>
 217       </sect2>
 218     </sect1>
 219     <sect1 id="usercommands">
 220       <title>User management commands</title>
 221       <sect2>
 222         <title>KILL</title>
 223         <cmdsynopsis>
 224           <command>KILL</command>
 225           <arg choice=plain><replaceable>nick</replaceable></arg>
 226           <arg><replaceable>reason</replaceable></arg>
 227         </cmdsynopsis>
 228         <para>
 229           Disconnects the user with the given nick from the server they are connected to,
 230           with the reason given, if present, and broadcast a server notice announcing this.
 231         </para>
 232         <para>
 233           Your nick and the reason will appear on channels.
 234         </para>
 235       </sect2>
 236       <sect2>
 237         <title>CLOSE</title>
 238         <para>
 239           Closes all connections from and to clients and servers who have not completed registering.
 240         </para>
 241       </sect2>
 242       <sect2>
 243         <title>KLINE</title>
 244         <cmdsynopsis>
 245           <command>KLINE</command>
 246           <arg><replaceable>length</replaceable></arg>
 247           <group>
 248             <arg choice=plain><replaceable>user</replaceable>@<replaceable>host</replaceable></arg>
 249             <arg choice=plain><replaceable>user</replaceable>@<replaceable>a</replaceable>.<replaceable>b</replaceable>.<replaceable>c</replaceable>.<replaceable>d</replaceable></arg>
 250           </group>
 251           <arg>ON <replaceable>servername</replaceable></arg>
 252           <arg>:<replaceable>reason</replaceable></arg>
 253         </cmdsynopsis>
 254         <para>
 255           Adds a K:line to <filename>kline.conf</filename> to ban the given user@host from using that
 256           server.
 257         </para>
 258         <para>
 259           If the optional parameter <replaceable>length</replaceable> is given, the K:line will
 260           be temporary (i.e. it will not be stored on disk) and last that
 261           long in minutes.
 262         </para>
 263         <para>
 264           If an IP address is given, the ban will be against all hosts matching that IP regardless
 265           of DNS. The IP address can be given as a full address (192.168.0.1), as a CIDR mask
 266           (192.168.0.0/24), or as a glob (192.168.0.*).
 267         </para>
 268         <para>
 269           All clients matching the K:line will be disconnected from the server immediately.
 270         </para>
 271         <para>
 272           If a reason is specified, it will be sent to the client when they are disconnected, and
 273           whenever a connection is attempted which is banned.
 274         </para>
 275         <para>
 276           If the ON part is specified, the K:line is set on servers matching
 277           the given mask (provided a matching shared{} block exists there).
 278           Otherwise, if specified in a cluster{} block, the K:Line will be
 279           propagated across the network accordingly.
 280         </para>
 281       </sect2>
 282       <sect2>
 283         <title>UNKLINE</title>
 284         <cmdsynopsis>
 285           <command>UNKLINE</command>
 286           <arg choice=plain><replaceable>user</replaceable>@<replaceable>host</replaceable></arg>
 287           <arg>ON <replaceable>servername</replaceable></arg>
 288         </cmdsynopsis>
 289         <para>
 290           Will attempt to remove a K:line matching user@host from <filename>kline.conf</filename>, and will flush
 291           a temporary K:line.
 292         </para>
 293       </sect2>
 294       <sect2>
 295         <title>XLINE</title>
 296         <cmdsynopsis>
 297           <command>XLINE</command>
 298           <arg><replaceable>length</replaceable></arg>
 299           <arg choice=plain><replaceable>mask</replaceable></arg>
 300           <arg>ON <replaceable>servername</replaceable></arg>
 301           <arg>:<replaceable>reason</replaceable></arg>
 302         </cmdsynopsis>
 303         <para>
 304           Works similarly to KLINE, but matches against the real name field.
 305           The wildcards are * (any sequence), ? (any character),
 306           # (a digit) and @ (a letter); wildcard characters can be
 307           escaped with a backslash.
 308         </para>
 309         <para>
 310           Use \s for a space; this currently interferes with the
 311           check whether the mask is already xlined and UNXLINE.
 312         </para>
 313         <para>
 314           All clients matching the X:line will be disconnected from the server immediately.
 315         </para>
 316         <para>
 317           The reason is never sent to users. Instead, they will be exited
 318           with <quote>Bad user info</quote>.
 319         </para>
 320         <para>
 321           If the ON part is specified, the X:line is set on servers matching
 322           the given mask (provided a matching shared{} block exists there).
 323           Otherwise, if specified in a cluster{} block, the X:line will be
 324           propagated across the network accordingly.
 325         </para>
 326       </sect2>
 327       <sect2>
 328         <title>UNXLINE</title>
 329         <cmdsynopsis>
 330           <command>UNXLINE</command>
 331           <arg choice=plain><replaceable>mask</replaceable></arg>
 332           <arg>ON <replaceable>servername</replaceable></arg>
 333         </cmdsynopsis>
 334         <para>
 335           Will attempt to remove an X:line from <filename>xline.conf</filename>, and will flush
 336           a temporary X:line.
 337         </para>
 338       </sect2>
 339       <sect2>
 340         <title>RESV</title>
 341         <cmdsynopsis>
 342           <command>RESV</command>
 343           <arg><replaceable>length</replaceable></arg>
 344           <group>
 345             <arg choice=plain><replaceable>channel</replaceable></arg>
 346             <arg choice=plain><replaceable>mask</replaceable></arg>
 347           </group>
 348           <arg>ON <replaceable>servername</replaceable></arg>
 349           <arg>:<replaceable>reason</replaceable></arg>
 350         </cmdsynopsis>
 351         <para>
 352           If used on a channel, <quote>jupes</quote> the channel locally. Joins to the
 353           channel will be disallowed and generate a server notice on +y, and
 354           users will not be able to send to the channel. Channel jupes cannot
 355           contain wildcards.
 356         </para>
 357         <para>
 358           If used on a nickname mask, prevents local users from using a nick
 359           matching the mask (the same wildcard characters as xlines). There
 360           is no way to exempt the initial nick from this.
 361         </para>
 362         <para>
 363           In neither case will current users of the nick or channel be
 364           kicked or disconnected.
 365         </para>
 366         <para>
 367           This facility is not designed to make certain nicks
 368           or channels oper-only.
 369         </para>
 370         <para>
 371           The reason is never sent to users.
 372         </para>
 373         <para>
 374           If the ON part is specified, the resv is set on servers matching
 375           the given mask (provided a matching shared{} block exists there).
 376           Otherwise, if specified in a cluster{} block, the resv will be
 377           propagated across the network accordingly.
 378         </para>
 379       </sect2>
 380       <sect2>
 381         <title>UNRESV</title>
 382         <cmdsynopsis>
 383           <command>UNRESV</command>
 384           <group>
 385             <arg choice=plain><replaceable>channel</replaceable></arg>
 386             <arg choice=plain><replaceable>mask</replaceable></arg>
 387           </group>
 388           <arg>ON <replaceable>servername</replaceable></arg>
 389         </cmdsynopsis>
 390         <para>
 391           Will attempt to remove a resv from <filename>resv.conf</filename>, and will flush
 392           a temporary resv.
 393         </para>
 394       </sect2>
 395       <sect2>
 396         <title>DLINE</title>
 397         <cmdsynopsis>
 398           <command>DLINE</command>
 399           <arg><replaceable>length</replaceable></arg>
 400           <arg choice=plain><replaceable>a</replaceable>.<replaceable>b</replaceable>.<replaceable>c</replaceable>.<replaceable>d</replaceable></arg>
 401           <arg>ON <replaceable>servername</replaceable></arg>
 402           <arg>:<replaceable>reason</replaceable></arg>
 403         </cmdsynopsis>
 404         <para>
 405           Adds a D:line to <filename>dline.conf</filename>, which will deny any connections
 406           from the given IP address.
 407           The IP address can be given as a full address (192.168.0.1) or
 408           as a CIDR mask (192.168.0.0/24).
 409         </para>
 410         <para>
 411           If the optional parameter <replaceable>length</replaceable> is given, the D:line will
 412           be temporary (i.e. it will not be stored on disk) and last that
 413           long in minutes.
 414         </para>
 415         <para>
 416           All clients matching the D:line will be disconnected from the server immediately.
 417         </para>
 418         <para>
 419           If a reason is specified, it will be sent to the client when they are disconnected, and,
 420           if dline_reason is enabled,
 421           whenever a connection is attempted which is banned.
 422         </para>
 423         <para>
 424           D:lines are less load on a server, and may be more appropriate if somebody is flooding
 425           connections.
 426         </para>
 427         <para>
 428           If the ON part is specified, the D:line is set on servers matching
 429           the given mask (provided a matching shared{} block exists there,
 430           which is not the case by default).
 431           Otherwise, the D:Line will be set on the local server only.
 432         </para>
 433         <para>
 434           Only exempt{} blocks exempt from D:lines.
 435           Being a server or having kline_exempt in auth{} does
 436           <emphasis>not</emphasis> exempt (different from K/G/X:lines).
 437         </para>
 438       </sect2>
 439       <sect2>
 440         <title>UNDLINE</title>
 441         <cmdsynopsis>
 442           <command>UNDLINE</command>
 443           <arg choice=plain><replaceable>a.b.c.d</replaceable></arg>
 444           <arg>ON <replaceable>servername</replaceable></arg>
 445         </cmdsynopsis>
 446         <para>
 447           Will attempt to remove a D:line from <filename>dline.conf</filename>, and will flush
 448           a temporary D:line.
 449         </para>
 450       </sect2>
 451       <sect2>
 452         <title>TESTGECOS</title>
 453         <cmdsynopsis>
 454           <command>TESTGECOS</command>
 455           <arg choice=plain><replaceable>gecos</replaceable></arg>
 456         </cmdsynopsis>
 457         <para>
 458           Looks up X:Lines matching the given gecos.
 459         </para>
 460       </sect2>
 461       <sect2>
 462         <title>TESTLINE</title>
 463         <cmdsynopsis>
 464           <command>TESTLINE</command>
 465           <arg><replaceable>nick</replaceable>!</arg>
 466           <group>
 467             <arg choice=plain><replaceable>user</replaceable>@<replaceable>host</replaceable></arg>
 468             <arg choice=plain><replaceable>a</replaceable>.<replaceable>b</replaceable>.<replaceable>c</replaceable>.<replaceable>d</replaceable></arg>
 469           </group>
 470         </cmdsynopsis>
 471         <para>
 472           Looks up the given hostmask or IP address and reports back on any auth{} blocks, D: or K: lines found.
 473           If <replaceable>nick</replaceable> is given, also searches for
 474           nick resvs.
 475         </para>
 476         <para>
 477           For temporary items the number of minutes until the item expires
 478           is shown (as opposed to the hit count in STATS q/Q/x/X).
 479         </para>
 480         <para>
 481           This command will not perform DNS lookups; for best
 482           results you must testline a host and its IP form.
 483         </para>
 484         <para>
 485           The given username should begin with a tilde (~) if identd is not
 486           in use. As of charybdis 2.1.1, no_tilde and username truncation will
 487           be taken into account like in the normal client access check.
 488         </para>
 489         <para>
 490           As of charybdis 2.2.0, a channel name can be specified and the
 491           RESV will be returned, if there is one.
 492         </para>
 493       </sect2>
 494       <sect2>
 495         <title>TESTMASK</title>
 496         <cmdsynopsis>
 497           <command>TESTMASK</command>
 498           <arg choice=plain><replaceable>hostmask</replaceable></arg>
 499           <arg><replaceable>gecos</replaceable></arg>
 500         </cmdsynopsis>
 501         <para>
 502           Searches the network for users that match the hostmask and gecos given,
 503           returning the number of matching users on this server and other servers.
 504         </para>
 505         <para>
 506           The <replaceable>hostmask</replaceable> is of the form user@host
 507           or user@ip/cidr with * and ? wildcards, optionally preceded by
 508           nick!.
 509         </para>
 510         <para>
 511           The <replaceable>gecos</replaceable> field accepts the same wildcards
 512           as xlines.
 513         </para>
 514         <para>
 515           The IP address checked against is 255.255.255.255 if the IP address
 516           is unknown (remote client on a TS5 server) or 0 if the IP address
 517           is hidden (auth{} spoof).
 518         </para>
 519       </sect2>
 520       <sect2>
 521         <title>LUSERS</title>
 522         <cmdsynopsis>
 523           <command>LUSERS</command>
 524           <arg><replaceable>mask</replaceable></arg>
 525           <group>
 526             <arg><replaceable>nick</replaceable></arg>
 527             <arg><replaceable>server</replaceable></arg>
 528           </group>
 529         </cmdsynopsis>
 530         <para>
 531           Shows various user and channel counts.
 532         </para>
 533         <para>
 534           The <replaceable>mask</replaceable> parameter is obsolete
 535           but must be used when querying a remote server.
 536         </para>
 537       </sect2>
 538       <sect2>
 539         <title>TRACE</title>
 540         <cmdsynopsis>
 541           <command>TRACE</command>
 542           <group>
 543             <arg><replaceable>server</replaceable></arg>
 544             <arg><replaceable>nick</replaceable></arg>
 545           </group>
 546           <arg><replaceable>location</replaceable></arg>
 547         </cmdsynopsis>
 548         <para>
 549           With no argument or one argument which is the current server,
 550           TRACE gives a list of all connections to the current server
 551           and a summary of connection classes.
 552         </para>
 553         <para>
 554           With one argument which is another server, TRACE displays the path
 555           to the specified server, and all servers, opers and -i users
 556           on that server, along with a summary of connection classes.
 557         </para>
 558         <para>
 559           With one argument which is a client, TRACE displays the
 560           path to that client, and that client's information.
 561         </para>
 562         <para>
 563           If location is given, the command is executed on that server;
 564           no path is displayed.
 565         </para>
 566         <para>
 567           When listing connections, type, name and class is shown
 568           in addition to information depending on the type:
 569         </para>
 570         <variablelist>
 571           <title>TRACE types</title>
 572           <varlistentry>
 573             <term>Try.</term>
 574             <listitem><para>
 575               A server we are trying to make a TCP connection to.
 576             </para></listitem>
 577           </varlistentry>
 578           <varlistentry>
 579             <term>H.S.</term>
 580             <listitem><para>
 581               A server we have established a TCP connection to, but is not
 582               yet registered.
 583             </para></listitem>
 584           </varlistentry>
 585           <varlistentry>
 586             <term>????</term>
 587             <listitem><para>
 588               An incoming connection that has not yet registered as
 589               a user or a server (<quote>unknown</quote>).
 590               Shows the username, hostname, IP address
 591               and the time the connection has been open. It is possible
 592               that the ident or DNS lookups have not completed yet, and in
 593               any case no tildes are shown here.
 594               Unknown connections may not have a name yet.
 595             </para></listitem>
 596           </varlistentry>
 597           <varlistentry>
 598             <term>User</term>
 599             <listitem><para>
 600               A registered unopered user.
 601               Shows the username, hostname, IP address, the time the client
 602               has not sent anything (as in STATS l) and the time the user has
 603               been idle (from PRIVMSG only, as in WHOIS).
 604             </para></listitem>
 605           </varlistentry>
 606           <varlistentry>
 607             <term>Oper</term>
 608             <listitem><para>
 609               Like User, but opered.
 610             </para></listitem>
 611           </varlistentry>
 612           <varlistentry>
 613             <term>Serv</term>
 614             <listitem><para>
 615               A registered server.
 616               Shows the number of servers and users reached via this link,
 617               who made this connection and the time the server has not sent
 618               anything.
 619             </para></listitem>
 620           </varlistentry>
 621         </variablelist>
 622       </sect2>
 623       <sect2>
 624         <title>ETRACE</title>
 625         <cmdsynopsis>
 626           <command>ETRACE</command>
 627           <arg><replaceable>nick</replaceable></arg>
 628         </cmdsynopsis>
 629         <para>
 630           Shows client information about the given target, or about all local clients if
 631           no target is specified.
 632         </para>
 633       </sect2>
 634       <sect2>
 635         <title>PRIVS</title>
 636         <cmdsynopsis>
 637           <command>PRIVS</command>
 638           <arg><replaceable>nick</replaceable></arg>
 639         </cmdsynopsis>
 640         <para>
 641           Displays effective operator privileges for
 642           the specified nick, or for yourself if no nick is
 643           given. This includes all privileges from the operator
 644           block, the name of the operator block and those
 645           privileges from the auth block that have an effect
 646           after the initial connection.
 647         </para>
 648         <para>
 649           The exact output depends on the server the nick is on,
 650           see the matching version of this document.
 651           If the remote server does not support this extension, you will not
 652           receive a reply.
 653         </para>
 654       </sect2>
 655       <sect2>
 656         <title>MASKTRACE</title>
 657         <cmdsynopsis>
 658           <command>MASKTRACE</command>
 659           <arg choice=plain><replaceable>hostmask</replaceable></arg>
 660           <arg><replaceable>gecos</replaceable></arg>
 661         </cmdsynopsis>
 662         <para>
 663           Searches the local server or network for users that match the hostmask and gecos given.
 664           Network searches require the oper_spy privilege and an '!'
 665           before the hostmask.
 666           The matching works the same way as TESTMASK.
 667         </para>
 668         <para>
 669           The <replaceable>hostmask</replaceable> is of the form user@host
 670           or user@ip/cidr with * and ? wildcards, optionally preceded by
 671           nick!.
 672         </para>
 673         <para>
 674           The <replaceable>gecos</replaceable> field accepts the same wildcards
 675           as xlines.
 676         </para>
 677         <para>
 678           The IP address field contains 255.255.255.255 if the IP address
 679           is unknown (remote client on a TS5 server) or 0 if the IP address
 680           is hidden (auth{} spoof).
 681         </para>
 682       </sect2>
 683       <sect2>
 684         <title>CHANTRACE</title>
 685         <cmdsynopsis>
 686           <command>CHANTRACE</command>
 687           <arg choice=plain><replaceable>channel</replaceable></arg>
 688         </cmdsynopsis>
 689         <para>
 690           Displays information about users in a channel.
 691           Opers with the oper_spy privilege
 692           can get the information without being on the channel,
 693           by prefixing the channel name with an '!'.
 694         </para>
 695         <para>
 696           The IP address field contains 255.255.255.255 if the IP address
 697           is unknown (remote client on a TS5 server) or 0 if the IP address
 698           is hidden (auth{} spoof).
 699         </para>
 700       </sect2>
 701       <sect2>
 702         <title>SCAN</title>
 703         <cmdsynopsis>
 704           <command>SCAN UMODES</command>
 705           <arg choice=plain>+<replaceable>modes</replaceable>-<replaceable>modes</replaceable></arg>
 706           <arg>no-list</arg>
 707           <arg>list</arg>
 708           <arg>global</arg>
 709           <arg>list-max <replaceable>number</replaceable></arg>
 710           <arg>mask <replaceable>nick!user@host</replaceable></arg>
 711         </cmdsynopsis>
 712         <para>
 713           Searches the local server or network for users that have the umodes given with + and do not have the umodes given with -.
 714           no-list disables the listing of matching users and only shows the count.
 715           list enables the listing (default).
 716           global extends the search to the entire network instead of local users only.
 717           list-max limits the listing of matching users to the given amount.
 718           mask causes only users matching the given nick!user@host mask
 719           to be selected. Only the displayed host is considered, not the
 720           IP address or real host behind dynamic spoofs.
 721         </para>
 722         <para>
 723           The IP address field contains 255.255.255.255 if the IP address
 724           is unknown (remote client on a TS5 server) or 0 if the IP address
 725           is hidden (auth{} spoof).
 726         </para>
 727         <para>
 728           Network searches where a listing is given or the mask option is used
 729           are operspy commands.
 730         </para>
 731       </sect2>
 732       <sect2>
 733         <title>CHGHOST</title>
 734         <cmdsynopsis>
 735           <command>CHGHOST</command>
 736           <arg choice=plain><replaceable>nick</replaceable></arg>
 737           <arg choice=plain><replaceable>value</replaceable></arg>
 738         </cmdsynopsis>
 739         <para>
 740           Set the hostname associated with a particular nick for the duration of this session.
 741           This command is disabled by default because of the abuse potential
 742           and little practical use.
 743         </para>
 744       </sect2>
 745     </sect1>
 746     <sect1 id="misccommands">
 747       <title>Miscellaneous commands</title>
 748       <sect2>
 749         <title>ADMIN</title>
 750         <cmdsynopsis>
 751           <command>ADMIN</command>
 752           <group>
 753             <arg><replaceable>nick</replaceable></arg>
 754             <arg><replaceable>server</replaceable></arg>
 755           </group>
 756         </cmdsynopsis>
 757         <para>
 758           Shows the information in the admin{} block.
 759         </para>
 760       </sect2>
 761       <sect2>
 762         <title>INFO</title>
 763         <cmdsynopsis>
 764           <command>INFO</command>
 765           <group>
 766             <arg><replaceable>nick</replaceable></arg>
 767             <arg><replaceable>server</replaceable></arg>
 768           </group>
 769         </cmdsynopsis>
 770         <para>
 771           Shows information about the authors of the IRC server, and
 772           some information about this server instance.
 773           Opers also get a list of configuration options.
 774         </para>
 775       </sect2>
 776       <sect2>
 777         <title>TIME</title>
 778         <cmdsynopsis>
 779           <command>TIME</command>
 780           <group>
 781             <arg><replaceable>nick</replaceable></arg>
 782             <arg><replaceable>server</replaceable></arg>
 783           </group>
 784         </cmdsynopsis>
 785         <para>
 786           Shows the local time on the given server, in a human-readable format.
 787         </para>
 788       </sect2>
 789       <sect2>
 790         <title>VERSION</title>
 791         <cmdsynopsis>
 792           <command>VERSION</command>
 793           <group>
 794             <arg><replaceable>nick</replaceable></arg>
 795             <arg><replaceable>server</replaceable></arg>
 796           </group>
 797         </cmdsynopsis>
 798         <para>
 799           Shows version information, a few compile/config options,
 800           the SID and the 005 numerics.
 801           The 005 numeric will be remapped to 105 for remote requests.
 802         </para>
 803       </sect2>
 804       <sect2>
 805         <title>STATS</title>
 806         <cmdsynopsis>
 807           <command>STATS</command>
 808           <arg><replaceable>type</replaceable></arg>
 809           <group>
 810             <arg><replaceable>nick</replaceable></arg>
 811             <arg><replaceable>server</replaceable></arg>
 812           </group>
 813         </cmdsynopsis>
 814         <para>
 815           Display various statistics and configuration information.
 816         </para>
 817         <variablelist>
 818           <title>Values for <replaceable>type</replaceable></title>
 819           <varlistentry>
 820             <term>A</term>
 821             <listitem>
 822               <para>Show DNS servers</para>
 823             </listitem>
 824           </varlistentry>
 825           <varlistentry>
 826             <term>b</term>
 827             <listitem>
 828               <para>Show active nick delays</para>
 829             </listitem>
 830           </varlistentry>
 831           <varlistentry>
 832             <term>B</term>
 833             <listitem>
 834               <para>Show hash statistics</para>
 835             </listitem>
 836           </varlistentry>
 837           <varlistentry>
 838             <term>c</term>
 839             <listitem>
 840               <para>Show connect blocks</para>
 841             </listitem>
 842           </varlistentry>
 843           <varlistentry>
 844             <term>d</term>
 845             <listitem>
 846               <para>Show temporary D:lines</para>
 847             </listitem>
 848           </varlistentry>
 849           <varlistentry>
 850             <term>D</term>
 851             <listitem>
 852               <para>Show permanent D:lines</para>
 853             </listitem>
 854           </varlistentry>
 855           <varlistentry>
 856             <term>e</term>
 857             <listitem>
 858               <para>Show exempt blocks (exceptions to D:lines)</para>
 859             </listitem>
 860           </varlistentry>
 861           <varlistentry>
 862             <term>E</term>
 863             <listitem>
 864               <para>Show events</para>
 865             </listitem>
 866           </varlistentry>
 867           <varlistentry>
 868             <term>f</term>
 869             <listitem>
 870               <para>Show file descriptors</para>
 871             </listitem>
 872           </varlistentry>
 873           <varlistentry>
 874             <term>h</term>
 875             <listitem>
 876               <para>Show hub_mask/leaf_mask</para>
 877             </listitem>
 878           </varlistentry>
 879           <varlistentry>
 880             <term>i</term>
 881             <listitem>
 882               <para>Show auth blocks, or matched auth blocks</para>
 883             </listitem>
 884           </varlistentry>
 885           <varlistentry>
 886             <term>k</term>
 887             <listitem>
 888               <para>Show temporary K:lines, or matched K:lines</para>
 889             </listitem>
 890           </varlistentry>
 891           <varlistentry>
 892             <term>K</term>
 893             <listitem>
 894               <para>Show permanent K:lines, or matched K:lines</para>
 895             </listitem>
 896           </varlistentry>
 897           <varlistentry>
 898             <term>l</term>
 899             <listitem>
 900               <para>
 901                 Show hostname and link information about the given nick.
 902                 With a server name, show information about opers and servers
 903                 on that server; opers get information about all local
 904                 connections if they query their own server.
 905                 No hostname is shown for server connections.
 906               </para>
 907             </listitem>
 908           </varlistentry>
 909           <varlistentry>
 910             <term>L</term>
 911             <listitem>
 912               <para>Like l, but show IP address instead of hostname</para>
 913             </listitem>
 914           </varlistentry>
 915           <varlistentry>
 916             <term>m</term>
 917             <listitem>
 918               <para>Show commands and their usage statistics (total counts, total bytes, counts from server connections)</para>
 919             </listitem>
 920           </varlistentry>
 921           <varlistentry>
 922             <term>n</term>
 923             <listitem>
 924               <para>Show blacklist blocks (DNS blacklists) with hit counts since last rehash and (parenthesized) reference counts. The reference count shows how many clients are waiting on a lookup of this blacklist or have been found and are waiting on registration to complete.</para>
 925             </listitem>
 926           </varlistentry>
 927           <varlistentry>
 928             <term>o</term>
 929             <listitem>
 930               <para>Show operator blocks</para>
 931             </listitem>
 932           </varlistentry>
 933           <varlistentry>
 934             <term>p</term>
 935             <listitem>
 936               <para>Show logged on network operators which are not set AWAY.</para>
 937             </listitem>
 938           </varlistentry>
 939           <varlistentry>
 940             <term>P</term>
 941             <listitem>
 942               <para>Show listen blocks (ports)</para>
 943             </listitem>
 944           </varlistentry>
 945           <varlistentry>
 946             <term>q</term>
 947             <listitem>
 948               <para>Show temporarily resv'ed nicks and channels with hit counts</para>
 949             </listitem>
 950           </varlistentry>
 951           <varlistentry>
 952             <term>Q</term>
 953             <listitem>
 954               <para>Show permanently resv'ed nicks and channels with hit counts since last rehash bans</para>
 955             </listitem>
 956           </varlistentry>
 957           <varlistentry>
 958             <term>r</term>
 959             <listitem>
 960               <para>Show resource usage by the ircd</para>
 961             </listitem>
 962           </varlistentry>
 963           <varlistentry>
 964             <term>t</term>
 965             <listitem>
 966               <para>Show generic server statistics about local connections</para>
 967             </listitem>
 968           </varlistentry>
 969           <varlistentry>
 970             <term>u</term>
 971             <listitem>
 972               <para>Show server uptime</para>
 973             </listitem>
 974           </varlistentry>
 975           <varlistentry>
 976             <term>U</term>
 977             <listitem>
 978               <para>Show shared (c), cluster (C) and service (s) blocks</para>
 979             </listitem>
 980           </varlistentry>
 981           <varlistentry>
 982             <term>v</term>
 983             <listitem>
 984               <para>Show connected servers and brief status</para>
 985             </listitem>
 986           </varlistentry>
 987           <varlistentry>
 988             <term>x</term>
 989             <listitem>
 990               <para>Show temporary X:lines with hit counts</para>
 991             </listitem>
 992           </varlistentry>
 993           <varlistentry>
 994             <term>X</term>
 995             <listitem>
 996               <para>Show permanent X:lines with hit counts since last rehash bans</para>
 997             </listitem>
 998           </varlistentry>
 999           <varlistentry>
1000             <term>y</term>
1001             <listitem>
1002               <para>Show class blocks</para>
1003             </listitem>
1004           </varlistentry>
1005           <varlistentry>
1006             <term>z</term>
1007             <listitem>
1008               <para>Show memory usage statistics</para>
1009             </listitem>
1010           </varlistentry>
1011           <varlistentry>
1012             <term>Z</term>
1013             <listitem>
1014               <para>Show ziplinks statistics</para>
1015             </listitem>
1016           </varlistentry>
1017           <varlistentry>
1018             <term>?</term>
1019             <listitem>
1020               <para>Show connected servers and link information about them</para>
1021             </listitem>
1022           </varlistentry>
1023         </variablelist>
1024       </sect2>
1025       <sect2>
1026         <title>WALLOPS</title>
1027         <cmdsynopsis>
1028           <command>WALLOPS</command>
1029           <arg choice=plain>:<replaceable>message</replaceable></arg>
1030         </cmdsynopsis>
1031         <para>
1032           Sends a WALLOPS message to all users who have the +w umode set. This is for
1033           things you don't mind the whole network knowing about.
1034         </para>
1035       </sect2>
1036       <sect2>
1037         <title>OPERWALL</title>
1038         <cmdsynopsis>
1039           <command>OPERWALL</command>
1040           <arg choice=plain>:<replaceable>message</replaceable></arg>
1041         </cmdsynopsis>
1042         <para>
1043           Sends an OPERWALL message to all opers who have the +z umode set. +z is restricted,
1044           OPERWALL should be considered private communications.
1045         </para>
1046       </sect2>
1047     </sect1>
1048   </chapter>
1049 <!-- Keep this comment at the end of the file
1050 Local variables:
1051 mode: sgml
1052 sgml-omittag:t
1053 sgml-shorttag:t
1054 sgml-namecase-general:t
1055 sgml-general-insert-case:lower
1056 sgml-minimize-attributes:nil
1057 sgml-always-quote-attributes:t
1058 sgml-indent-step:2
1059 sgml-indent-data:t
1060 sgml-parent-document: ("charybdis-oper-guide.sgml" "book")
1061 sgml-exposed-tags:nil
1062 sgml-local-ecat-files:nil
1063 fill-column:105
1064 End:
1065 -->