]> git.netwichtig.de Git - user/henk/code/inspircd.git/blob - docs/conf/helpop.conf.example
Move the close and jumpserver modules to inspircd-extras.
[user/henk/code/inspircd.git] / docs / conf / helpop.conf.example
1 # Sample configuration file for the helpop module.
2 # You can either copy this into your conf folder and set up the module to use it,
3 # or you can customize the responses for your network and/or add more.
4 #
5 # The way the new helpop system works is simple. You use one or more helpop tags.
6 #   <helpop key="moo" value="something here">.
7 # key is what the user is looking for (i.e. /helpop moo), and value is what they get back
8 # (note that it can span multiple lines!).
9 #   -- w00t 16/dec/2006
10 #
11
12 <config format="xml">
13
14 <alias text="HELP" replace="HELPOP $2-">
15
16 <helpmsg nohelp="There is no help for the topic you searched for. Please try again.">
17
18 <helpop key="start" value="InspIRCd Help System
19
20 This system provides help for commands and modes.
21 Specify your question or a command name as the
22 parameter for this command.
23
24 /HELPOP CUSER    -      To see a list of user commands
25 /HELPOP COPER    -      To see a list of oper commands
26 /HELPOP UMODES   -      To see a list of user modes
27 /HELPOP CHMODES  -      To see a list of channel modes
28 /HELPOP SNOMASKS -      To see a list of oper snotice masks
29 /HELPOP EXTBANS  -      To see a list of extended bans">
30
31 <helpop key="cuser" value="User Commands
32 -------------
33
34 ACCEPT      ADMIN       AWAY        COMMANDS    CYCLE       DCCALLOW
35 FPART       INFO        INVITE      ISON        JOIN        KICK
36 KNOCK       LINKS       LIST        LUSERS      MAP         MKPASSWD
37 MODE        MODULES     MOTD        NAMES       NICK        NOTICE
38 OPER        PART        PASS        PING        PONG        PRIVMSG
39 QUIT        REMOVE      SETNAME     SILENCE     SQUERY      SSLINFO
40 STATS       TBAN        TIME        TITLE       TOPIC       UNINVITE
41 USER        USERHOST    VERSION     VHOST       WATCH       WHO
42 WHOIS       WHOWAS">
43
44 <helpop key="squery" value="/SQUERY <target> <text>
45
46 Sends a message to the network service specified in <target>.">
47
48 <helpop key="sslinfo" value="/SSLINFO <nick>
49
50 Displays information on the SSL connection and certificate of the
51 target user.">
52
53 <helpop key="uninvite" value="/UNINVITE <nick> <channel>
54
55 Uninvite a user from a channel, same syntax as INVITE.">
56
57 <helpop key="tban" value="/TBAN <channel> <duration> <banmask>
58
59 Sets a timed ban. The duration of the ban can be specified in the
60 following format: 1w2d3h4m6s which indicates a ban of one week, two
61 days, three hours, four minutes and six seconds. Alternatively the
62 ban may just be specified as a number of seconds. All timed bans
63 appear in the banlist as normal bans and may be safely removed
64 before their time is up.">
65
66 <helpop key="dccallow" value="/DCCALLOW - List allowed nicks
67 /DCCALLOW LIST - This also lists allowed nicks
68 /DCCALLOW +<nick> [<duration>] - Add a nick
69 /DCCALLOW -<nick> - Remove a nick
70 /DCCALLOW HELP - Display help
71
72 Duration is optional, and may be specified in seconds or in the
73 form of 1m2h3d4w5y.">
74
75 <helpop key="accept" value="/ACCEPT * - List accepted nicks
76 /ACCEPT +<nick> - Add a nick
77 /ACCEPT -<nick> - Remove a nick
78 This command accepts multiple nicks like so:
79 /ACCEPT +<nick1>,+<nick2>,-<nick3>
80
81 Manages your accept list. This list is used to determine who can
82 private message you when you have usermode +g set.">
83
84 <helpop key="cycle" value="/CYCLE <channel> :[<reason>]
85
86 Cycles a channel (leaving and rejoining), overrides restrictions that
87 would stop a new user joining, such as user limits and channel keys.">
88
89 <helpop key="title" value="/TITLE <name> <password>
90
91 Authenticate for a WHOIS title line and optionally a vhost using the
92 specified username and password.">
93
94 <helpop key="watch" value="/WATCH - List watched nicks that are online
95 /WATCH L - List watched nicks, online and offline
96 /WATCH C - Clear all watched nicks
97 /WATCH S - Show statistics
98 /WATCH +<nick> - Add a nick
99 /WATCH -<nick> - Remove a nick
100 This command accepts multiple nicks like so:
101 /WATCH +<nick1> +<nick2> -<nick3>">
102
103 <helpop key="vhost" value="/VHOST <username> <password>
104
105 Authenticate for a vhost using the specified username and password.">
106
107 <helpop key="remove" value="/REMOVE <channel> <nick> [<reason>]
108
109 Removes a user from a channel you specify. You must be at least a
110 channel halfoperator to remove a user. A removed user will part with
111 a message stating they were removed from the channel and by whom.">
112
113 <helpop key="rmode" value="/RMODE [channel] [modeletter] {[pattern]}
114
115 Removes listmodes from a channel.
116 E.g. /RMODE #Chan b m:* will remove all mute extbans.">
117
118 <helpop key="fpart" value="/FPART <channel> <nick> [<reason>]
119
120 This behaves identically to /REMOVE. /REMOVE is a built-in mIRC command
121 which caused trouble for some users.">
122
123 <helpop key="silence" value="/SILENCE - Shows a list of silenced masks
124 /SILENCE +<mask> [<flags>] - Add a mask
125 /SILENCE -<mask> - Remove a mask
126
127 A serverside ignore of the given n!u@h mask. The letter(s) at the end
128 specify what is to be ignored from this hostmask.
129
130 Valid SILENCE Flags
131 -------------------
132
133  p        Block private messages
134  c        Block channel messages
135  i        Block invites
136  n        Block private notices
137  t        Block channel notices
138  a        Block all of the above
139  x        Exception
140
141 Multiple letters may be specified. For an exception, you must pair x
142 with what you want excepted. For example, if you wanted to except
143 everything from people with a host matching *.foo.net, you would do
144 /SILENCE +*!*@*.foo.net xa
145
146 /SILENCE without a parameter will list the masks that you have silenced.">
147
148 <helpop key="knock" value="/KNOCK <channel>
149
150 Sends a notice to a channel indicating you wish to join.">
151
152 <helpop key="user" value="/USER <ident> <local host> <remote host> :<real name>
153
154 This command is used by your client to register your
155 IRC session, providing your ident and real name to the
156 server.
157
158 You should not use it during an established connection.">
159
160 <helpop key="nick" value="/NICK <new nick>
161
162 Change your nickname to <new nick>.">
163
164 <helpop key="quit" value="/QUIT [<reason>]
165
166 Quit from IRC and end your current session.">
167
168 <helpop key="version" value="/VERSION
169
170 Returns the server's version information.">
171
172 <helpop key="ping" value="/PING <server>
173
174 Ping a server. The server will answer with a PONG.">
175
176 <helpop key="pong" value="/PONG <server>
177
178 Your client should send this to answer server PINGs. You
179 should not issue this command manually.">
180
181 <helpop key="admin" value="/ADMIN [<server>]
182
183 Shows the administrative information for the given server.">
184
185 <helpop key="privmsg" value="/PRIVMSG <target> <text>
186
187 Sends a message to a user or channel specified in <target>.">
188
189 <helpop key="notice" value="/NOTICE <target> <text>
190
191 Sends a notice to a user or channel specified in <target>.">
192
193 <helpop key="join" value="/JOIN <channel>[,<channel>] [<key>][,<key>]
194
195 Joins one or more channels you provide the names for.">
196
197 <helpop key="names" value="/NAMES <channel>[,<channel>]
198
199 Return a list of users on the channels you provide.">
200
201 <helpop key="part" value="/PART <channel>[,<channel>] [<reason>]
202
203 Leaves one or more channels you specify.">
204
205 <helpop key="kick" value="/KICK <channel> <nick>[,<nick>] [<reason>]
206
207 Kicks a user from a channel you specify. You must be
208 at least a channel halfoperator to kick a user.">
209
210 <helpop key="mode" value="/MODE <target> (+|-)<modes> [<mode parameters>] - Change modes of <target>.
211
212 /MODE <target> - Show modes of <target>.
213
214 /MODE <channel> <list mode char> - List bans, exceptions, etc. set on <channel>.
215
216 Sets the mode for a channel or a nickname specified in <target>.
217 A user may only set modes upon themselves, and may not set the
218 +o usermode, and a user may only change channel modes of
219 channels where they are at least a halfoperator.
220
221 For a list of all user and channel modes, enter /HELPOP UMODES or
222 /HELPOP CHMODES.">
223
224 <helpop key="topic" value="/TOPIC <channel> [<topic>]
225
226 Sets or retrieves the channel topic. If a channel topic is
227 given in the command and either the channel is not +t, or
228 you are at least a halfoperator, the channel topic will be
229 changed to the new one you provide.">
230
231 <helpop key="who" value="/WHO <pattern> [<flags>][%[<fields>[,<querytype>]]] <pattern>
232
233 Looks up information about users matching the provided pattern. You can specify
234 a flag specific pattern, a channel name, user hostname, a user server name, a
235 user real name, or a user nickname. Matching users will only be included in the
236 WHO response if:
237
238  1) The specified pattern is an exact channel name that does not have the
239     private or secret channel modes set and the user does not have the invisible
240     user mode set.
241  2) The specified pattern is an exact nickname.
242  3) You share one or more common channels with the user.
243  4) The user does not have the invisible user mode set.
244  5) You are a server operator with the users/auspex privilege.
245
246 If you specify any fields the response returned will be a WHOX response rather
247 than a RFC 1459 WHO response.
248
249 Valid WHO Flags
250 ---------------
251
252 The following flags use <pattern> to match against the specified user data:
253
254  A     Show users who have an away message matching <pattern>.
255  a     Show users who have an account name matching <pattern>.
256  h     Show users who have a hostname matching <pattern>. If the 'x' modifier
257        is specified then this will match against the real hostname instead of
258        the display hostname.
259  i     Show users who have an IP address matching <pattern>.
260  m     Show users who have the modes listed in <pattern>. The pattern
261        should be in the same format as a mode change e.g. +ow-i (server
262        operators only).
263  n     Show users who have a nickname matching <pattern>.
264  p     Show users who are connected to a port in the <pattern> range (server
265        operators only).
266  r     Show users who have a real name matching <pattern>.
267  s     Show users who are on a server with a name matching <pattern>. If the 'x'
268        modifier is specified then this will match against the real server name
269        instead of the masked server name.
270  t     Show users who have connected in the last <pattern> seconds.
271  u     Show users who have an ident (username) matching <pattern>.
272
273 The following flags filter users by their status:
274
275  f     Only show users on remote (far) servers.
276  l     Only show users on the local server.
277  o     Only show server operators.
278
279 The following flags modify the command output:
280
281  x     Show sensitive data like real user hostnames and, when hideserver is
282        enabled, real server hostnames.
283
284 You may combine one flag from the first group and multiple from the others in
285 one WHO command.
286
287 Valid WHO Fields
288 ----------------
289
290  a     Include the user's account name in the response.
291  c     Include the first common channel name in the response.
292  d     Include the user's server distance from you in the response.
293  f     Include the user's away status, oper status, and highest channel prefix
294        in the response.
295  h     Include the user's hostname in the response. If the 'x' flag was
296        specified then this is the real host rather than the display host.
297  i     Include the user's IP address in the response.
298  l     Include the user's idle time in the response.
299  n     Include the user's nickname in the response.
300  o     Include the user's channel operator rank level in the response.
301  r     Include the user's real name in the response.
302  s     Include the user's server name in the response. If the 'x' flag was
303        specified then this is the real server name rather than the masked server
304        name.
305  t     Include the query type in the response.
306  u     Include the user's ident in the response.
307
308 ">
309
310 <helpop key="motd" value="/MOTD [<server>]
311
312 Show the message of the day for <server>. Messages of the day often
313 contain important server rules and notices and should be read prior
314 to using a server.">
315
316 <helpop key="oper" value="/OPER <login> <password>
317
318 Attempts to authenticate a user as an IRC operator.
319
320 Both successful and unsuccessful oper attempts are
321 logged, and sent to online IRC operators.">
322
323 <helpop key="list" value="/LIST [<pattern>]
324
325 Creates a list of all existing channels matching the glob pattern
326 <pattern>, e.g. *chat* or bot*.">
327
328 <helpop key="lusers" value="/LUSERS
329
330 Shows a count of local and remote users, servers and channels.">
331
332 <helpop key="userhost" value="/USERHOST <nick> [<nick>]
333
334 Returns the hostname and nickname of a user, and some other
335 miscellaneous information.">
336
337 <helpop key="away" value="/AWAY [<message>]
338
339 If a message is given, marks you as being away, otherwise
340 removes your away status and previous message.">
341
342 <helpop key="ison" value="/ISON <nick> [<nick> ...]
343
344 Returns a subset of the nicks you give, showing only those
345 that are currently online.">
346
347 <helpop key="invite" value="/INVITE <nick> <channel> [<time>]
348
349 Invites a user to a channel. If the channel is NOT +A, only
350 channel halfoperators or above can invite people. If +A is set,
351 anyone can invite people to the channel, as long as the person
352 doing the invite is a member of the channel they wish to invite
353 the user to.
354
355 Invited users may override bans, +k, and similar in addition to
356 +i, depending on configuration.
357
358 If a time is provided, the invite expires after that time and the user
359 can no longer use it to enter the channel.">
360
361 <helpop key="pass" value="/PASS <password>
362
363 This command is used by your client when setting up
364 your IRC session to submit a server password to the
365 server.
366
367 You should not use it during an established connection.">
368
369 <helpop key="whowas" value="/WHOWAS <nick>
370
371 Returns a list of times the user was seen recently on IRC along with
372 the time they were last seen and their server.">
373
374 <helpop key="links" value="/LINKS
375
376 Shows all servers linked to this one.">
377
378 <helpop key="map" value="/MAP
379
380 Shows a graphical representation of all users and servers on the
381 network, and the links between them, as a tree from the perspective
382 of your server.">
383
384 <helpop key="whois" value="/WHOIS <nick> [<server>]
385
386 Returns the WHOIS information of a user, their channels, hostname,
387 etc. If a second nickname or server is provided, then a whois is
388 performed from the server where the user is actually located rather
389 than locally, showing idle and signon times.">
390
391 <helpop key="time" value="/TIME [<server>]
392
393 Returns the local time of the server, or remote time of another
394 server.">
395
396 <helpop key="info" value="/INFO [<server>]
397
398 Returns information on the developers and supporters who made this
399 IRC server possible.">
400
401 <helpop key="setname" value="/SETNAME <name>
402
403 Sets your name to the specified name.">
404
405
406 <helpop key="coper" value="Oper Commands
407 -------------
408
409 ALLTIME        CBAN           CHECK          CHGHOST        CHGIDENT
410 CHGNAME        CLEARCHAN      CLOAK          CLONES         CONNECT
411 DIE            ELINE          FILTER         GLINE          GLOADMODULE
412 GLOBOPS        GRELOADMODULE  GUNLOADMODULE  KILL           KLINE
413 LOADMODULE     LOCKSERV       MODENOTICE     NICKLOCK       NICKUNLOCK
414 OJOIN          OPERMOTD       QLINE          RCONNECT       REHASH
415 RELOADMODULE   RESTART        RLINE          RSQUIT         SAJOIN
416 SAKICK         SAMODE         SANICK         SAPART         SAQUIT
417 SATOPIC        SETHOST        SETIDENT       SETIDLE        SHUN
418 SQUIT          SWHOIS         TLINE          UNLOADMODULE   UNLOCKSERV
419 USERIP         WALLOPS        ZLINE">
420
421 <helpop key="userip" value="/USERIP <nick> [<nick>]
422
423 Returns the ip and nickname of the given users.">
424
425 <helpop key="tline" value="/TLINE <mask>
426
427 This command returns the number of local and global clients matched,
428 and the percentage of clients matched, plus how they were matched
429 (by IP address or by hostname). Mask should be given as either a
430 nick!user@host or user@IP (wildcards acceptable).">
431
432 <helpop key="lockserv" value="/LOCKSERV :[<message>]
433
434 Locks out all new connections notifying connecting users that the
435 service is temporarily closed and to try again later.">
436
437 <helpop key="unlockserv" value="/UNLOCKSERV
438
439 Opens the server up again for new connections.">
440
441 <helpop key="filter" value="/FILTER <filter-definition> [<action> <flags> [<duration>] :<reason>]
442
443 This command will add a filter when more than one parameter is given,
444 for messages of the types specified by the flags, with the given
445 filter definition, action, duration (when the action is 'gline',
446 'zline' or 'shun'), and reason.
447
448 The filter will take effect when a message of any type specified by
449 the flags and matching the definition is sent to the server, and
450 perform the specified action.
451
452 Valid FILTER Actions
453 --------------------
454
455 None    Does nothing
456 Warn    Lets the message through and informs +s IRCops of the message
457         and all relevant info
458 Block   Blocks message and informs +s IRCops of the blocked message
459         and all relevant info
460 Silent  Blocks message, but does not notify IRCops
461 Kill    Kills the user
462 Gline   G-lines the user for the specified duration
463 Zline   Z-lines the user for the specified duration
464 Shun    Shuns the user for the specified duration (requires the shun module)
465
466 Valid FILTER Flags
467 ------------------
468
469 p    Block private and channel messages
470 n    Block private and channel notices
471 P    Block part messages
472 q    Block quit messages
473 o    Don't match against opers
474 c    Strip all formatting codes from the message before matching
475 *    Represents all of the above flags
476 -    Does nothing, a non-op for when you do not want to specify any
477      flags
478
479 The reason for the filter will be used as the reason for the action,
480 unless the action is 'none', and is sent to the user when their text is
481 blocked by 'block' and 'silent' actions.
482
483 A G-line, Z-line or shun duration may be specified in seconds, or in the
484 format 1y2w3d4h5m6s - meaning one year, two weeks, three days, 4 hours, 5
485 minutes and 6 seconds. All fields in this format are optional.
486
487 When only one parameter is provided (the filter pattern) the provided
488 filter will be removed. Note that if you remove a
489 configuration-defined filter, it will reappear at next rehash unless
490 it is also removed from the config file.">
491
492 <helpop key="ojoin" value="/OJOIN <channel>
493
494 Force joins you to the specified channel, and gives you +Y and any other
495 configuration-defined modes on it, preventing you from being kicked.
496 Depending on configuration, may announce that you have joined the
497 channel on official network business.">
498
499 <helpop key="clones" value="/CLONES <limit>
500
501 Retrieves a list of users with more clones than the specified
502 limit.">
503
504 <helpop key="check" value="/CHECK <nick|ip|hostmask|channel> [<server>]
505
506 Allows opers to look up advanced information on channels, hostmasks
507 or IP addresses, in a similar way to WHO but in more detail, displaying
508 most information the IRCD has stored on the target, including all
509 metadata.
510
511 With the second parameter given, runs the command remotely on the
512 specified server.">
513
514 <helpop key="alltime" value="/ALLTIME
515
516 Shows the time on all servers on the network.">
517
518 <helpop key="rconnect" value="/RCONNECT <source mask> <target mask>
519
520 The server matching <source mask> will try to connect to the first
521 server in the config file matching <target mask>.">
522
523 <helpop key="rsquit" value="/RSQUIT <target mask> [<reason>]
524
525 Causes a remote server matching <target mask> to be disconnected from
526 the network.">
527
528 <helpop key="globops" value="/GLOBOPS <message>
529
530 Sends a message to all users with the +g snomask.">
531
532 <helpop key="cban" value="/CBAN <channel> [<duration> :[<reason>]]
533
534 Sets or removes a channel ban. You must specify all three parameters
535 to add a ban, and one parameter to remove a ban (just the channel).
536
537 The duration may be specified in seconds, or in the format
538 1y2w3d4h5m6s - meaning one year, two weeks, three days, 4 hours,
539 5 minutes and 6 seconds. All fields in this format are optional.">
540
541 <helpop key="sajoin" value="/SAJOIN [<nick>] <channel>[,<channel>]
542
543 Forces the user to join the channel(s).
544 If no nick is given, it joins the oper doing the /SAJOIN.">
545
546 <helpop key="sapart" value="/SAPART <nick> <channel>[,<channel>]
547
548 Forces the user to part the channel(s).">
549
550 <helpop key="samode" value="/SAMODE <target> (+|-)<modes> [<parameters for modes>]
551
552 Applies the given mode change to the channel or nick specified.">
553
554 <helpop key="sanick" value="/SANICK <nick> <new nick>
555
556 Changes the user's nick to the new nick.">
557
558 <helpop key="sakick" value="/SAKICK <channel> <nick> <reason>
559
560 Kicks the given user from the specified channel.">
561
562 <helpop key="satopic" value="/SATOPIC <channel> <new topic>
563
564 Applies the given topic to the specified channel.">
565
566 <helpop key="saquit" value="/SAQUIT <nick> <reason>
567
568 Forces user to quit with the specified reason.">
569
570 <helpop key="setidle" value="/SETIDLE <idle time>
571
572 Sets your idle time (in seconds) to the specified value.">
573
574 <helpop key="sethost" value="/SETHOST <host>
575
576 Sets your host to the specified host.">
577
578 <helpop key="setident" value="/SETIDENT <ident>
579
580 Sets your ident to the specified ident.">
581
582 <helpop key="swhois" line="/SWHOIS <nick> <swhois>
583
584 Sets the user's swhois field to the given swhois.">
585
586 <helpop key="mkpasswd" value="/MKPASSWD <hashtype> <plaintext>
587
588 Encodes the plaintext to a hash of the given type and displays
589 the result.">
590
591 <helpop key="opermotd" value="/OPERMOTD
592
593 Displays the Oper MOTD.">
594
595 <helpop key="nicklock" value="/NICKLOCK <nick> <new nick>
596
597 Changes the user's nick to the new nick, and forces
598 it to remain as such for the remainder of the session.">
599
600 <helpop key="nickunlock" value="/NICKUNLOCK <nick>
601
602 Allows a previously locked user to change nicks again.">
603
604 <helpop key="chghost" value="/CHGHOST <nickname> <new hostname>
605
606 Changes the hostname of the user to the new hostname.">
607
608 <helpop key="chgname" value="/CHGNAME <nickname> <new name>
609
610 Changes the name of the user to the new name.">
611
612 <helpop key="chgident" value="/CHGIDENT <nickname> <new ident>
613
614 Changes the ident of the user to the new ident.">
615
616 <helpop key="shun" value="/SHUN <nick!user@host> [[<duration>] :<reason>]
617
618 Sets or removes a shun (server side ignore) on a host and ident mask.
619 You must specify all three parameters to add a shun, and one parameter
620 to remove a shun (just the nick!user@host section).
621
622 The duration may be specified in seconds, or in the format
623 1y2w3d4h5m6s - meaning one year, two weeks, three days, 4 hours,
624 5 minutes and 6 seconds. All fields in this format are optional.">
625
626 <helpop key="die" value="/DIE <server>
627
628 This command shuts down the local server. A single parameter is
629 required, which must match the name of the local server.">
630
631 <helpop key="restart" value="/RESTART <server>
632
633 This command restarts the local server. A single parameter is
634 required, which must match the name of the local server.">
635
636 <helpop key="commands" value="/COMMANDS
637
638 Shows all currently available commands.">
639
640 <helpop key="kill" value="/KILL <user> <reason>
641
642 This command will disconnect a user from IRC with the given reason.">
643
644 <helpop key="rehash" value="/REHASH <mask>
645
646 This command will cause the server configuration file to be reread and
647 values reinitialized for all servers matching the server mask, or the
648 local server if one is not specified.">
649
650 <helpop key="connect" value="/CONNECT <servermask>
651
652 Add a connection to the server matching the given server mask. You must
653 have configured the server for linking in your configuration file
654 before trying to link them.">
655
656 <helpop key="squit" value="/SQUIT <servermask>
657
658 Disconnects the server matching the given server mask from this server.">
659
660 <helpop key="modules" value="/MODULES
661
662 Lists currently loaded modules, their memory offsets, version numbers,
663 and flags. If you are not an operator, you will see reduced detail.">
664
665 <helpop key="loadmodule" value="/LOADMODULE <modname>
666
667 Loads the specified module into the local server.">
668
669 <helpop key="unloadmodule" value="/UNLOADMODULE <modname>
670
671 Unloads a module from the local server.">
672
673 <helpop key="reloadmodule" value="/RELOADMODULE <modname>
674
675 Unloads and reloads a module on the local server.">
676
677 <helpop key="gloadmodule" value="/GLOADMODULE <modname>
678
679 Loads the specified module on all linked servers.">
680
681 <helpop key="gunloadmodule" value="/GUNLOADMODULE <modname>
682
683 Unloads a module from all linked servers.">
684
685 <helpop key="greloadmodule" value="/GRELOADMODULE <modname>
686
687 Unloads and reloads a module on all linked servers.">
688
689 <helpop key="kline" value="/KLINE <user@host> [<duration> :<reason>]
690
691 Sets or removes a K-line (local host based ban) on a host and ident mask.
692 You must specify all three parameters to add a ban, and one parameter
693 to remove a ban (just the user@host section).
694
695 The duration may be specified in seconds, or in the format
696 1y2w3d4h5m6s - meaning one year, two weeks, three days, 4 hours,
697 5 minutes and 6 seconds. All fields in this format are optional.">
698
699 <helpop key="zline" value="/ZLINE <ipmask> [<duration> :<reason>]
700
701 Sets or removes a Z-line (ip based ban) on an ip range mask.
702 You must specify all three parameters to add a ban, and one parameter
703 to remove a ban (just the ipmask).
704
705 The duration may be specified in seconds, or in the format
706 1y2w3d4h5m6s - meaning one year, two weeks, three days, 4 hours,
707 5 minutes and 6 seconds. All fields in this format are optional.">
708
709 <helpop key="qline" value="/QLINE <nickmask> [<duration> :<reason>]
710
711 Sets or removes a Q-line (nick based ban) on a nick mask.
712 You must specify all three parameters to add a ban, and one parameter
713 to remove a ban (just the nickmask).
714
715 The duration may be specified in seconds, or in the format
716 1y2w3d4h5m6s - meaning one year, two weeks, three days, 4 hours,
717 5 minutes and 6 seconds. All fields in this format are optional.">
718
719 <helpop key="gline" value="/GLINE <user@host> [<duration> :<reason>]
720
721 Sets or removes a G-line (host based ban) on host mask.
722 You must specify all three parameters to add a ban, and one
723 parameter to remove a ban (just the user@host section).
724
725 The duration may be specified in seconds, or in the format
726 1y2w3d4h5m6s - meaning one year, two weeks, three days, 4 hours,
727 5 minutes and 6 seconds. All fields in this format are optional.">
728
729 <helpop key="eline" value="/ELINE <user@host> [<duration> :<reason>]
730
731 Sets or removes a E-line (global ban exception) on host mask.
732 You must specify at least 3 parameters to add an exception, and one
733 parameter to remove an exception (just the user@host section).
734
735 The duration may be specified in seconds, or in the format
736 1y2w3d4h5m6s - meaning one year, two weeks, three days, 4 hours,
737 5 minutes and 6 seconds. All fields in this format are optional.
738
739 This command has a few important limitations. Bans on *@<ip> can only
740 be negated by an E-line on *@<ip>, bans on *@<host> can be negated by
741 E-lines on *@<ip>, or *@<host>, and bans on <ident>@* or <ident>@<host>
742 can be negated by any E-line that matches.">
743
744 <helpop key="wallops" value="/WALLOPS <message>
745
746 Sends a message to all +w users.">
747
748 <helpop key="rline" value="/RLINE <regex> [<duration> :<reason>]
749
750 Sets or removes an R-line (regex line) on a n!u@h\srealname mask. You
751 must specify all three parameters to add an R-line, and one parameter
752 to remove an R-line (just the regex).
753
754 The duration may be specified in seconds, or in the format
755 1y2w3d4h5m6s - meaning one year, two weeks, three days, 4 hours,
756 5 minutes and 6 seconds. All fields in this format are optional.">
757
758 <helpop key="clearchan" value="/CLEARCHAN <channel> [<KILL|KICK|G|Z>] [<reason>]
759
760 Quits or kicks all non-opers from a channel, optionally G/Z-lines them.
761 Useful for quickly nuking bot channels.
762
763 The default method, KILL, simply disconnects the victims from the server,
764 while methods G and Z also add G/Z-lines for all the targets.
765
766 When used, the victims won't see each other getting kicked or quitting.">
767
768 <helpop key="modenotice" value="/MODENOTICE <modeletters> <message>
769
770 Sends a notice to all users who have the given mode(s) set.
771 If multiple mode letters are given, the notice is only sent to users
772 who have all of them set.">
773
774 <helpop key="cloak" value="/CLOAK <host>
775
776 Generate the cloak of a host or IP. This is useful for example when
777 trying to get the cloak of a user from /WHOWAS and they were not
778 using their cloak when they quit.">
779
780 <helpop key="umodes" value="User Modes
781 ----------
782
783  c            Blocks private messages and notices from users who do
784               not share a common channel with you (requires the
785               commonchans module).
786  d            Deaf mode. User will not receive any messages or notices
787               from channels they are in (requires the deaf module).
788  g            In combination with /ACCEPT, provides for server side
789               ignore (requires the callerid module).
790  h            Marks as 'available for help' in WHOIS (IRCop only,
791               requires the helpop module).
792  i            Makes invisible to /WHO if the user using /WHO is not in
793               a common channel.
794  k            Prevents the user from being kicked from channels, or
795               having op modes removed from them (services only,
796               requires the servprotect module).
797  o            Marks as a IRC operator.
798  s <mask>     Receives server notices specified by <mask>
799               (IRCop only).
800  r            Marks as a having a registered nickname
801               (requires the services account module).
802  w            Receives wallops messages.
803  x            Gives a cloaked hostname (requires the cloaking module).
804  z            Only allow private messages from SSL users (requires the
805               sslmode module).
806  B            Marks as a bot (requires the botmode module).
807  G            Censors messages sent to the user based on filters
808               configured for the network (requires the censor module).
809  H            Hides an oper's oper status from WHOIS (requires the
810               hideoper module).
811  I            Hides a user's entire channel list in WHOIS from
812               non-IRCops (requires the hidechans module).
813  L            Stops redirections done by m_redirect (mode must be
814               enabled in the config).
815  R            Blocks private messages from unregistered users
816               (requires the services account module).
817  S            Strips formatting codes out of private messages
818               to the user (requires the stripcolor module).
819  W            Receives notification when a user uses WHOIS on them
820               (IRCop only, requires the showwhois module).">
821
822 <helpop key="chmodes" value="Channel Modes
823 -------------
824
825  v <nickname>       Gives voice to <nickname>, allowing them to speak
826                     while the channel is +m.
827  h <nickname>       Gives halfop status to <nickname> (requires the
828                     customprefix module).
829  o <nickname>       Gives op status to <nickname>.
830  a <nickname>       Gives protected status to <nickname>, preventing
831                     them from being kicked (+q only, requires the
832                     customprefix module).
833  q <nickname>       Gives owner status to <nickname>, preventing them
834                     from being kicked (Services or +q only, requires
835                     the customprefix module).
836
837  b <hostmask>       Bans <hostmask> from the channel.
838  e <hostmask>       Excepts <hostmask> from bans (requires the
839                     banexception module).
840  I <hostmask>       Excepts <hostmask> from +i, allowing matching
841                     users to join while the channel is invite-only
842                     (requires the inviteexception module).
843
844  c                  Blocks messages that contain formatting codes
845                     (requires the blockcolor module).
846  d <time>           Blocks messages to a channel from new users
847                     until they have been in the channel for <time>
848                     seconds (requires the delaymsg module).
849  f [*]<lines>:<sec> Kicks on text flood equal to or above the
850                     specified rate. With *, the user is banned
851                     (requires the messageflood module).
852  g <mask>           Blocks messages matching the given glob mask
853                     (requires the chanfilter module).
854  i                  Makes the channel invite-only.
855                     Users can only join if an operator
856                     uses /INVITE to invite them.
857  j <joins>:<sec>    Limits joins to the specified rate (requires
858                     the joinflood module).
859  k <key>            Set the channel key (password) to <key>.
860  l <limit>          Set the maximum allowed users to <limit>.
861  m                  Enable moderation. Only users with +v, +h, or +o
862                     can speak.
863  n                  Blocks users who are not members of the channel
864                     from messaging it.
865  p                  Make channel private, hiding it in users' whoises
866                     and replacing it with * in /LIST.
867  r                  Marks the channel as registered with Services
868                     (requires the services account module).
869  s                  Make channel secret, hiding it in users' whoises
870                     and /LIST.
871  t                  Prevents users without +h or +o from changing the
872                     topic.
873  u                  Makes the channel an auditorium; normal users only
874                     see themselves or themselves and the operators,
875                     while operators see all the users (requires the
876                     auditorium module).
877  w <flag>:<banmask> Adds basic channel access controls of <flag> to
878                     <banmask>, via the +w listmode.
879                     For example, +w o:R:Brain will op anyone identified
880                     to the account 'Brain' on join.
881                     (requires the autoop module)
882  z                  Blocks non-SSL clients from joining the channel.
883
884  A                  Allows anyone to invite users to the channel
885                     (normally only chanops can invite, requires
886                     the allowinvite module).
887  B                  Blocks messages with too many capital letters,
888                     as determined by the network configuration
889                     (requires the blockcaps module).
890  C                  Blocks any CTCPs to the channel (requires the
891                     noctcp module).
892  D                  Delays join messages from users until they message
893                     the channel (requires the delayjoin module).
894  E [~*][lines]:[sec]{[:difference]}{[:backlog]} Allows blocking of similar messages.
895                     Kicks as default, blocks with ~ and bans with *
896                     The last two parameters are optional.
897  F <changes>:<sec>  Blocks nick changes when they equal or exceed the
898                     specified rate (requires the nickflood module).
899  G                  Censors messages to the channel based on the
900                     network configuration (requires the censor module).
901  H <num>:<duration> Displays the last <num> lines of chat to joining
902                     users. <duration> is the maximum time to keep
903                     lines in the history buffer (requires the
904                     chanhistory module).
905  J <seconds>        Prevents rejoin after kick for the specified
906                     number of seconds. This prevents auto-rejoin
907                     (requires the kicknorejoin module).
908  K                  Blocks /KNOCK on the channel.
909  L <channel>        If the channel reaches its limit set by +l,
910                     redirect users to <channel> (requires the
911                     redirect module).
912  M                  Blocks unregistered users from speaking (requires
913                     the services account module).
914  N                  Prevents users on the channel from changing nick
915                     (requires the nonicks module).
916  O                  Channel is IRCops only (can only be set by IRCops,
917                     requires the operchans module).
918  P                  Makes the channel permanent; Bans, invites, the
919                     topic, modes, and such will not be lost when it
920                     empties (can only be set by IRCops, requires
921                     the permchannels module).
922  Q                  Only ulined servers and their users can kick
923                     (requires the nokicks module)
924  R                  Blocks unregistered users from joining (requires
925                     the services account module).
926  S                  Strips formatting codes from messages to the
927                     channel (requires the stripcolor module).
928  T                  Blocks /NOTICEs to the channel from users who are
929                     not at least halfop (requires the nonotice module).
930  X <type>:<status>  Makes users of <status> or higher exempt to the
931                     specified restriction <type>. For example: flood:h
932                     (requires the exemptchanops module).
933  Possible restriction types to exempt with +X are:
934
935  auditorium-see      Permission required to see the full user list of
936                      a +u channel (requires the auditorium module).
937  auditorium-vis      Permission required to be visible in a +u channel
938                      (requires the auditorium module).
939  blockcaps           Channel mode +B
940  blockcolor          Channel mode +c
941  censor              Channel mode +G
942  filter              Channel mode +g
943  flood               Channel mode +f
944  nickflood           Channel mode +F
945  noctcp              Channel mode +C
946  nonick              Channel mode +N
947  nonotice            Channel mode +T
948  regmoderated        Channel mode +M
949  stripcolor          Channel mode +S
950  topiclock           Channel mode +t
951
952 -------------
953 NOTE: A large number of these modes are dependent upon server-side modules
954 being loaded by a server/network administrator. The actual modes available
955 on your network may be very different to this list. Please consult your
956 help channel if you have any questions.">
957
958 <helpop key="stats" value="/STATS <symbol>
959
960 Shows various server statistics. Depending on configuration, some
961 symbols may be only available to opers.
962
963 Valid symbols are:
964
965 e  Show E-lines (local ban exemptions)
966 g  Show G-lines (host bans)
967 k  Show K-lines (local host bans)
968 q  Show Q-lines (nick mask bans)
969 R  Show R-lines (regular expression bans)
970 Z  Show Z-lines (IP mask bans)
971
972 s  Show filters
973 C  Show channel bans
974 H  Show shuns
975
976 c  Show link blocks
977 d  Show configured DNSBLs and related statistics
978 m  Show command statistics, number of times commands have been used
979 o  Show a list of all valid oper usernames and hostmasks
980 p  Show open client ports, and the port type (ssl, plaintext, etc)
981 u  Show server uptime
982 z  Show memory usage statistics
983 i  Show connect class permissions
984 l  Show all client connections with information (sendq, commands, bytes, time connected)
985 L  Show all client connections with information and IP address
986 P  Show online opers and their idle times
987 T  Show bandwidth/socket statistics
988 U  Show U-lined servers
989 Y  Show connection classes
990 O  Show opertypes and the allowed user and channel modes it can set
991 E  Show socket engine events
992 S  Show currently held registered nicknames
993 G  Show how many local users are connected from each country according to GeoIP
994
995 Note that all /STATS use is broadcast to online IRC operators.">
996
997 <helpop key="snomasks" value="Server Notice Masks
998
999  a      Allows receipt of local announcement messages.
1000  A      Allows receipt of remote announcement messages.
1001  c      Allows receipt of local connect messages.
1002  C      Allows receipt of remote connect messages.
1003  d      Allows receipt of local DNSBL messages (requires the dnsbl module).
1004  D      Allows receipt of remote DNSBL messages (requires the dnsbl module).
1005  f      Allows receipt of local filter messages (requires the filter module).
1006  F      Allows receipt of remote filter messages (requires the filter module).
1007  g      Allows receipt of globops (requires the globops module).
1008  j      Allows receipt of channel creation notices (requires the chancreate module).
1009  J      Allows receipt of remote channel creation notices (requires the chancreate module).
1010  k      Allows receipt of local kill messages.
1011  K      Allows receipt of remote kill messages.
1012  l      Allows receipt of local linking related messages.
1013  L      Allows receipt of remote linking related messages.
1014  n      See local nickname changes (requires the seenicks module).
1015  N      See remote nickname changes (requires the seenicks modules).
1016  o      Allows receipt of oper-up, oper-down, and oper-failure messages.
1017  O      Allows receipt of remote oper-up, oper-down, and oper-failure messages.
1018  q      Allows receipt of local quit messages.
1019  Q      Allows receipt of remote quit messages.
1020  r      Allows receipt of local oper commands (requires the operlog module).
1021  R      Allows receipt of remote oper commands (requires the operlog module).
1022  t      Allows receipt of attempts to use /STATS (local and remote).
1023  v      Allows receipt of oper-override notices (requires the override module).
1024  x      Allows receipt of local X-line notices (G/Z/Q/K/E/R/SHUN/CBan).
1025  X      Allows receipt of remote X-line notices (G/Z/Q/K/E/R/SHUN/CBan).">
1026
1027 <helpop key="extbans" value="Extended Bans
1028 ----------
1029
1030 Extbans are split into two types; matching extbans, which match on
1031 users in additional ways, and acting extbans, which restrict users
1032 in different ways to a standard ban.
1033
1034 To use an extban, simply set +b <ban> or +e <ban> with it as the ban,
1035 instead of a normal nick!user@host mask, to ban or exempt matching
1036 users. Ban exceptions on acting extbans exempt that user from matching
1037 an extban of that type, and from any channel mode corresponding to the
1038 restriction. Matching extbans may also be used for invite exceptions by
1039 setting +I <extban>.
1040
1041 Matching extbans:
1042
1043  a:<mask>      Matches user with both a matching banmask and realname,
1044                where <mask> is in the format nick!user@host+realname
1045                (requires gecosban module).
1046  j:<channel>   Matches anyone in the given channel. Does not support
1047                wildcards (requires the channelban module).
1048  n:<class>     Matches users in a matching connect class (requires
1049                the classban module).
1050  r:<realname>  Matches users with a matching real name (requires the
1051                gecosban module).
1052  s:<server>    Matches users on a matching server (requires the
1053                serverban module).
1054  z:<certfp>    Matches users having the given SSL certificate
1055                fingerprint (requires the sslmodes module).
1056  O:<opertype>  Matches IRCops of a matching type, mostly useful as an
1057                an invite exception (requires the operchans module).
1058  R:<account>   Matches users logged into a matching account (requires
1059                the services account module).
1060  U:<banmask>   Matches unregistered users matching the given banmask.
1061                (requires the services account module).
1062
1063 Acting extbans:
1064
1065  c:<banmask>   Blocks any messages that contain formatting codes from
1066                matching users (requires the blockcolor module).
1067  m:<banmask>   Blocks messages from matching users (requires the muteban
1068                module). Users with +v or above are not affected.
1069  p:<banmask>   Blocks part messages from matching users (requires
1070                the nopartmsg module).
1071  A:<banmask>   Blocks invites by matching users even when +A is set
1072                (requires the allowinvite module).
1073  B:<banmask>   Blocks all capital or nearly all capital messages from
1074                matching users (requires the blockcaps module).
1075  C:<banmask>   Blocks CTCPs from matching users (requires the noctcp
1076                module).
1077  N:<banmask>   Blocks nick changes from matching users (requires
1078                the nonicks module).
1079  Q:<banmask>   Blocks kicks by matching users (requires the nokicks
1080                module).
1081  S:<banmask>   Strips formatting codes from messages from matching
1082                users (requires the stripcolor module).
1083  T:<banmask>   Blocks notices from matching users (requires the
1084                nonotice module).
1085
1086 A ban given to an Acting extban may either be a nick!user@host mask
1087 (unless stated otherwise), matched against users as for a normal ban,
1088 or a Matching extban.
1089
1090 There is an additional special type of extended ban, a redirect ban:
1091
1092  Redirect      n!u@h#channel will redirect the banned user to #channel
1093                when they try to join (requires the banredirect module).">