]> jfr.im git - irc/rqf/shadowircd.git/blob - doc/sgml/oper-guide/commands.sgml
Removing glines
[irc/rqf/shadowircd.git] / 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>:<replaceable>reason</replaceable></arg>
402 </cmdsynopsis>
403 <para>
404 Adds a D:line to <filename>dline.conf</filename>, which will deny any connections
405 from the given IP address.
406 The IP address can be given as a full address (192.168.0.1) or
407 as a CIDR mask (192.168.0.0/24).
408 </para>
409 <para>
410 If the optional parameter <replaceable>length</replaceable> is given, the D:line will
411 be temporary (i.e. it will not be stored on disk) and last that
412 long in minutes.
413 </para>
414 <para>
415 All clients matching the D:line will be disconnected from the server immediately.
416 </para>
417 <para>
418 If a reason is specified, it will be sent to the client when they are disconnected, and,
419 if dline_reason is enabled,
420 whenever a connection is attempted which is banned.
421 </para>
422 <para>
423 D:lines are less load on a server, and may be more appropriate if somebody is flooding
424 connections.
425 </para>
426 <para>
427 D:lines cannot be set remotely on other servers.
428 </para>
429 <para>
430 Only exempt{} blocks exempt from D:lines.
431 Being a server or having kline_exempt in auth{} does
432 <emphasis>not</emphasis> exempt (different from K/G/X:lines).
433 </para>
434 </sect2>
435 <sect2>
436 <title>UNDLINE</title>
437 <cmdsynopsis>
438 <command>UNDLINE</command>
439 <arg choice=plain><replaceable>a.b.c.d</replaceable></arg>
440 </cmdsynopsis>
441 <para>
442 Will attempt to remove a D:line from <filename>dline.conf</filename>, and will flush
443 a temporary D:line.
444 </para>
445 </sect2>
446 <sect2>
447 <title>TESTGECOS</title>
448 <cmdsynopsis>
449 <command>TESTGECOS</command>
450 <arg choice=plain><replaceable>gecos</replaceable></arg>
451 </cmdsynopsis>
452 <para>
453 Looks up X:Lines matching the given gecos.
454 </para>
455 </sect2>
456 <sect2>
457 <title>TESTLINE</title>
458 <cmdsynopsis>
459 <command>TESTLINE</command>
460 <arg><replaceable>nick</replaceable>!</arg>
461 <group>
462 <arg choice=plain><replaceable>user</replaceable>@<replaceable>host</replaceable></arg>
463 <arg choice=plain><replaceable>a</replaceable>.<replaceable>b</replaceable>.<replaceable>c</replaceable>.<replaceable>d</replaceable></arg>
464 </group>
465 </cmdsynopsis>
466 <para>
467 Looks up the given hostmask or IP address and reports back on any auth{} blocks, D:, G:, or K: lines found.
468 If <replaceable>nick</replaceable> is given, also searches for
469 nick resvs.
470 </para>
471 <para>
472 For temporary items the number of minutes until the item expires
473 is shown (as opposed to the hit count in STATS q/Q/x/X).
474 </para>
475 <para>
476 This command will not perform DNS lookups; for best
477 results you must testline a host and its IP form.
478 </para>
479 <para>
480 The given username should begin with a tilde (~) if identd is not
481 in use. As of charybdis 2.1.1, no_tilde and username truncation will
482 be taken into account like in the normal client access check.
483 </para>
484 <para>
485 As of charybdis 2.2.0, a channel name can be specified and the
486 RESV will be returned, if there is one.
487 </para>
488 </sect2>
489 <sect2>
490 <title>TESTMASK</title>
491 <cmdsynopsis>
492 <command>TESTMASK</command>
493 <arg choice=plain><replaceable>hostmask</replaceable></arg>
494 <arg><replaceable>gecos</replaceable></arg>
495 </cmdsynopsis>
496 <para>
497 Searches the network for users that match the hostmask and gecos given,
498 returning the number of matching users on this server and other servers.
499 </para>
500 <para>
501 The <replaceable>hostmask</replaceable> is of the form user@host
502 or user@ip/cidr with * and ? wildcards, optionally preceded by
503 nick!.
504 </para>
505 <para>
506 The <replaceable>gecos</replaceable> field accepts the same wildcards
507 as xlines.
508 </para>
509 <para>
510 The IP address checked against is 255.255.255.255 if the IP address
511 is unknown (remote client on a TS5 server) or 0 if the IP address
512 is hidden (auth{} spoof).
513 </para>
514 </sect2>
515 <sect2>
516 <title>LUSERS</title>
517 <cmdsynopsis>
518 <command>LUSERS</command>
519 <arg><replaceable>mask</replaceable></arg>
520 <group>
521 <arg><replaceable>nick</replaceable></arg>
522 <arg><replaceable>server</replaceable></arg>
523 </group>
524 </cmdsynopsis>
525 <para>
526 Shows various user and channel counts.
527 </para>
528 <para>
529 The <replaceable>mask</replaceable> parameter is obsolete
530 but must be used when querying a remote server.
531 </para>
532 </sect2>
533 <sect2>
534 <title>TRACE</title>
535 <cmdsynopsis>
536 <command>TRACE</command>
537 <group>
538 <arg><replaceable>server</replaceable></arg>
539 <arg><replaceable>nick</replaceable></arg>
540 </group>
541 <arg><replaceable>location</replaceable></arg>
542 </cmdsynopsis>
543 <para>
544 With no argument or one argument which is the current server,
545 TRACE gives a list of all connections to the current server
546 and a summary of connection classes.
547 </para>
548 <para>
549 With one argument which is another server, TRACE displays the path
550 to the specified server, and all servers, opers and -i users
551 on that server, along with a summary of connection classes.
552 </para>
553 <para>
554 With one argument which is a client, TRACE displays the
555 path to that client, and that client's information.
556 </para>
557 <para>
558 If location is given, the command is executed on that server;
559 no path is displayed.
560 </para>
561 <para>
562 When listing connections, type, name and class is shown
563 in addition to information depending on the type:
564 </para>
565 <variablelist>
566 <title>TRACE types</title>
567 <varlistentry>
568 <term>Try.</term>
569 <listitem><para>
570 A server we are trying to make a TCP connection to.
571 </para></listitem>
572 </varlistentry>
573 <varlistentry>
574 <term>H.S.</term>
575 <listitem><para>
576 A server we have established a TCP connection to, but is not
577 yet registered.
578 </para></listitem>
579 </varlistentry>
580 <varlistentry>
581 <term>????</term>
582 <listitem><para>
583 An incoming connection that has not yet registered as
584 a user or a server (<quote>unknown</quote>).
585 Shows the username, hostname, IP address
586 and the time the connection has been open. It is possible
587 that the ident or DNS lookups have not completed yet, and in
588 any case no tildes are shown here.
589 Unknown connections may not have a name yet.
590 </para></listitem>
591 </varlistentry>
592 <varlistentry>
593 <term>User</term>
594 <listitem><para>
595 A registered unopered user.
596 Shows the username, hostname, IP address, the time the client
597 has not sent anything (as in STATS l) and the time the user has
598 been idle (from PRIVMSG only, as in WHOIS).
599 </para></listitem>
600 </varlistentry>
601 <varlistentry>
602 <term>Oper</term>
603 <listitem><para>
604 Like User, but opered.
605 </para></listitem>
606 </varlistentry>
607 <varlistentry>
608 <term>Serv</term>
609 <listitem><para>
610 A registered server.
611 Shows the number of servers and users reached via this link,
612 who made this connection and the time the server has not sent
613 anything.
614 </para></listitem>
615 </varlistentry>
616 </variablelist>
617 </sect2>
618 <sect2>
619 <title>ETRACE</title>
620 <cmdsynopsis>
621 <command>ETRACE</command>
622 <arg><replaceable>nick</replaceable></arg>
623 </cmdsynopsis>
624 <para>
625 Shows client information about the given target, or about all local clients if
626 no target is specified.
627 </para>
628 </sect2>
629 <sect2>
630 <title>MASKTRACE</title>
631 <cmdsynopsis>
632 <command>MASKTRACE</command>
633 <arg choice=plain><replaceable>hostmask</replaceable></arg>
634 <arg><replaceable>gecos</replaceable></arg>
635 </cmdsynopsis>
636 <para>
637 Searches the local server or network for users that match the hostmask and gecos given.
638 Network searches require the oper_spy privilege and an '!'
639 before the hostmask.
640 The matching works the same way as TESTMASK.
641 </para>
642 <para>
643 The <replaceable>hostmask</replaceable> is of the form user@host
644 or user@ip/cidr with * and ? wildcards, optionally preceded by
645 nick!.
646 </para>
647 <para>
648 The <replaceable>gecos</replaceable> field accepts the same wildcards
649 as xlines.
650 </para>
651 <para>
652 The IP address field contains 255.255.255.255 if the IP address
653 is unknown (remote client on a TS5 server) or 0 if the IP address
654 is hidden (auth{} spoof).
655 </para>
656 </sect2>
657 <sect2>
658 <title>CHANTRACE</title>
659 <cmdsynopsis>
660 <command>CHANTRACE</command>
661 <arg choice=plain><replaceable>channel</replaceable></arg>
662 </cmdsynopsis>
663 <para>
664 Displays information about users in a channel.
665 Opers with the oper_spy privilege
666 can get the information without being on the channel,
667 by prefixing the channel name with an '!'.
668 </para>
669 <para>
670 The IP address field contains 255.255.255.255 if the IP address
671 is unknown (remote client on a TS5 server) or 0 if the IP address
672 is hidden (auth{} spoof).
673 </para>
674 </sect2>
675 <sect2>
676 <title>SCAN</title>
677 <cmdsynopsis>
678 <command>SCAN UMODES</command>
679 <arg choice=plain>+<replaceable>modes</replaceable>-<replaceable>modes</replaceable></arg>
680 <arg>no-list</arg>
681 <arg>list</arg>
682 <arg>global</arg>
683 <arg>list-max <replaceable>number</replaceable></arg>
684 <arg>mask <replaceable>nick!user@host</replaceable></arg>
685 </cmdsynopsis>
686 <para>
687 Searches the local server or network for users that have the umodes given with + and do not have the umodes given with -.
688 no-list disables the listing of matching users and only shows the count.
689 list enables the listing (default).
690 global extends the search to the entire network instead of local users only.
691 list-max limits the listing of matching users to the given amount.
692 mask causes only users matching the given nick!user@host mask
693 to be selected. Only the displayed host is considered, not the
694 IP address or real host behind dynamic spoofs.
695 </para>
696 <para>
697 The IP address field contains 255.255.255.255 if the IP address
698 is unknown (remote client on a TS5 server) or 0 if the IP address
699 is hidden (auth{} spoof).
700 </para>
701 <para>
702 Network searches where a listing is given or the mask option is used
703 are operspy commands.
704 </para>
705 </sect2>
706 <sect2>
707 <title>CHGHOST</title>
708 <cmdsynopsis>
709 <command>CHGHOST</command>
710 <arg choice=plain><replaceable>nick</replaceable></arg>
711 <arg choice=plain><replaceable>value</replaceable></arg>
712 </cmdsynopsis>
713 <para>
714 Set the hostname associated with a particular nick for the duration of this session.
715 This command is disabled by default because of the abuse potential
716 and little practical use.
717 </para>
718 </sect2>
719 </sect1>
720 <sect1 id="misccommands">
721 <title>Miscellaneous commands</title>
722 <sect2>
723 <title>ADMIN</title>
724 <cmdsynopsis>
725 <command>ADMIN</command>
726 <group>
727 <arg><replaceable>nick</replaceable></arg>
728 <arg><replaceable>server</replaceable></arg>
729 </group>
730 </cmdsynopsis>
731 <para>
732 Shows the information in the admin{} block.
733 </para>
734 </sect2>
735 <sect2>
736 <title>INFO</title>
737 <cmdsynopsis>
738 <command>INFO</command>
739 <group>
740 <arg><replaceable>nick</replaceable></arg>
741 <arg><replaceable>server</replaceable></arg>
742 </group>
743 </cmdsynopsis>
744 <para>
745 Shows information about the authors of the IRC server, and
746 some information about this server instance.
747 Opers also get a list of configuration options.
748 </para>
749 </sect2>
750 <sect2>
751 <title>TIME</title>
752 <cmdsynopsis>
753 <command>TIME</command>
754 <group>
755 <arg><replaceable>nick</replaceable></arg>
756 <arg><replaceable>server</replaceable></arg>
757 </group>
758 </cmdsynopsis>
759 <para>
760 Shows the local time on the given server, in a human-readable format.
761 </para>
762 </sect2>
763 <sect2>
764 <title>VERSION</title>
765 <cmdsynopsis>
766 <command>VERSION</command>
767 <group>
768 <arg><replaceable>nick</replaceable></arg>
769 <arg><replaceable>server</replaceable></arg>
770 </group>
771 </cmdsynopsis>
772 <para>
773 Shows version information, a few compile/config options,
774 the SID and the 005 numerics.
775 The 005 numeric will be remapped to 105 for remote requests.
776 </para>
777 </sect2>
778 <sect2>
779 <title>STATS</title>
780 <cmdsynopsis>
781 <command>STATS</command>
782 <arg><replaceable>type</replaceable></arg>
783 <group>
784 <arg><replaceable>nick</replaceable></arg>
785 <arg><replaceable>server</replaceable></arg>
786 </group>
787 </cmdsynopsis>
788 <para>
789 Display various statistics and configuration information.
790 </para>
791 <variablelist>
792 <title>Values for <replaceable>type</replaceable></title>
793 <varlistentry>
794 <term>A</term>
795 <listitem>
796 <para>Show DNS servers</para>
797 </listitem>
798 </varlistentry>
799 <varlistentry>
800 <term>b</term>
801 <listitem>
802 <para>Show active nick delays</para>
803 </listitem>
804 </varlistentry>
805 <varlistentry>
806 <term>B</term>
807 <listitem>
808 <para>Show hash statistics</para>
809 </listitem>
810 </varlistentry>
811 <varlistentry>
812 <term>c</term>
813 <listitem>
814 <para>Show connect blocks</para>
815 </listitem>
816 </varlistentry>
817 <varlistentry>
818 <term>d</term>
819 <listitem>
820 <para>Show temporary D:lines</para>
821 </listitem>
822 </varlistentry>
823 <varlistentry>
824 <term>D</term>
825 <listitem>
826 <para>Show permanent D:lines</para>
827 </listitem>
828 </varlistentry>
829 <varlistentry>
830 <term>e</term>
831 <listitem>
832 <para>Show exempt blocks (exceptions to D:lines)</para>
833 </listitem>
834 </varlistentry>
835 <varlistentry>
836 <term>E</term>
837 <listitem>
838 <para>Show events</para>
839 </listitem>
840 </varlistentry>
841 <varlistentry>
842 <term>f</term>
843 <listitem>
844 <para>Show file descriptors</para>
845 </listitem>
846 </varlistentry>
847 <varlistentry>
848 <term>h</term>
849 <listitem>
850 <para>Show hub_mask/leaf_mask</para>
851 </listitem>
852 </varlistentry>
853 <varlistentry>
854 <term>i</term>
855 <listitem>
856 <para>Show auth blocks, or matched auth blocks</para>
857 </listitem>
858 </varlistentry>
859 <varlistentry>
860 <term>k</term>
861 <listitem>
862 <para>Show temporary K:lines, or matched K:lines</para>
863 </listitem>
864 </varlistentry>
865 <varlistentry>
866 <term>K</term>
867 <listitem>
868 <para>Show permanent K:lines, or matched K:lines</para>
869 </listitem>
870 </varlistentry>
871 <varlistentry>
872 <term>l</term>
873 <listitem>
874 <para>
875 Show hostname and link information about the given nick.
876 With a server name, show information about opers and servers
877 on that server; opers get information about all local
878 connections if they query their own server.
879 No hostname is shown for server connections.
880 </para>
881 </listitem>
882 </varlistentry>
883 <varlistentry>
884 <term>L</term>
885 <listitem>
886 <para>Like l, but show IP address instead of hostname</para>
887 </listitem>
888 </varlistentry>
889 <varlistentry>
890 <term>m</term>
891 <listitem>
892 <para>Show commands and their usage statistics (total counts, total bytes, counts from server connections)</para>
893 </listitem>
894 </varlistentry>
895 <varlistentry>
896 <term>n</term>
897 <listitem>
898 <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>
899 </listitem>
900 </varlistentry>
901 <varlistentry>
902 <term>o</term>
903 <listitem>
904 <para>Show operator blocks</para>
905 </listitem>
906 </varlistentry>
907 <varlistentry>
908 <term>p</term>
909 <listitem>
910 <para>Show logged on network operators which are not set AWAY.</para>
911 </listitem>
912 </varlistentry>
913 <varlistentry>
914 <term>P</term>
915 <listitem>
916 <para>Show listen blocks (ports)</para>
917 </listitem>
918 </varlistentry>
919 <varlistentry>
920 <term>q</term>
921 <listitem>
922 <para>Show temporarily resv'ed nicks and channels with hit counts</para>
923 </listitem>
924 </varlistentry>
925 <varlistentry>
926 <term>Q</term>
927 <listitem>
928 <para>Show permanently resv'ed nicks and channels with hit counts since last rehash bans</para>
929 </listitem>
930 </varlistentry>
931 <varlistentry>
932 <term>r</term>
933 <listitem>
934 <para>Show resource usage by the ircd</para>
935 </listitem>
936 </varlistentry>
937 <varlistentry>
938 <term>t</term>
939 <listitem>
940 <para>Show generic server statistics about local connections</para>
941 </listitem>
942 </varlistentry>
943 <varlistentry>
944 <term>u</term>
945 <listitem>
946 <para>Show server uptime</para>
947 </listitem>
948 </varlistentry>
949 <varlistentry>
950 <term>U</term>
951 <listitem>
952 <para>Show shared (c), cluster (C) and service (s) blocks</para>
953 </listitem>
954 </varlistentry>
955 <varlistentry>
956 <term>v</term>
957 <listitem>
958 <para>Show connected servers and brief status</para>
959 </listitem>
960 </varlistentry>
961 <varlistentry>
962 <term>x</term>
963 <listitem>
964 <para>Show temporary X:lines with hit counts</para>
965 </listitem>
966 </varlistentry>
967 <varlistentry>
968 <term>X</term>
969 <listitem>
970 <para>Show permanent X:lines with hit counts since last rehash bans</para>
971 </listitem>
972 </varlistentry>
973 <varlistentry>
974 <term>y</term>
975 <listitem>
976 <para>Show class blocks</para>
977 </listitem>
978 </varlistentry>
979 <varlistentry>
980 <term>z</term>
981 <listitem>
982 <para>Show memory usage statistics</para>
983 </listitem>
984 </varlistentry>
985 <varlistentry>
986 <term>Z</term>
987 <listitem>
988 <para>Show ziplinks statistics</para>
989 </listitem>
990 </varlistentry>
991 <varlistentry>
992 <term>?</term>
993 <listitem>
994 <para>Show connected servers and link information about them</para>
995 </listitem>
996 </varlistentry>
997 </variablelist>
998 </sect2>
999 <sect2>
1000 <title>WALLOPS</title>
1001 <cmdsynopsis>
1002 <command>WALLOPS</command>
1003 <arg choice=plain>:<replaceable>message</replaceable></arg>
1004 </cmdsynopsis>
1005 <para>
1006 Sends a WALLOPS message to all users who have the +w umode set. This is for
1007 things you don't mind the whole network knowing about.
1008 </para>
1009 </sect2>
1010 <sect2>
1011 <title>OPERWALL</title>
1012 <cmdsynopsis>
1013 <command>OPERWALL</command>
1014 <arg choice=plain>:<replaceable>message</replaceable></arg>
1015 </cmdsynopsis>
1016 <para>
1017 Sends an OPERWALL message to all opers who have the +z umode set. +z is restricted,
1018 OPERWALL should be considered private communications.
1019 </para>
1020 </sect2>
1021 </sect1>
1022 </chapter>
1023 <!-- Keep this comment at the end of the file
1024 Local variables:
1025 mode: sgml
1026 sgml-omittag:t
1027 sgml-shorttag:t
1028 sgml-namecase-general:t
1029 sgml-general-insert-case:lower
1030 sgml-minimize-attributes:nil
1031 sgml-always-quote-attributes:t
1032 sgml-indent-step:2
1033 sgml-indent-data:t
1034 sgml-parent-document: ("charybdis-oper-guide.sgml" "book")
1035 sgml-exposed-tags:nil
1036 sgml-local-ecat-files:nil
1037 fill-column:105
1038 End:
1039 -->