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