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