]>
Commit | Line | Data |
---|---|---|
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 | --> |