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