do "/oper thorpe s3cret", then "/kill thorpe", then "/nick thorpe"
UnrealIRCd Commands v2.0
Many times I have had users asking me how some command works & what are all the different options they can use with it. So I thought it would be a good idea & helpful for both chatters & IRC Operators , If they had a centralised command reference , rather than having to look all over for the syntax of new or old commands. In this list , I have tried to incorporate all the commands which time , this manual will be ever changing :-)
Here is the command list :
IRC Users Commands
*** NICK Command ***
Changes your "Online Identity" on a server. All those in the channel you are in will be alerted of your nickname change.
Syntax: NICK <new nickname> Example: NICK hAtbLaDe1
- WHOIS Command ***
Shows information about the user in question, such as their "Name", channels they are currently in, their hostmask, etc.
Syntax: WHOIS <user> Example: WHOIS hAtbLaDe
- WHO Command ***
Syntax: WHO <mask> WHO <nickname> WHO <#channel> WHO 0 o (Lists all Online IRC Operators currently online and not +i) Example: WHO *.aol.com WHO *Bot* WHO #UnrealIRCd
- WHOWAS Command ***
Retrieves previous 'WHOIS' information for users no longer connected to the server.
Syntax: WHOWAS <nickname> WHOWAS <nickname> <max number of replies> Example: WHOWAS hAtbLaDe
Provides a list of users on the specified channel.
Syntax: NAMES <channel> Example: NAMES #Support
Used to determine of a certain user or users are currently on the IRC server based upon their nickname.
Syntax: ISON <user> <user2> <user3> <user4> Example: ISON hAtbLaDe NickServ ChanServ OperServ MemoServ
Used to enter one or more channels on an IRC server. All occupants of the channel will be notified of your arrival. JOIN with 0 as a parameter makes you Part all channels.
Syntax: JOIN <chan>,<chan2>,<chan3> JOIN 0 (Parts all channels) Example: JOIN #Support JOIN #Support,#Lobby
Used to part (or leave) a channel you currently occupy. All those in the channel will be notified of your departure.
Syntax: PART <chan>,<chan2>,<chan3>,<chan4> Example: PART #Support PART #Lobby,#Support
- MOTD Command ***
Displays the Message Of The Day.
- RULES Command ***
Reads the ircd.rules file and sends the contents to the user.
Syntax: RULES RULES <server>
- LUSERS Command ***
Provides Local and Global user information (Such as Current and Maximum user count).
Provides a "Network Map" of the IRC network. Mainly used for routing purposes.
- QUIT Command ***
Disconnects you from the IRC server. Those in the channels you occupy will be notified of your departure. If you do not specify a reason, your nickname becomes the reason.
Syntax: QUIT <reason> Example: QUIT Leaving!
- PING Command ***
The PING command is used to test the presence of an active client or server at the other end of the connection. Servers send a PING message at regular intervals if no other activity detected coming from a connection. If a connection fails to respond to a PING message within a set amount of time, that connection is closed. A PING message MAY be sent even if the connection is active. Note that this is different from a CTCP PING command..
Syntax: PING <server> <server2> Example: PING irc.fyremoon.net PING hAtbLaDe PING hAtbLaDe irc2.dynam.ac
- PONG Command ***
PONG message is a reply to ping message. If parameter <server2> is given, this message will be forwarded to given target. The <server> parameter is the name of the entity who has responded to PING message and generated this message.
- VERSION Command ***
Provides version information of the IRCd software in usage.
Syntax: VERSION VERSION <server>
- STATS Command ***
Provides certain Statistical information about the server
Syntax: STATS <flags> Example: STATS u
### Stats Flags ###
k = Lists all the current K:Lines, Z:Lines (Banned hosts/IP) & E:Lines (K:Line exceptions) g = Lists all the current G:Lines (Banned hosts) & Shuns E = Lists all the current E:Lines (K:Line Exceptions) f = Lists all the current F:lines (Filename masks on DCCDENY) O = Lists all the current O:Lines (IRC Operator Lines) Q = Lists all the current Q:Lines (Forbidden Nicks) C = Lists all the current C/N:Lines (Servers to connect or accept connects from) H = Lists all the current H:Lines (Hub Lines) & L:Lines (Leaf Lines) n = Lists a n:Lines (GECOS Deny) V = Lists all the current VHost linesines (Specific MOTD/Rules Lines) Y = Lists all the current Y:Lines (Cll the current U:Lines (Usually Services) es (Version Deny) D = Lists all the current D:Lines (Disal d = Lists all the current d:Lines (Disallow Lines-Autoconnects) can exempt IPs) I = Lists all the current F = Lists all the current F:Lines (DCCDENY Lines) N = Lists the Network Configuration report S = Gives the Dynacurrent Server Load q = Lists all the SQLIrver Uptime m = Gives the Server command list z Gives Misc Server Information s = Returns the scache and NS numbers t = Returns Misc Info L = Information about current server connections
- LINKS Command ***
Lists all of the servers currently linked to the network.
- ADMIN Command ***
Provides Administrative information regarding the server.
Syntax: ADMIN <server>
- USERHOST Command ***
Returns the userhost of the user in question. Usually used by scripts or bots to retrieve userhost information.
Syntax: USERHOST <nickname> Example: USERHOST hAtbLaDe
- TOPIC Command ***
Sets/Changes the topic of the channel in question, or just display the current Topic.
- INVITE Command ***
Sends a user an invitation to join a particular channel. You must be an Operator on the channel in order to invite a user into it.
Syntax: INVITE <user> <channel> Example: INVITE hAtbLaDe #Support
- KICK Command ***
Removes a user from a channel. Can only be used by Operators or Half-Ops. If no reason is specified, your nickname becomes the reason.
Syntax: KICK <channel>[,<channel2>..] <user>[,<user2>..] <reason> Example: KICK #Lobby foobar Language! KICK #Lobby,#OperHelp Lamer23,Luser12 Lamers!
- AWAY Command ***
Sets your online status to "Away".
Syntax: AWAY <reason> (Marks you as 'Away' with the reason given) AWAY (Un-marks you as 'Away') Example: AWAY Lunch time!
- WATCH Command ***
Watch is a new notify-type system in UnrealIRCd which is both faster and uses less network resources than any old-style notify system. The server will send you a message when any nickname in your watch list logs on or off. The watch list DOES NOT REMAIN BETWEEN SESSIONS - you (or your script or client) must add the nicknames to your watch list every time you connect to an IRC server.
- HELPOP Command ***
Example: HELPOP ?CHMODES (Channel Modes Help) HELPOP ?UMODES (User Mode Help)
*** LIST Command ***
Provides a complete listing of all channels on the network. If a search string is specified, it will only show those matching the search string.
Syntax: LIST <search string> Example: LIST LIST *ircd*
New extended /LIST command options are supported. To use these features, you will likely need to prefix the LIST command with /QUOTE to avoid your client interpreting the command.
If you don't include any options, the default is to send you the entire unfiltered list of channels. Below are the options you can use, and what channels LIST will return when you use them. >number List channels with more than <number> people. <number List channels with less than <number> people. C>number List channels created between now and <number> minutes ago. C<number List channels created earlier than <number> minutes ago. T>number List channels whose topics are older than <number> minutes (Ie., they have not changed in the last <number> minutes. T<number List channels whose topics are newer than <number> minutes. *mask* List channels that match *mask* !*mask* List channels that do not match *mask*
NOTE : C & T parameters do not exist in Unreal 3.1.1-Darkshades. LIST defaults to sending a list of channels with 2 or more members, so use the >0 option to get the full channel listing.
- PRIVMSG/NOTICE Command ***
PRIVMSG and NOTICE, which are used internally by the client for /msg and /notice, in UnrealIRCd support two additional formats: /msg @#channel <text> will send the text to channel-ops on the given channel only. /msg @+#channel <text> will send the text to both ops and voiced users on the channel. While some clients may support these as-is, on others (such as ircII), it's necessary to use /quote privmsg @#channel <text> instead. You can also use % to signify HalfOps on the channel.
Syntax: MSG <nick>,<nick2>,<nick3>,<nick4> :<text> Example: PRIVMSG hAtbLaDe :Hello. PRIVMSG hAtbLaDe,Hatter,GoodBot :Hello everyone!
The format for the NOTICE command is the same as above.
- KNOCK Command ****
The following criteria must be met : - Channel is not +K (No knocks) - Channel is not +I (No invites!) You're not banned! - And you are not alreadytax: KNOCK <channel> <message> Example: KNOCK #secret_chan I'm Command ***
Allows users to change their 'Real name' directly onlax: SETNAME <New Real Name>
- VHOST Command ***
virtual hostname provided by the IRC server , using SetHost.
ample: VHOST IWant newhost
- MODE Command ***
Syntax: MODE <channel/ODE #Support +tn MODE #Support +ootn hAtbLaDe cb
#nnel s = Secret channel i = Invite-only allowed m = Moderated channel, n+voh n = No messages from outside channel t = On set the topic r = Channel is registered R = Requires a registerwner (*)Q = No kicks able in channel unless by U:Lines O = IRCop only channel (Setable by Admins) K = /Knock is not alllowed S = Strip all incoming colours away l <number of max userb <nick!user@host> = Bans the nick!user@host from the channel k <key> el o <nickname> = Gives operator status = Gives voice to the user (May talk if chan is +m) L <chan2> will auto-join <chan2> a <nickname> = Gives protection to the user@host> = Exception ban - If someone matches it they can join even if a ban matches them (**)h <nickname> = Gives halfop status to the user f [*]<lines>:<seconds> = Flood protection, if the * is given a user will be kick banned when they send <lines> in <seconds> If * is not given they are just kicked H = No +I users may join that channel. (Setable by Admins). N = No nickname changes are permitted in the channel. ^ = Reports Channel modes in bitstring. (Only exists in Development Versions i.e #define DEVELOP) G = Makes the channel G Rated. Any words in badwords.channel.conf are replaced with <censored> in channel messages. u = "Auditorium". Makes /names and /who #channel only show @'s C = No CTCPs allowed in the channel. z = Only Clients on a Secure Connection (SSL) can join.
(*) Channel mode +Q This is the 'peace' mode. Noone can kick each other except by U:Lines. Bans can be placed though.
(**) Channel halfops (+h) If you are marked as halfop (% in /names) you can do: - Set topic - Kick non-ops - Set modes +vmntibe
### User Modes ###
O = Local IRC Operator o = Global IRC Operator i = Invisible (Not shown in /who searches) w = Can listen to wallop messages g = Can read & send to globops, and locops h = Available for help s = Can listen to server notices k = See's all the /KILL's which were executed S = For services only. (Protects them) a = Is a Services Administrator A = Is a Server Administrator N = Is a Network Administrator T = Is a Tech Admininistator C = Is a Co Administrator c = See's all Connects/Disconnects on local server f = Listen to flood alerts from server r = Identifies the nick as being registered x = Gives the user hidden hostname e = Can listen to server messages sent to +e users b = Can read & send to chatops W = (IRC Operators only) Lets you see when people does a /whois on you q = (Services Admins only) Only U:lines can kick you B = Marks you as being a Bot F = Lets you recieve far Connect notices & Local notices. I = Invisible Join/Part. Makes you being hidden at channels H = (IRC Operators only) Hide IRC Operator status in /who and /whois d = Makes it so you can not recieve channel messages v = Receive infected DCC send rejection notices t = Says that you are using a /vhost G = Filters out all bad words (badwords.message.conf) in messages with <censored> z = Marks the client as being on a Secure Connection (SSL).
- CREDITS Command ***
Syntax: CREDITS CREDITS <server>
- DALINFO Command ***
Syntax: DALINFO DALINFO <server>
- LICENSE Command ***
This command shows the GNU License Which is hard-coded into the IRCd
Syntax: LICENSE LICENSE <server>
- TIME Command ***
Lists the current Server Date and Time.
Syntax: TIME TIME <server>
- BOTMOTD Command ***
Lists the IRCd Bot Message Of The Day
- SILENCE Command ***
Ignores messages from a user or list of users at the Server itself.
Syntax: SILENCE +<nickname> (Adds a nickname to SILENCE list). SILENCE -<nickname> (Removes a nickname from the SILENCE list). SILENCE (Lists the current SILENCE list)
- IDENTIFY Command ***
An alias to allow you to identify to NickServ or ChanServ with your password. If it cannot find NickServ or ChanServ , it will report services as down.
IRC Operator Commands
*** OPER Command ***
Syntax: OPER <uid> <password> Example: OPER hAtbLaDe foobar234
- WALLOPS Command ***
Syntax: WALLOPS <message>
- GLOBOPS Command ***
Syntax: GLOBOPS <message> Example: GLOBOPS Going to be akilling those clones...
- CHATOPS Command ***
Syntax: CHATOPS <message> Example: CHATOPS How's everyone doing today?
- LOCOPS Command ***
Syntax: LOCOPS <message> Example: LOCOPS Going to be adding a temp k:line for that user...
- ADCHAT Command ***
- NACHAT Command ***
This command sends to all NetAdmins & TechAdmins online Only for Net/Techadmins. This is a ChatOps style command
- TECHAT Command ***
This command sends to all TechAdmins online Only for Net/Techadmins. This is a ChatOps style command
Syntax: TECHAT <text> Example: TECHAT Hey guys!
- KILL Command ***
Syntax: KILL <user> <reason> Example: KILL Clone5 Cloning is not allowed
Syntax: KLINE <hostmask> <reason> Example: KLINE *@*.aol.com Abuse
- UNKLINE Command ***
LINE <hostmask> Example: UNKLINE *@*.aol.com
Syntax: ZLINE <ip> :reasonNZLINE Command ***
Removes a currently active Syntax: UNZLINE <ip> Example: UNZLINE 127.0.0.1
- GLimed G:Lines. If you match
a G:Line you cannot connect to ANY server on es it permanent (Never Expires). In Unreal 3.1 in the format 1d10h15m30s. IRC Operators only.
Syntax : SHUN <nickname> <time> :<Reason> (Shun the nickname for time) SHUN +<user@host> <time> :<Reason> (Shun the user@host for time) SHUN -<user@host> (Removes the SHUN for user@host) SHUN (View the current SHUN list)
Example : SHUN +firstname.lastname@example.org 600 :Spamming (Shuns email@example.com for 10 mins for Spamming) SHUN +firstname.lastname@example.org 1d6h :Spamming (Adds a 30 hour SHUN)
- GZLINE Command ***
This command provides timed global Z:line. If you match a Global Z:Line you cannot connect to ANY server on the IRC network A time of 0 in the GZLINE makes it permanent (Never Expires). You may also specify the time in the format 1d10h15m30s. IRC Operator only command.
Syntax: GZLINE <user@host mask> <seconds to be banned> :<reason> (Adds a Global Z:line for user@host) GZLINE -<user@host mask> (Removes a Global Z:line for user@host) Example: GZLINE *@*.dal.net 900 :Spammers (Adds a 15 min Global Z:line) GZLINE *@*.dal.net 1d5h :Spammers (Adds a 29 hour Global Z:line)
- TKLINE Command ***
This command provides timed K:Lines. If you match a time K:Line you cannot connect to the server until the time has expired A time of 0 in the TKLINE makes it permanent (Never Expires). You may also specify the time in the format 1d10h15m30s. IRC Operator only command.
Syntax: TKLINE <user@host mask> <seconds to be banned> :<reason> (Adds a Timed K:line for user@host) TKLINE -<user@host mask> (Removes a Timed K:line for user@host) Example: TKLINE *@*.dal.net 900 :Spammers (Adds a 15 min Timed K:line) TKLINE *@*.dal.net 1d5h :Spammers (Adds a 29 hour Timed K:line)
- TZLINE Command ***
Syntax: TZLINE <user@host mask> <seconds to be banned> :<reason> (Adds a Timed Z:line for user@host) TZLINE -<user@host mask> (Removes a Timed Z:line for user@host) Example: TZLINE *@*.dal.net 900 :Spammers (Adds a 15 min Timed Z:line) TZLINE *@*.dal.net 1d5h :Spammers (Adds a 29 hour Timed Z:line)
- AKILL Command *** (Use Services AKILL Instead)
Syntax : AKILL <user@host> :<Reason> Example : AKILL email@example.com :Spammers!
Syntax : RAKILL <user@host>
- REHASH Command ***
Syntax: REHASH <servername> -<flags> REHASH -<flags>
The flags are used to rehash other config files, valid flags are: -dccdeny - Rehashes dccdeny.conf -dynconf - Rehashes UnrealIRCd Config and Network file -restrict - Rehashes chrestrict.conf -vhost - Rehashes vhost.conf -motd - Rehashes all MOTD files and RULES files (including T:lines) -opermotd - Rehashes the OPERMOTD -botmotd - Rehashes the BOTMOTD -garbage - Force garbage collection -badwords - Rehashes the badwords config.
- RESTART Command ***
Syntax: RESTART RESTART <password> RESTART <server> <password>
- DIE Command ***
- LAG Command ***
This command is like a Sonar or Traceroute for IRC servers You type in /LAG irc.fyremoon.net and it will reply from every server it passes with time and so on Useful for looking where lag is and optional TS future/past travels
Syntax: LAG <servername>
- SETHOST Command ***
- SETIDENT Command ***
Syntax: SETIDENT <new ident> Example: SETIDENT root
- CHGHOST Command ***
Syntax: CHGHOST <nick> <host> Example: CHGHOST hAtbLaDe code.slashdot.org
- CHGIDENT Command ***
Syntax: CHGIDENT <nick> <ident> Example: CHGIDENT hAtbLaDe FreeBSD
- CHGNAME Command ***
Syntax: CHGNAME <nick> <name> Example: CHGNAME hAtbLaDe TechAdmin on SomeNet
- SQUIT Command ***
Syntax: SQUIT <server> Example: SQUIT leaf.*
- CONNECT Command ***
Syntax: CONNECT <server> CONNECT <hub> <port> <leaf> Example: CONNECT leaf.* CONNECT hub.* 6667 leaf.*
Adds a DCC Deny for that filename mask. This means that any DCC sends of that filename mask through the server will be rejected. IRC Operators o Syntax : DCCDENY <filename mask> <reason>
If the EXACT file you type is found it is removed,IRC Operators only.
Syntax : UNDCCDENY <filename mask>
- SAJOIN Comma Services Admin.
Example: SAPART hAtbLaDe #OperHtbLaDe #Support,#IRCHelp
SyntaAMODE #Support +m
- RPING Command ***
Syntax: RPING <servermask></servermask>
is useful to know what servers are connected to what. Sometimes TRACE cing it for the first time.
Syntax: T Example: TRACE irc.fyremoon.net
- OPERMOTD Command ***
Shows the IRCd Operator MOTD IRC Operators only.
- ADDMOTD Command ***
This will add the text you specify to the MOTD (the general motd - T:lines doesnt count ..) Server Admin & Co-Admin only
Syntax: ADDMOTD :text
- ADDOMOTD Command ***
Syntax: ADDOMOTD :text
- SDESC Command ***
Syntax: SDESC <New description> Example: SDESC If you belong to me..
- MKPASSWD Command ***
This command will encrypt the string it has been given So u can add it directly to the unrealircd.conf if you use Encrypted passwords. Type can be crypt, sha1, or md5. Sha1 and md5 are only available when compiled with SSL support.
Syntax : MKPASSWD <method></method> <password></password>
- TSCTL Command ***
This is a highly advanced command IRC Operators only.
Syntax: TSCTL OFFSET +|- <time></time> (Adjust internal IRC clock) TSCTL TIME (Will give TS report) TSCTL ALLTIME (Shows the TS report of all Servers) TSCTL SVSTIME <timestamp></timestamp> (Sets the Time on all servers)
- HTM Command ***
Switches the server In & Out of High Traffic Mode It is activated when the server is receiving extremely high amounts of information IRC Operators only.
Syntax: HTM [option]
If no option is specified it just displays the current HTM state If an option is specified it does a more specific task, valid options are:
ON - Force HTM to activate OFF - Force HTM to deactivate NOISY - Make HTM announce when it is entering/leaving HTM QUIET - Stop HTM from announcing when it is entering/leaving HTM TO <value></value> - Tell HTM at what incoming rate to activate HTM
UnrealIRCd O:Line flags
r = Access to /rehash server h = Oper can send /help ops - gets +h on oper up g = Oper can send /globops w = Oper can send /wallops l = Oper can send /locops c = Access to do local /squits and /connects k = Access to do local /kills b = Oper can /kline users from server B = Oper can /unkline users from server n = Oper can send local server notices (/notice $servername message) u = Oper can set /umode +c f = Oper can set /umode +f O = Global oper, flags included: oRDK o = Local oper, flags included: rhgwlckbBnuf R = Access to /restart server D = Access to /die server K = Access to do global /kills A = Gets +A on oper up. Server Administrator a = Gets +a on oper up. Services Administrator N = Gets +N on oper up. Network Administrator T = Gets +T on oper up. Technical Administator C = Gets +C on oper up. Co Administrator Y = Access to do remote /squits and /connects z = Can add /zlines H = Gets +x on oper up. W = Gets +W on oper up. ^ = Allows to use umode +I * = Flags AaNCTzSHW^
This document is based on a document by: