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