Signup | Login
Press Center | Sponsors | License | Advertise | Contacts
Home   Personals   Script   Chat   Support   Link Exchange  
Chat Menu
› About the IRC › Staff › Service Commands » IRC Commands › Chat Now!
Sponsors + Links
› The-Irc Hosting › Freshmeat › Linux-Links
Chat Rules
› IRC Rules › Admin Rules › Terms of Service › Server Linking
Links

Unrealircd Commands

User and Oper Commands
User Modes
Channel Modes
Helpop
Flood Protection
Effectively Banning a User
Spam Protection

^ top

User and Oper Commands

Command
Description
Who
nick <newnickname> Changes your online nick name. Alerts others to the change of your nick
All
whois <nick> Displays information of user requested. Includes Full Name, Host, Channels User is in, and Oper Status
All
who <mask> Who allows you to search for users. Masks include: nickname, #channel, hostmask (*.attbi.com)
All
whowas <nick> <maxreplys> Displays information on a nick that has logged off. The <max replies> field is optional, and limits how many records will be returned.
All
ison <nick1 nick2 nick3 ...> Allows you to check the online status of a user, or a list of users. Simple return, best used for scripts
All
join <channel1,channel2, ...> Allows you to join channels. Using the /join #channel1, #channel2, channel3 will allow you to join more than one channel at a time. The /join 0 command makes you PART All
cycle <channel1, channel2, ...> Cycles the given channel(s). This command is equivalent to sending a PART then a JOIN command. All
motd <server> Displays the servers motd. Adding a server name allows you to view motd’s on other servers.
All
rules <server> Displays the ircd.rules of a server. Adding a server name allows you to view rules on other servers All
lusers <server> Displays current & max user loads, both global and local. Adding a server name allows you to view rules on other servers.
All
map Displays a network map All
quit <reason> Causes you to disconnect from the server. If you include a reason, it will be displayed on all channels as you quit All
ping <user> Sends a PING request to a user. Used for checking connection and lag. Servers issue pings on a timed basis to determine if users are still connected.
All
version <nick> Sends a CTCP Version request to the user. If configured to do so, their client will respond with the client version.
All
links Displays a list of all servers linked to the network All
Admin <server> Displays the admin info of a server. If a server name is included it will display the info of that server.
All
userhost <nick> Displays the userhost of the nick given. Generally used for scripts
All
topic <channel> <topic> Topic <channel> will display the current topic of the given channel. Topic <channel> <topic> will change the topic of the given channel.
All
invite <nick> <channel> Invites the given user to the given channel. (Must be a channel Op)
ChanOp
kick <channel, channel> <user, user> <reason> Kicks a user or users out of a channel, or channels. A reason may also be supplied.
ChanOp
away <reason> Marks you as being away. A reason may also be supplied.
All
Watch +-<nick> +-<nick>
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.
All
helpop ?<topic> or !<topic>
HelpOp is a new system of getting IRC Server help. You type either /HELPOP ? <help system topic> or /HELPOP ! <question> The "?" in /HELPOP means query the help system and if you get no response you can choose '!' to send it to the Help Operators online Using neither ? nor ! will mean the command will be first queried within the help system and if no match if found , it will be forwarded to the help operators All
list <search string> If you don't include a search string, 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*
All
Knock <channel> <message>
Allows you to ‘knock’ on an invite only channel and ask for access. Will not work if channel has one of the following modes set: +K +V. Will also not work if you are banned
All
setname Allows users to change their ‘Real Name’ without reconnecting
All
vhost <login> <password> Hides your host name by using a vhost provided by the server.
All
mode <chan/nick> <mode>
Lets you set channel and user modes. Refer to section 5 for lists of modes
All
credits Lists credits for everyone that has helped create UnrealIRCd
All
license Displays the GNU License All
time <server> Displays the servers date and time. Including a server name allows you to check other servers.
All
botmotd <server>
Displays the servers bot message of the day. Including a server name allows you to check other servers All
identify <password> Sends your password to the services system to identify to your nick.
All
identify <channel> <password> Sends your password to the services system to identify as the founder of a channel.
All
dns <option> Returns information about the IRC server's DNS cache. Note, since most clients have a built-in DNS command, you will most likely need to use /raw DNS to use this. Opers may specify an l as the first parameter to the command to receive a list of entries in the DNS cache. All
oper <userid> <password>
Command to give a user operator status if they match an Oper Block
IRCop
wallops <message> Sends a message to all users with umode +w IRCop
globops <message> Sends a message to all IRCops IRCop
chatops <message> Send a message to all IRCops with umode +c IRCop
locops <message> Sends a message to all local IRCops IRCop
adchat <message> Sends a message to all Admins IRCop
nachat <message> Sends a message to all Net Admins IRCop
kill <nick> <reason> Kills a user from the network IRCop
kline +-<hostmask> <time to ban> <reason> Bans the hostmask from the server it is issued on. It is not a global ban. Time to ban is in seconds, or you can use 1d for 1 days. If the hostmask is prefixed with a -, the kline is removed IRCop
zline +-<ip> <time to ban> <reason> Bans an IP Address from the local server it is issued on. Time to ban is in seconds, or you can use 1d for 1 days. If the ip is prefixed with a - then the zline is removed.
IRCop
gline +-<user@host> <time to ban> :<reason>
Adds a global ban to anyone that matches. Time to ban is in seconds, or you can use 1d for 1 days. To remove a gline, put a –user@host
IRCop
shun +-<user@host> <time to shun> :<reason>
Prevents a user from executing ANY commands and prevents them from speaking. Shuns are global (like glines). Time to shun is in seconds, or you can use 1d for 1 days. To remove a shun, put a –user@host. Setting time to 0 makes it permanent.
IRCop
gzline +-<ip> <time to ban> :<reason>
Adds a global zline. Time to ban is in seconds, or you can use 1d for 1 days. To remove a gzline, put a –user@host. Setting time to 0 makes it permanent.
IRCop
rehash <server> –<flags> Rehashes the servers config file. Including a server name allows you to rehash a remote servers config file. Several flags are also available. They Include
-motd - Only rehash all MOTD and RULES files (including tld {})
-opermotd - Only rehash the OPERMOTD file
-botmotd - Only rehash the BOTMOTD file
-garbage - Force garbage collection
IRCop
restart <server> <password>
Restarts the IRCD Process. Password is required. You may also include a server name to restart a remote server.
IRCop
die <password>
Terminates the IRCD Process. Password is required IRCop
lag <server>
This command is like a Sonar or Traceroute for IRC server. 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
IRCop
sethost <newhost> Lets you change your vhost to what ever you want it to be.
IRCop
setident <newident>
Lets you set your ident to what ever you want it to be
IRCop
chghost <nick> <newhost>
Lets you change the host name of a user currently on the system
IRCop
chgident <nick> <newident>
Lets you set your ident to what ever you want it to be
IRCop
chgname <nick> <newname>
Lets you change the realname of a user currently on the system
IRCop
squit <sever>
Disconnects a server from the network
IRCop
connect <server> <port> <server> If only one server is given, it will attempt to connect the server you are ON to the given server. If 2 servers are given, it will attempt to connect the 2 servers together. Put the hub server as the first, and the leaf server as the second.
IRCop
dccdeny <filemask> <reason>
Adds a DCCDENY for that filemask. Preventing that file from being sent.
IRCop
undccdeny <filemask>
Removes a DCCDENY IRCop
sajoin <nick> <channel>, <channel>
Forces a user to join a channel(s). Available to services & network admins only IRCop
sapart <nick> <channel>, <channel>
Forces a user to part a channel(s). Available to services & network admins only.
IRCop
samode <channel> <mode>
Allows Network & Services admins to change modes of a channel without having ChanOps.
IRCop
rping <servermask>
Will calculate in milliseconds the lag between servers
IRCop
trace <servermask>
Will calculate in milliseconds the lag between servers
IRCop
opermotd
Displays the servers OperMotd File
IRCop
addmotd :<text>
Will add the given text to the end of the Motd
IRCop
addomotd :<text>
Will add the given text to the end of the OperMotd
IRCop
sdesc <newdescription>
Allows server admins to change the description line of their server without restarting.
IRCop
addline <text>
Allows you to add lines to the unrealircd.conf
IRCop
mkpasswd <password>
Will encrypt a clear text password to add it to the unrealircd.conf
IRCop
tsctl offset +/- <time>
Adjust the IRCD’s Internal clock (Do NOT use if you do not understand EXACTLY what it does)
IRCop
tsctl time
Will give a TS Report IRCop
tsctl alltime Will give a TS Report of ALL servers IRCop
tsctl svstime <timestamp>
Sets the TS time of all servers (Do NOT use if you do not understand EXACTLY what it does)
IRCop
htm <option>
Controls settings related to high traffic mode. High Traffic Mode (HTM) basically disables certain user commands such as: list whois who etc in response to extremely high traffic on the server. Options include:
-ON Forces server into HTM
-OFF Forces server out of HTM
-NOISY Sets the server to notify users/admins when in goes in and out of HTM
-QUIET Sets the server to NOT notify when going in and out of HTM
-TO <value> Sets Traffic rate HTM activate
IRCop
stats <option>
B - banversion - Send the ban version list
b - badword - Send the badwords list
C - link - Send the link block list
d - denylinkauto - Send the deny link (auto) block list
D - denylinkall - Send the deny link (all) block list
e - exceptthrottle - Send the except trottle block list
E - exceptban - Send the except ban block list
f - spamfilter - Send the spamfilter list
F - denydcc - Send the deny dcc block list
G - gline - Send the gline list
  Extended flags: [+/-mrs] [mask] [reason] [setby]
    m Return glines matching/not matching the specified mask
    r Return glines with a reason matching/not matching the specified reason
    s Return glines set by/not set by clients matching the specified name
I - allow - Send the allow block list
j - officialchans - Send the offical channels list
K - kline - Send the ban user/ban ip/except ban block list
l - linkinfo - Send link information
L - linkinfoall - Send all link information
M - command - Send list of how many times each command was used
n - banrealname - Send the ban realname block list
O - oper - Send the oper block list
S - set - Send the set block list
s - shun - Send the shun list
  Extended flags: [+/-mrs] [mask] [reason] [setby]
    m Return shuns matching/not matching the specified mask
    r Return shuns with a reason matching/not matching the specified reason
    s Return shuns set by/not set by clients matching the specified name
P - port - Send information about ports
q - sqline - Send the SQLINE list
Q - bannick - Send the ban nick block list
r - chanrestrict - Send the channel deny/allow block list
R - usage - Send usage information
t - tld - Send the tld block list
T - traffic - Send traffic information
u - uptime - Send the server uptime and connection count
U - uline - Send the ulines block list
v - denyver - Send the deny version block list
V - vhost - Send the vhost block list
X - notlink - Send the list of servers that are not current linked
Y - class - Send the class block list
z - zip - Send compression information about ziplinked servers (if compiled with ziplinks support)
Z - mem - Send memory usage information
All
module
Lists all loaded modules All
close
This command will disconnect all unknown connections from the IRC server. IRCOp

^ top

User Modes

Mode
Description
User Modes
r
Identifies the nick as being registered
s
Can listen to server notices
v
Receives infected DCC Send Rejection notices
o
Global IRC Operator (Set in Oper Block)
O
Local IRC Operator (Set in Oper Block)
B
Marks you as being a Bot
i
Invisible (not shown in /who)
A
Server Admin (Set in Oper Block)
x
Gives user a hidden hostname
q
Only U:Lines can kick you (Services Admins Only)
a
Services Admin (Set in Oper Block)
g
Can send & read globops and locops
H
Hide IRCop Status (IRCop Only)
S
Used to protect Services Daemons
t
Says you are using a /vhost
C
Co-Admin (Set in Oper Block)
d
Makes it so you can not receive channel PRIVMSGs
N
Network Administrator (Set in Oper Block)
w
Can listen to wallop messages
h
Available for help (HelpOp) (Set in OperBlock)
G
Filters out all the bad words per configuration
W
Lets you see when people do a /whois on you (IRCops Only)
p
Hides the channels you are in in a /whois reply
R
Allows you to only receive PRIVMSGs/NOTICEs from registered (+r) users
V
Marks you as a WebTV user
z
Indicates that you are an SSL client
T
Prevents you from receiving CTCPs

^ top

Channel Modes

Mode
Description
Channel Modes
A
Only Administrators may join
a <nick>
Makes the user a channel admin
b <nick!user@host>
Bans the given user from the channel
c
No ANSI color can be sent to the channel
C
No CTCP's allowed in the channel
e <nick!user@host>
Exception ban – If someone matches this, they can join a channel even if they match an existing ban
f * <lines:seconds>
Flood protection, if the * is given a user will kick banned when they send <lines:seconds> if no * they are just kicked
G
Makes channel G rated. Checks for words listed in the Badword Blocks, and replaces them with the words specified
M
A registered nickname (+r) is required to talk
h <nick>
Gives half-op status to the user
i
Invite required
K
/knock is not allowed
k <key>
Sets a key needed to join
l <##>
Sets max number of users
L <Chan>
If the amount set by +l has been reached, users will be sent to this channel
m
Moderated channel. Only +v/o/h users may speak
N
No nick name changes permitted
n
No messages from outside channels
O
Only IRCops may join
o <nick>
Gives a user channel operator status
p
Makes channel private
q
Sets channel owner
Q
Only U:Lined servers can kick users
R
Requires a registered nickname to join
S
Strips all incoming colors
s
Makes channel secret
t
Only chanops can set topic
T
No NOTICE's allowed in the channel
u
Auditorium Makes /names and /who #channel only show channel ops
V
/invite is not allowed
v <nick>
Gives a voice to users. (May speak in +M Channels
z
Only clients on a Secure (SSL) Connection may join

^ top

Helpop

UnrealIRCd has a built-in help system accessible by /helpop. The /helpop command is completely user configurable via the help block in the configuration file. Additionally, a help.conf is included which contains some basic help for all commands.
For example /helpop chmodes gives you a overview of all channel modes UnrealIRCd has.
Remember that if you are an ircop (helpop) you will have to prefix the keyword with a '?' character, so /helpop becomes /helpop ? and /helpop chmodes becomes /helpop ?chmodes etc..

^ top

Flood Protection

There are some channel modes which can be very effective against floods. To name a few:
K = no /knock, N = no nickchanges, C = no CTCPs, M = only registered users can talk.
As of beta18 there's also a much more advanced channelmode +f...
Channel mode f
Instead of using scripts and bots to protect against channel floods it is now build into the ircd.
An example +f mode is: *** Blah sets mode: +f [10j]:15
This means 10 joins per 15 seconds are allowed in the channel, if the limit is hit, the channel will be set +i automatically.
The following floodtypes are available:

type: name: default action: other avail. actions: comments
c CTCPs auto +C m, M  
j joins auto +i R  
k knocks auto +K   (counted for local clients only)
m messages/notices auto +m M  
n nickchanges auto +N    
t text kick b per-user messages/notices like the old +f. Will kick or ban the user.

^ top

Effectively Banning a User

Basic bantypes and cloaked hosts
UnrealIRCd supports the basic bantypes like +b nick!user@host.

Also, if a masked host of someone is 'rox-ACB17294.isp.com' and you place a ban *!*@rox-ACB17294.isp.com, then if the user sets himself -x (and his hosts becomes for example 'dial-123.isp.com) then the ban will still match. Bans are always checked against real hosts AND masked hosts.
IP bans are also available (eg: *!*@128.*) and are also always checked.

Bans on cloaked IPs require some explanation:
If a user has the IP 1.2.3.4 his cloaked host could be 341C6CEC.8FC6128B.303AEBC6.IP
If you ban *!*@341C6CEC.8FC6128B.303AEBC6.IP you would ban *!*@1.2.3.4
If you ban *!*@*.8FC6128B.303AEBC6.IP you ban *!*@1.2.3.*
If you ban *!*@*.303AEBC6.IP you ban *!*@1.2.*
This information might be helpful to you when deciding how broad a ban should be.

Extended bantypes
Extended bans look like ~[!]<type>:<stuff>. Currently the following types are available:

type: name explanation:
~q quiet People matching these bans can join but are unable to speak, unless they have +v or higher. Ex: ~q:*!*@blah.blah.com
~c channel If the user is in this channel then (s)he is unable to join. Ex: ~c:#lamers
~r realname If the realname of a user matches this then (s)he is unable to join.
Ex: ~r:*Stupid_bot_script*
NOTE: an underscore ('_') matches both a space (' ') and an underscore ('_'), so this ban would match 'Stupid bot script v1.4'.
These bantypes are also supported in the channel exception list (+e).

^ top

Spam Protection

Spamfilter is a new system to fight spam, advertising, worms and other things. It works a bit like the badwords system but has several advantages.

Spamfilters are added via the /spamfilter command which uses the following syntax:
/spamfilter [add|del|remove|+|-] [type] [action] [tkltime] [reason] [regex]
[type] specifies the target type, you can specify multiple targets: 'c' channel msg, 'p' private msg, 'n' private notice, 'N' channel notice, 'P' part msg, 'q' quit msg, 'd' dcc
[action] specifies the action to be taken (only 1 action can be specified): 'kill', 'tempshun' (only shun current session), 'shun', 'kline', 'gline', 'zline', 'gzline', 'block' (blocks only)
[tkltime] The duration of the *line added by the filter, use '-' to use the default or to skip (eg: if action = 'block')
[reason] Block or *line reason.. you CANNOT use spaces in this, but underscores ('_') will be translated into spaces at runtime. Again, use '-' to use the default.
[regex] this is the actual regex or 'bad word' where we should block on and perform the action at

Here's an example: /spamfilter add pc gline - - Come watch me on my webcam
If the text come watch me on my webcam is found in either a private msg or a channel msg then the message will be blocked and a gline will be added immediately.
Another example: /spamfilter add pc block - - come to irc\..+\..+
This is a regex that will match on Hi, come to irc.blah.net etc....
And an example with specified time/reason:
/spamfilter add p gline 3h Please_go_to_www.viruscan.xx/nicepage/virus=blah Come watch me on my webcam
If come watch me on my webcam is found in a private msg then the user is glined for 3 hours with the reason Please go to www.viruscan.xx/nicepage/virus=blah.

Spamfilters added with /spamfilter are network-wide. They work regardless of whether the user/channel has mode +G set, only opers and ulines (services) are exempted from filtering.