summaryrefslogtreecommitdiff
path: root/conf
diff options
context:
space:
mode:
Diffstat (limited to 'conf')
-rw-r--r--conf/inspircd.censor.example12
-rw-r--r--conf/inspircd.filter.example24
-rw-r--r--conf/inspircd.helpop-full.example506
-rw-r--r--conf/inspircd.helpop.example328
4 files changed, 870 insertions, 0 deletions
diff --git a/conf/inspircd.censor.example b/conf/inspircd.censor.example
new file mode 100644
index 000000000..89730669f
--- /dev/null
+++ b/conf/inspircd.censor.example
@@ -0,0 +1,12 @@
+# Configuration file for m_censor.so (1.0.0.0)
+# C.J.Edwards May 2004.
+#
+
+# The tags for this module are formatted as follows:
+#
+# <badword text="simple word"
+# replace="text to replace with">
+
+<badword text="shit" replace="poo">
+<badword text="fuck" replace="(censored)">
+
diff --git a/conf/inspircd.filter.example b/conf/inspircd.filter.example
new file mode 100644
index 000000000..99e133256
--- /dev/null
+++ b/conf/inspircd.filter.example
@@ -0,0 +1,24 @@
+# Configuration file for m_filter.so (2.0.0.0)
+# C.J.Edwards April 2004.
+#
+
+# The tags for this module are formatted as follows:
+#
+# <keyword pattern="any glob pattern here"
+# reason="reason for filtering"
+# action="action to take">
+#
+# Valid actions for 'action' are:
+#
+# block This blocks the line, sends out a notice to all opers with
+# +s and informs the user that their message was blocked.
+#
+# none This action causes nothing to be done except logging. This
+# is the default action if none is specified.
+#
+# kill This disconnects the user, with the 'reason' parameter as
+# the kill reason.
+
+<keyword pattern="*qwerty*" reason="You qwertied!" action="block">
+<keyword pattern="*killmenow*" reason="As you request." action="kill">
+
diff --git a/conf/inspircd.helpop-full.example b/conf/inspircd.helpop-full.example
new file mode 100644
index 000000000..d0f621d63
--- /dev/null
+++ b/conf/inspircd.helpop-full.example
@@ -0,0 +1,506 @@
+#####################
+# Helpop Standard #
+#####################
+
+<start line1=" InspIRCd help system"
+ line2=" --------------------"
+ line3="-"
+ line4="This system provides help for commands and modes."
+ line5="Specify your question or a command name as the"
+ line6="parameter for this command. If you are an oper"
+ line7="you must prefix your query with a ? symbol."
+ line8="-"
+ line9="/HELPOP COMMANDS - To see a list of user commands"
+ line10="/HELPOP COPER - To see a list of oper commands"
+ line11="/HELPOP UMODES - To see a list of user modes"
+ line12="/HELPOP CHMODES - To see a list of channel modes">
+
+<nohelp line1="There is no help for the topic"
+ line2="You searched for. Please try again.">
+
+<nohelpo line1="There is no help for the topic"
+ line2="You searched for. Please try again."
+ line3="-"
+ line4="Your Query has been forwarded to the IRCops">
+
+#####################
+# User Commands #
+#####################
+
+<commands line1="User Commands"
+ line2="-------------"
+ line3="USER NICK QUIT VERSION PING"
+ line4="PONG ADMIN PRIVMSG INFO TIME"
+ line5="WHOIS NOTICE JOIN NAMES PART"
+ line6="KICK MODE TOPIC WHO MOTD"
+ line7="RULES OPER LIST LUSERS STATS"
+ line8="USERHOST AWAY ISON SUMMON USERS"
+ line9="INVITE PASS WHOWAS LINKS MAP"
+ line10="COMMANDS MODULES KNOCK SILENCE DEVOICE"
+ line11="REMOVE PARK UNPARK UNINVITE VHOST"
+ line12="WATCH USERIP">
+
+<watch line1="/WATCH [C|S|+/-[NICK]]"
+ line2="Adds or deletes a user from the watch list. C clears the list"
+ line3="and S queries the status.">
+
+<vhost line1="/VHOST [username] [password]"
+ line2="Authenticate for a vhost.">
+
+<park line1="/PARK"
+ line2="Parks the nickname which issues the command. The session's"
+ line3="connection is closed, but the session remains as a ghost, to"
+ line4="be reclaimed later. When the user quits, they will be given a"
+ line5="key which is random.">
+
+<unpark line1="/UNPARK [nickname] [key]"
+ line2="Unparks the nickname specified. The nickname must already"
+ line3="be previously parked, and the key must match the one for"
+ line4="this nickname.">
+
+<kick line1="/REMOVE [channel] [nick] {[reason]}"
+ line2="Removes a user from a channel you specify. You must be"
+ line3="At least a channel halfoperator to remove a user."
+ line4="A removed user will part with a message stating they"
+ line5="were removed from the channel and by whom.">
+
+<devoice line1="/DEVOICE [channel]"
+ line2="Devoices yourself from the specified channel.">
+
+<silence line1="/SILENCE +/-[nick]"
+ line2="A serverside /ignore of the given nick. It does not follow"
+ line3="the users nick so if they change their nick you will recieve"
+ line4="their messages. /SILENCE without a parameter will list the nicks"
+ line5="that you have silenced.">
+
+<knock line1="/KNOCK [channel]"
+ line2="Sends a notice to a channel indicating you wish to join.">
+
+<user line1="/USER [ident] [local host] [remote host] :[GECOS]"
+ line2="This command is used by your client to register your irc session."
+ line3="You should not use it during an established connection.">
+
+<nick line1="/NICK [new nick]"
+ line2="Change your nickname to [new nick].">
+
+<quit line1="/QUIT [reason]"
+ line2="Quit from IRC and end your current session.">
+
+<version line1="/VERSION"
+ line2="Returns the server's version number.">
+
+<ping line1="/PING [server]"
+ line2="Ping a server. Target server will answer with a PONG.">
+
+<pong line2="/PONG [server]"
+ line2="Your client should send this to answer server PINGs. You"
+ line3="should not issue this command manually.">
+
+<admin line1="/ADMIN [server]"
+ line2="Fetches the administrative information on the given server.">
+
+<privmsg line1="/MSG [target] [text]"
+ line2="Sends a message to a user or channel specified in [target].">
+
+<notice line1="/NOTICE [target] [text]"
+ line2="Sends a notice to a user or channel specified in [target].">
+
+<join line1="/JOIN [channel]{,[channel]} [key]{,[key]}"
+ line2="Joins one or more channels you provide the names for.">
+
+<names line1="/NAMES [channel]{,[channel]}"
+ line2="Return a list of users on the channels you provide.">
+
+<part line1="/PART [channel]{,[channel] [reason]}"
+ line2="Leaves one or more channels you specify.">
+
+<kick line1="/KICK [channel] [nick] {[reason]}"
+ line2="Kicks a user from a channel you specify. You must be"
+ line3="At least a channel halfoperator to kick a user.">
+
+<mode line1="/MODE [target] [+|-][modes]{[+|-][modes]} {mode parameters}"
+ line2="Sets the mode for a channel or a nickname specified in [target]"
+ line3="A user may only set modes upon themselves, and may not set the"
+ line4="+o usermode, and a user may only change channel modes of"
+ line5="channels where they are at least a halfoperator.">
+
+<topic line1="/TOPIC [channel] {topic}"
+ line2="Sets or retrieves the channel topic. If a channel topic is"
+ line3="given in teh command and the channel is either not +t, or"
+ line4="You are at least a halfoperator, the channel topic will be"
+ line5="changed to the new one you provide.">
+
+<who line1="/WHO [channel|nick|servermask|o 0]"
+ line2="Looks up the information of users matching the range you"
+ line3="provide. You may only /WHO nicknames in channels or on servers"
+ line4="where you share a common channel with them."
+ line5="The syntax '/WHO o 0' shows a list of online IRC operators.">
+
+<motd line1="/MOTD [server]"
+ line2="Show the message of the day for [server]. Messages of the"
+ line3="day contain important server rules and notice and should be"
+ line4="read before using a server in any way!">
+
+<rules line1="/RULES"
+ line2="Show the rules file for the local server. This is similar in"
+ line3="effect to /MOTD except that rules are optional. All users are"
+ line4="sent the MOTD when they connect without having to request it.">
+
+<oper line1="/OPER [login] [password]"
+ line2="Attempts to authenticate a user as an IRC operator."
+ line3="Please be aware that both successful and unsucessful oper attempts"
+ line4="Are logged, and sent to online IRC operators.">
+
+<list line1="/LIST [pattern]"
+ line2="Creates a list of all existing channels matching the glob pattern"
+ line3="[pattern], e.g. *chat* or bot*.">
+
+<lusers line1="/LUSERS"
+ line2="Shows a count of local and remote users, servers and channels.">
+
+<userhost line1="/USERHOST [nickname]"
+ line2="Returns the hostname and nickname of a user, and some other"
+ line3="miscellanious information.">
+
+<userip line1="/USERIP [nickname]"
+ line2="Returns the ip and nickname of a user."
+
+<away line1="/AWAY {message}"
+ line2="If a message is given, marks you as being away, otherwise"
+ line3="removes your away status and previous message.">
+
+<ison line1="/ISON [nick] {[nick]...}"
+ line2="Returns a subset of the nicks you give, showing only those"
+ line3="that are currently online.">
+
+<summon line1="/SUMMON [user]"
+ line2="Summons a user from the shell where the ircd is running onto irc"
+ line3="This command is deprecated in the current protocol.">
+
+<users line1="/USERS"
+ line2="Shows users logged into the shell where the ircd is running."
+ line3="This command is deprecated in the current protocol.">
+
+<invite line1="/INVITE [nick] [channel]"
+ line2="Invites a user to a channel. If the channel is NOT +i, any"
+ line3="user, channel op or not, may invite any other user to the"
+ line4="channel, so long as they are a member of that channel."
+ line5="Otherwise, if +i is set only channel halfoperators"
+ line6="and above may invite users into the channel.">
+
+<pass line1="/PASS [password]"
+ line2="This command is used by your irc client when setting up"
+ line3="your irc session, and should not be issued by a fully"
+ line4="connected client.">
+
+<whowas line1="/WHOWAS [nick]"
+ line2="Returns a list of times the user was last seen on irc"
+ line3="along with the time they were last seen and their server.">
+
+<links line1="/LINKS"
+ line2="Shows all servers linked to this one. Note that in this"
+ line3="server implementation all links will be flattened as"
+ line4="a tree based layout is not in use.">
+
+<map line1="/MAP"
+ line2="Shows a graphical representation of all users and servers"
+ line3="on the network. The tree diagram is inaccurate in this"
+ line4="implementation as a tree based network is not in place.">
+
+#####################
+# Oper Commands #
+#####################
+
+<coper line1="Oper Commands"
+ line2="-------------"
+ line3="DIE RESTART KILL REHASH TRACE"
+ line4="CONNECT SQUIT MODULES MKPASSWD SHUN"
+ line5="KLINE QLINE GLINE ELINE ZLINE"
+ line6="SAJOIN SAPART SAMODE SAQUIT SANICK"
+ line7="SETIDLE SETHOST SETNAME SETIDENT SWHOIS"
+ line8="OPERMOTD CHGHOST CHGNAME CHGIDENT CBAN"
+ line9="NICKLOCK NICKUNLOCK LOADMODULE UNLOADMODULE GLOBOPS"
+ line10="SPYLIST SPYNAMES GLOADMODULE GUNLOADMODULE MKSHA256"
+ line11="PARKSTATS FREEZE UNFREEZE OPERPERMS RCONNECT">
+
+<rconnect line1="/RCONNECT [source mask] [target mask]"
+ line2="All servers matching [source mask] will try to connect to"
+ line3="the first server in the config file matching [target mask].">
+
+<operperms line1="/OPERPERMS [nick]"
+ line2="List all commands an oper has access to use.">
+
+<freeze line1="/FREEZE [nick]"
+ line2="Prevents the user from sending commands until they reconnect."
+ line3="User is also notified they have been frozen.">
+
+<unfreeze line1="/UNFREEZE [nick]"
+ line2="Unfreezes a user frozen by the /FREEZE command.">
+
+<parkstats line1="/PARKSTATS"
+ line2="Displays the park module's statistics">
+
+<spylist line1="/SPYLIST"
+ line2="Operates the same as /LIST but includes +s and +p channels.">
+
+<spynames line1="/SPYNAMES [channel]"
+ line2="Operates the same as /name but works on +s and +p channels.">
+
+<globops line1="/GLOBOPS [message]"
+ line2="Sends a message to all +g users.">
+
+<cban line1="/CBAN [channel] {[duration] :[reason]}"
+ line2="Sets or removes a channel ban. You must specify at least"
+ line3="3 parameters to add a ban, and one parameter to remove a ban."
+ line4="The duration may be specified in seconds, or in the following format"
+ line5="1y2w3d4h5m6s - meaning one year, two weeks, three days, 4 hours,"
+ line6="5 minutes and 6 seconds. All fields in this format are optional.">
+
+<sajoin line1="/SAJOIN [nick] [channel]"
+ line2="Forces the user to join the channel.">
+
+<sapart line1="/SAPART [nick] [channel]"
+ line2="Forces the user to part the channel.">
+
+<samode line1="/SAMODE [#chan/nick] +/-[modes] {[parameters for modes]}"
+ line2="Gives the channel or nick the modes specified.">
+
+<sanick line1="/SANICK [nick] [new nick]"
+ line2="Changes the users nick to the new nick.">
+
+<saquit line1="/SAQUIT [nick] [reason]"
+ line2="Forces user to quit with the specified reason.">
+
+<setidle line1="/SETIDLE [idle time]"
+ line2="Sets your idle time (in seconds).">
+
+<sethost line1="/SETHOST [host]"
+ line2="Sets your host to the specified host.">
+
+<setident line1="/SETIDENT [ident]"
+ line2="Sets your ident to the specified ident.">
+
+<setname line1="/SETNAME [name]"
+ line2="Sets your name to the specified name.">
+
+<swhois line="/SWHOIS [nick] [swhois]"
+ line2="Sets the users swhois field to the given swhois.">
+
+<mkpasswd line1="/MKPASSWD [plaintext]"
+ line2="Encodes the plaintext to an MD5 hash and displays the result.">
+
+<mksha256 line1="/MKSHA256 [plaintext]"
+ line2="Encodes the plaintext to an SHA-256 hash and displays the result.">
+
+<opermotd line1="/OPERMOTD"
+ line2="Re-displays the Oper MOTD.">
+
+<nicklock line1="/NICKLOCK [nick] [new nick]"
+ line2="Changes user's nick to the new nick, and forces"
+ line3="it to remain as such for the remainder of the session.">
+
+<nickunlock line1="/NICKUNLOCK [nick]"
+ line2="Allows the user to change nicks.">
+
+<chghost line1="/CHGHOST [nickname] [new hostname]"
+ line2="Changes the hostname of the user to the new hostname>.">
+
+<chgname line1="/CHGNAME [nickname] [new name]"
+ line2="Changes the name of the user to the new name>.">
+
+<chgident line1="/CHGIDENT [nickname] [new ident]"
+ line2="Changes the ident of the user to the new ident.">
+
+<shun line1="/SHUN [user@host] {[duration] :[reason]}"
+ line2="Sets or removes a shun (serverside ignore) on a host and ident mask."
+ line3="You must specify at least 3 parameters to add a shun, and one"
+ line4="parameter to remove a shun (just the user@host section)."
+ line5="The duration may be specified in seconds, or in the following format"
+ line6="1y2w3d4h5m6s - meaning one year, two weeks, three days, 4 hours,"
+ line7="5 minutes and 6 seconds. All fields in this format are optional.">
+
+<die line1="/DIE [password]"
+ line2="If the correct password is provided, and you are an operator,"
+ line3="This command will shut down the local server.">
+
+<restart line1="/RESTART [password]"
+ line2="If the correct password is provided, and you are an operator,"
+ line3="This command will restart the local server.">
+
+<commands line1="/COMMANDS"
+ line2="Shows all currently available commands.">
+
+<kill line1="/KILL [user] [reason]"
+ line2="This command will disconnect a user from IRC with the given reason.">
+
+<rehash line1="/REHASH"
+ line2="This command will cause the server configuration file to be"
+ line3="re-read and values re-initialised.">
+
+<trace line1="/TRACE [nick|user@host|servermask]"
+ line2="This command will provide a list of all users and servers which"
+ line3="must be passed through or over to reach a given object (server or user).">
+
+<connect line1="/CONNECT [servermask]"
+ line2="Create a mesh connection to the given servermask. You must have"
+ line3="configured the server for linking in your configuration file,"
+ line4="and provided a password.">
+
+<squit line1="/SQUIT"
+ line2="Disconnects the local server from the mesh network, causing every"
+ line3="other server in the mesh to drop it.">
+
+<modules line1="/MODULES"
+ line2="Lists currently loaded modules, their memory offsets and version"
+ line3="numbers and flags. If you are not an operator, you will see reduced"
+ line4="detail.">
+
+<loadmodule line1="/LOADMODULE [filename.so]"
+ line2="Loads a module into the IRCd.">
+
+<unloadmodule line1="/UNLOADMODULE [filename.so]"
+ line3="Unloads a module from the IRCd. The module cannot have the static"
+ line4="flag set (see the output of /MODULES).">
+
+<gloadmodule line1="/GLOADMODULE [filename.so]"
+ line2="Globally loads a module into the network.">
+
+<gunloadmodule line1="/GUNLOADMODULE [filename.so]"
+ line3="Globally unloads a module from the network. The module cannot "
+ line4="have the static flag set (see the output of /MODULES).">
+
+<kline line1="/KLINE [user@host] {[duration] :[reason]}"
+ line2="Sets or removes a k-line (host based ban) on a host and ident mask."
+ line3="You must specify at least 3 parameters to add a ban, and one"
+ line4="parameter to remove a ban (just the user@host section)."
+ line5="The duration may be specified in seconds, or in the following format"
+ line6="1y2w3d4h5m6s - meaning one year, two weeks, three days, 4 hours,"
+ line7="5 minutes and 6 seconds. All fields in this format are optional.">
+
+<zline line1="/ZLINE [ipmask] {[duration] :[reason]}"
+ line2="Sets or removes a z-line (ip based ban) on an ip range mask."
+ line3="You must specify at least 3 parameters to add a ban, and one"
+ line4="parameter to remove a ban (just the user@host section)."
+ line5="The duration may be specified in seconds, or in the following format"
+ line6="1y2w3d4h5m6s - meaning one year, two weeks, three days, 4 hours,"
+ line7="5 minutes and 6 seconds. All fields in this format are optional.">
+
+<qline line1="/QLINE [nickmask] {[duration] :[reason]}"
+ line2="Sets or removes a q-line (nick based ban) on a nick mask."
+ line3="You must specify at least 3 parameters to add a ban, and one"
+ line4="parameter to remove a ban (just the user@host section)."
+ line5="The duration may be specified in seconds, or in the following format"
+ line6="1y2w3d4h5m6s - meaning one year, two weeks, three days, 4 hours,"
+ line7="5 minutes and 6 seconds. All fields in this format are optional.">
+
+<gline line1="/GLINE [user@host] {[duration] :[reason]}"
+ line2="Sets or removes a g-line (global host based ban) on host mask."
+ line3="You must specify at least 3 parameters to add a ban, and one"
+ line4="parameter to remove a ban (just the user@host section)."
+ line5="The duration may be specified in seconds, or in the following format"
+ line6="1y2w3d4h5m6s - meaning one year, two weeks, three days, 4 hours,"
+ line7="5 minutes and 6 seconds. All fields in this format are optional.">
+
+<eline line1="/ELINE [user@host] {[duration] :[reason]}"
+ line2="Sets or removes a e-line (local ban exception) on host mask."
+ line3="You must specify at least 3 parameters to add an exception, and one"
+ line4="parameter to remove an exception (just the user@host section)."
+ line5="The duration may be specified in seconds, or in the following format"
+ line6="1y2w3d4h5m6s - meaning one year, two weeks, three days, 4 hours,"
+ line7="5 minutes and 6 seconds. All fields in this format are optional.">
+
+######################
+# User/Channel Modes #
+######################
+
+<umodes line1="User Modes"
+ line2="----------"
+ line3="o Is an IRC operator"
+ line4="i Is invisible to /WHO"
+ line5="w Can receive wallops messages"
+ line6="s Can receive server notices"
+ line7="x Cloaked hostname (requires cloaking module)"
+ line8="g Can receive globops (requires globops module)"
+ line9="h Will receive helpops notification (requires helpop module)"
+ line10="r Nickname is registered"
+ line11="R Only registered users can PRIVMSG this nickname"
+ line12="B Is a bot"
+ line13="G Messages are censored to user"
+ line14="W Can see when a user uses WHOIS on them"
+ line15="S mIRC colour codes are stripped to the user"
+ line16="D User can not recieve PRIVMSGs">
+
+<chmodes line1="Channel Modes"
+ line2="-------------"
+ line3="v [nickname] Gives voice to [nickname] (can talk on +m channel)"
+ line4="h [nickname] Gives halfops to [nickname]"
+ line5="o [nickname] Gives ops to [nickname]"
+ line6="b [hostmask] Bans [hostmask] on the channel"
+ line7="a [nickname] Give protected status to [nickname] (+q only)"
+ line8="q [nickname] Give founder status to [nickname] (ulines only)"
+ line9="i Make the channel invite only, must /INVITE users"
+ line10="k [key] Set the channel key (password) to [key]"
+ line11="l [limit] Set the maximum possible users to [limit]"
+ line12="m Enable moderation. Only +vo(h) can speak"
+ line13="n Only users who are members of the channel may message it"
+ line14="p Make channel private (hide from /LIST)"
+ line15="s Make channel secret (can't be used at the same time as +p)"
+ line16="O Channel is IRCops only (can only be set by IRCops)"
+ line17="t Only halfops and above can change the topic"
+ line18="Q Only U-Lined servers/nicks can kick"
+ line19="T Only halfops/ops can send NOTICEs to the channel"
+ line20="C No CTCPs allowed to the channel"
+ line21="c mIRC colour codes blocked on the channel"
+ line22="S mIRC colour codes are stripped from the channel"
+ line23="e [hostmask] Ban exception on [hostmask]"
+ line24="K No /KNOCK allowed to channel"
+ line25="L [channel] If the channel is full, redirect users to [channel]"
+ line26="N No nickchanges while on the channel"
+ line27="G Censors channel based on network censor config"
+ line28="g [word] All messages containing the word are blocked"
+ line29="I [hostmask] Invite exception allows user to join a channel with +i"
+ line30="j [joins]:[sec] Prevents join flooding"
+ line31="J [seconds] Prevents auto-rejoin on kick"
+ line32="f [*][lines]:[sec] Kick on text flood. With * user is banned"
+ line33="V No invites allowed"
+ line34="r Channel is registered"
+ line35="R Only registered users can join"
+ line36="M Non-registered users can't chat"
+ line37="z SSL clients only"
+ line38="x Join exception mask. Avoids +ibkO"
+ line39="-------------"
+ line40="NOTE: A large number of these modes are dependent upon server-side modules"
+ line41="being loaded by a server/network administrator. The actual modes available"
+ line42="on your network may be very different to this list. Please consult your"
+ line43="help channel if you have any questions.">
+
+######################
+# Stats Symbols #
+######################
+
+<stats line1="/STATS [symbol]"
+ line2="Shows various server statistics. Depending on configuration this"
+ line3="command may be reserved for oper-only use."
+ line4="-"
+ line5="Valid symbols are:"
+ line6="-"
+ line7="m Show command statistics, number of times commands have been used"
+ line8="z Show memory usage statistics"
+ line9="o Show a list of all valid oper usernames and hostmasks"
+ line10="l Show all inbound and outbound server and client connections"
+ line11="u Show server uptime"
+ line12="k Show k-lines (local bans)"
+ line13="g Show g-lines (global bans)"
+ line14="q Show q-lines (nick mask bans)"
+ line15="Z Show z-lines (ip mask bans)"
+ line16="Y Show connection classes"
+ line17="C Show link blocks"
+ line18="U Show u-lined servers"
+ line19="P Show online opers and their idle times"
+ line20="I Show connect class permissions"
+ line21="e Show e-lines (local ban exemptions)"
+ line22="C Show channel bans"
+ line22="s Show shuns"
+ line22="-"
+ line23="Note that all /STATS use is broadcast to online IRC operators.">
+
diff --git a/conf/inspircd.helpop.example b/conf/inspircd.helpop.example
new file mode 100644
index 000000000..34f47e2db
--- /dev/null
+++ b/conf/inspircd.helpop.example
@@ -0,0 +1,328 @@
+# Sample configuration file for m_helpop.so
+# You can either copy this into your conf folder and set up the module to use it,
+# or you can customise the responses for your network and/or add more.
+#
+# WARNING!!! Do not <include> this file into your main conf, use <helpop file> tag
+# instead! There are tags in this file which will conflict with the main config,
+# like <admin> and <server>, and if you include it directly, inspircd will complain!
+#
+
+<start line1=" InspIRCd help system"
+ line2=" --------------------"
+ line3="-"
+ line4="This system provides help for commands and modes."
+ line5="Specify your question or a command name as the"
+ line6="parameter for this command. If you are an oper"
+ line7="you must prefix your query with a ? symbol."
+ line8="-"
+ line9="/HELPOP COMMANDS - To see a list of user commands"
+ line10="/HELPOP COPER - To see a list of oper commands"
+ line11="/HELPOP UMODES - To see a list of user modes"
+ line12="/HELPOP CHMODES - To see a list of channel modes">
+
+<nohelp line1="There is no help for the topic"
+ line2="You searched for. Please try again.">
+
+<nohelpo line1="There is no help for the topic"
+ line2="You searched for. Please try again."
+ line3="-"
+ line4="Your Query has been forwarded to the IRCops">
+
+<commands line1="User Commands"
+ line2="-------------"
+ line3="USER NICK QUIT VERSION PING"
+ line4="PONG ADMIN PRIVMSG INFO TIME"
+ line5="WHOIS NOTICE JOIN NAMES PART"
+ line6="KICK MODE TOPIC WHO MOTD"
+ line7="RULES OPER LIST LUSERS STATS"
+ line8="USERHOST AWAY ISON SUMMON USERS"
+ line9="INVITE PASS WHOWAS LINKS MAP"
+ line10="COMMANDS MODULES">
+
+<user line1="/USER [ident] [local host] [remote host] :[GECOS]"
+ line2="This command is used by your client to register your irc session."
+ line3="You should not use it during an established connection.">
+
+<nick line1="/NICK [new nick]"
+ line2="Change your nickname to [new nick]">
+
+<quit line1="/QUIT [reason]"
+ line2="Quit from IRC and end your current session">
+
+<version line1="/VERSION"
+ line2="Returns the server's version number">
+
+<ping line1="/PING [server]"
+ line2="Ping a server. Target server will answer with a PONG">
+
+<pong line2="/PONG [server]"
+ line2="Your client should send this to answer server PINGs. You"
+ line3="should not issue this command manually.">
+
+<admin line1="/ADMIN [server]"
+ line2="Fetches the administrative information on the given"
+ line3="server.">
+
+<privmsg line1="/MSG [target] [text]"
+ line2="Sends a message to a user or channel specified in [target]">
+
+<notice line1="/NOTICE [target] [text]"
+ line2="Sends a notice to a user or channel specified in [target]">
+
+<join line1="/JOIN [channel]{,[channel]} [key]{,[key]}"
+ line2="Joins one or more channels you provide the names for">
+
+<names line1="/NAMES [channel]{,[channel]}"
+ line2="Return a list of users on the channels you provide">
+
+<part line1="/PART [channel]{,[channel]}"
+ line2="Leaves one or more channels you specify">
+
+<kick line1="/KICK [channel] [nick]"
+ line2="Kicks a user from a channel you specify. You must be"
+ line3-"At least a channel halfoperator to kick a user">
+
+<mode line1="/MODE [target] [+|-][modes]{[+|-][modes]} {mode parameters}"
+ line2="Sets the mode for a channel or a nickname specified in [target]"
+ line3="A user may only set modes upon themselves, and may not set the"
+ line4="+o usermode, and a user may only change channel modes of"
+ line5="channels where they are at least a halfoperator.">
+
+<topic line1="/TOPIC [channel] {topic}"
+ line2="Sets or retrieves the channel topic. If a channel topic is"
+ line3="given in teh command and the channel is either not +t, or"
+ line4="You are at least a halfoperator, the channel topic will be"
+ line5="changed to the new one you provide">
+
+<who line1="/WHO [channel|nick|servermask|o 0]"
+ line2="Looks up the information of users matching the range you"
+ line3="provide. You may only /WHO nicknames in channels or on servers"
+ line4="where you share a common channel with them."
+ line5="The syntax '/WHO o 0' shows a list of online IRC operators.">
+
+<motd line1="/MOTD [server]"
+ line2="Show the message of the day for [server]. Messages of the"
+ line3="day contain important server rules and notice and should be"
+ line4="read before using a server in any way!">
+
+<rules line1="/RULES"
+ line2="Show the rules file for the local server. This is similar in"
+ line3="effect to /MOTD except that rules are optional. All users are"
+ line4="sent the MOTD when they connect without having to request it.">
+
+<oper line1="/OPER [login] [password]"
+ line2="Attempts to authenticate a user as an IRC operator."
+ line3="Please be aware that both successful and unsucessful oper attempts"
+ line4="Are logged, and sent to online IRC operators">
+
+
+<list line1="/LIST [pattern]"
+ line2="Creates a list of all existing channels matching the glob pattern"
+ line3="[pattern], e.g. *chat* or bot*">
+
+<lusers line1="/LUSERS"
+ line2="Shows a count of local and remote users, servers and channels.">
+
+<stats line1="/STATS [symbol]"
+ line2="Shows various server statistics. Depending on configuration this"
+ line3="command may be reserved for oper-only use."
+ line4="-"
+ line5="Valid symbols are:"
+ line6="-"
+ line7="m Show command statistics, number of times commands have been used"
+ line8="z Show memory usage statistics"
+ line9="o Show a list of all valid oper usernames and hostmasks"
+ line10="l Show all inbound and outbound server and client connections"
+ line11="u Show server uptime"
+ line12="k Show k-lines (local bans)"
+ line13="g Show g-lines (global bans)"
+ line14="q Show q-lines (nick mask bans)"
+ line15="Z Show z-lines (ip mask bans)"
+ line16="Y Show connection classes"
+ line17="C Show link blocks"
+ line18="U Show u-lined servers"
+ line19="P Show online opers and their idle times"
+ line20="I Show connect class permissions"
+ line21="e Show e-lines (local ban exemptions)"
+ line22="-"
+ line23="Note that all /STATS use is broadcast to online IRC operators.">
+
+<kline line1="/KLINE [user@host] {[duration] :[reason]}"
+ line2="Sets or removes a k-line (host based ban) on a host and ident mask."
+ line3="You must specify at least 3 parameters to add a ban, and one"
+ line4="parameter to remove a ban (just the user@host section)."
+ line5="The duration may be specified in seconds, or in the following format"
+ line6="1y2w3d4h5m6s - meaning one year, two weeks, three days, 4 hours,"
+ line7="5 minutes and 6 seconds. All fields in this format are optional.">
+
+<zline line1="/ZLINE [ipmask] {[duration] :[reason]}"
+ line2="Sets or removes a z-line (ip based ban) on an ip range mask."
+ line3="You must specify at least 3 parameters to add a ban, and one"
+ line4="parameter to remove a ban (just the user@host section)."
+ line5="The duration may be specified in seconds, or in the following format"
+ line6="1y2w3d4h5m6s - meaning one year, two weeks, three days, 4 hours,"
+ line7="5 minutes and 6 seconds. All fields in this format are optional.">
+
+<qline line1="/QLINE [nickmask] {[duration] :[reason]}"
+ line2="Sets or removes a q-line (nick based ban) on a nick mask."
+ line3="You must specify at least 3 parameters to add a ban, and one"
+ line4="parameter to remove a ban (just the user@host section)."
+ line5="The duration may be specified in seconds, or in the following format"
+ line6="1y2w3d4h5m6s - meaning one year, two weeks, three days, 4 hours,"
+ line7="5 minutes and 6 seconds. All fields in this format are optional.">
+
+<gline line1="/GLINE [user@host] {[duration] :[reason]}"
+ line2="Sets or removes a g-line (global host based ban) on host mask."
+ line3="You must specify at least 3 parameters to add a ban, and one"
+ line4="parameter to remove a ban (just the user@host section)."
+ line5="The duration may be specified in seconds, or in the following format"
+ line6="1y2w3d4h5m6s - meaning one year, two weeks, three days, 4 hours,"
+ line7="5 minutes and 6 seconds. All fields in this format are optional.">
+
+<eline line1="/ELINE [user@host] {[duration] :[reason]}"
+ line2="Sets or removes a e-line (local ban exception) on host mask."
+ line3="You must specify at least 3 parameters to add an exception, and one"
+ line4="parameter to remove an exception (just the user@host section)."
+ line5="The duration may be specified in seconds, or in the following format"
+ line6="1y2w3d4h5m6s - meaning one year, two weeks, three days, 4 hours,"
+ line7="5 minutes and 6 seconds. All fields in this format are optional.">
+
+<userhost line1="/USERHOST [nickname]"
+ line2="Returns the hostname and nickname of a user, and some other"
+ line3="miscellanious information.">
+
+<away line1="/AWAY {message}"
+ line2="If a message is given, marks you as being away, otherwise"
+ line3="removes your away status and previous message">
+
+<ison line1="/ISON [nick] {[nick]...}"
+ line2="Returns a subset of the nicks you give, showing only those"
+ line3="that are currently online.">
+
+<summon line1="/SUMMON [user]"
+ line2="Summons a user from the shell where the ircd is running onto irc"
+ line3="This command is deprecated in the current protocol.">
+
+<users line1="/USERS"
+ line2="Shows users logged into the shell where the ircd is running."
+ line3="This command is deprecated in the current protocol.">
+
+<invite line1="/INVITE [nick] [channel]"
+ line2="Invites a user to a channel. If the channel is NOT +i, any"
+ line3="user, channel op or not, may invite any other user to the"
+ line4="channel, so long as they are a member of that channel."
+ line5="Otherwise, if +i is set only channel halfoperators"
+ line6="and above may invite users into the channel">
+
+<pass line1="/PASS [password]"
+ line2="This command is used by your irc client when setting up"
+ line3="your irc session, and should not be issued by a fully"
+ line4="connected client.">
+
+<whowas line1="/WHOWAS [nick]"
+ line2="Returns a list of times the user was last seen on irc"
+ line3="along with the time they were last seen and their server.">
+
+<links line1="/LINKS"
+ line2="Shows all servers linked to this one. Note that in this"
+ line3="server implementation all links will be flattened as"
+ line4="a tree based layout is not in use.">
+
+<map line1="/MAP"
+ line2="Shows a graphical representation of all users and servers"
+ line3="on the network. The tree diagram is inaccurate in this"
+ line4="implementation as a tree based network is not in place.">
+
+
+<coper line1="Oper Commands"
+ line2="-------------"
+ line3="DIE RESTART KILL REHASH TRACE"
+ line4="CONNECT SQUIT MODULES KLINE ZLINE"
+ line5="QLINE GLINE ELINE">
+
+<die line1="/DIE [password]"
+ line2="If the correct password is provided, and you are an operator,"
+ line3="This command will shut down the local server.">
+
+<restart line1="/RESTART [password]"
+ line2="If the correct password is provided, and you are an operator,"
+ line3="This command will restart the local server.">
+
+<commands line1="/COMMANDS"
+ line2="Shows all currently available commands.">
+
+<kill line1="/KILL [user] [reason]"
+ line2="This command will disconnect a user from IRC with the given"
+ line3="reason.">
+
+<rehash line1="/REHASH"
+ line2="This command will cause the server configuration file to be"
+ line3="re-read and values re-initialised.">
+
+<trace line1="/TRACE [nick|user@host|servermask]"
+ line2="This command will provide a list of all users and servers which"
+ line3="must be passed through or over to reach a given object (server"
+ line4="or user)">
+
+<connect line1="/CONNECT [servermask]"
+ line2="Create a mesh connection to the given servermask. You must have"
+ line3="configured the server for linking in your configuration file,"
+ line4="and provided a password.">
+
+<squit line1="/SQUIT"
+ line2="Disconnects the local server from the mesh network, causing every"
+ line3="other server in the mesh to drop it.">
+
+<modules line1="/MODULES"
+ line2="Lists currently loaded modules, their memory offsets and version"
+ line3="numbers and flags. If you are not an operator, you will see reduced"
+ line4="detail.">
+
+<loadmodule line1="/LOADMODULE [filename.so]"
+ line2="Loads a module into the IRCd.">
+
+<unloadmodule line1="/UNLOADMODULE [filename.so]"
+ line3="Unloads a module from the IRCd. The module cannot have the static"
+ line4="flag set (see the output of /MODULES)">
+
+<umodes line1="User Modes"
+ line2="----------"
+ line3="o Is an IRC operator"
+ line4="i Is invisible to /WHO"
+ line5="w Can receive wallops messages"
+ line6="s Can receive server notices"
+ line7="x Cloaked hostname (requires cloaking module)"
+ line8="g Can receive globops (requires globops module)"
+ line9="h Will receive helpops notification (requires helpop module)">
+
+<chmodes line1="Channel Modes"
+ line2="-------------"
+ line3="v [nickname] Gives voice to [nickname] (can talk on +m channel)"
+ line4="h [nickname] Gives halfops to [nickname] (requires halfop module)"
+ line5="o [nickname] Gives ops to [nickname]"
+ line6="b [hostmask] Bans [hostmask] on the channel"
+ line7="a [nickname] Give protected status to [nickname] (+q only)"
+ line8="q [nickname] Give founder status to [nickname] (ulines only)"
+ line9="i Make the channel invite only, must /INVITE users"
+ line10="k [key] Set the channel key (password) to [key]"
+ line11="l [limit] Set the maximum possible users to [limit]"
+ line12="m Enable moderation. Only +vo(h) can speak"
+ line13="n Only users who are members of the channel may message it"
+ line14="p Make channel private (hide from /LIST)"
+ line15="s Make channel secret (can't be used at the same time as +p)"
+ line16="O Channel is IRCops only (can only be set by IRCops)"
+ line17="t Only halfops and above can change the topic"
+ line18="Q Only U-Lined servers/nicks can kick"
+ line19="T Only halfops/ops can send NOTICEs to the channel"
+ line20="C No CTCPs allowed to the channel"
+ line21="c mIRC colour codes blocked on the channel"
+ line22="K No /KNOCK allowed to channel (if knock module is loaded)"
+ line23="L [channel] If the channel is full, redirect users to [channel]"
+ line24="N No nickchanges while on the channel"
+ line25="-------------"
+ line26="NOTE: A large number of these modes are dependent upon server-side modules"
+ line27="being loaded by a server/network administrator. The actual modes available"
+ line28="on your network may be very different to this list. Please consult your"
+ line29="help channel if you have any questions.">
+
+