IRC Commands

 

This page contains all the commands that are specific to the servers that we use on SFNet.Whilst some of them will be the same as with all chat servers, there are some nice new additions.

To use these commands you will need to use a / than the command eg.

/nick <new nickname>

 

**** 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 ***

 

Searches User Information (-i users only) for supplied information. IRCops are able to

search +i users & can use masks only. When used on a channel , it will give a list of

all the non-invisible users on that channel.

 

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

 

*** NAMES Command ***

 

Provides a list of users on the specified channel.

 

Syntax:NAMES <channel>

Example: NAMES #Support

 

*** ISON Command ***

 

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

 

*** JOIN Command ***

 

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

 

*** PART Command ***

 

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.

 

Syntax: MOTD

MOTD <server>

 

*** 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).

 

Syntax: LUSERS

 

*** MAP Command ***

 

Provides a "Network Map" of the IRC network. Mainly used for routing purposes.

 

Syntax: MAP

 

*** QUIT Command ***

 

Disconnects you from the IRC server. Those in the channels you occupy will be notified of

your departure. If you donot 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.

 

Syntax:PONG <server> <server2>

Example: PONG irc.fyremoon.net irc2.dynam.ac

 (PONG message from irc.fyremoon.net to irc2.dynam.ac).

 

*** 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 all the current n:Lines (GECOS Deny)

V = Lists all the current VHost lines

T = Lists all the current T:Lines (Specific MOTD/Rules Lines)

Y = Lists all the current Y:Lines (Connection classes)

U = Lists all the current U:Lines (Usually Services)

v = Lists all the current V:Lines (Version Deny)

D = Lists all the current D:Lines (Disallow Lines-Oper & Server Orig Connects)

d = Lists all the current d:Lines (Disallow Lines-Autoconnects)

e = Lists all the current e:Lines (Proxy scan exempt IPs)

I = Lists all the current I:Lines (Client auth Lines)

F = Lists all the current F:Lines (DCCDENY Lines)

r = Lists all Channel Restrict lines

N = Lists the Network Configuration report

S = Gives the Dynamic Configuration report

W = Gives the current Server Load

q = Lists all the SQLINEed Nicks

u = Server 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.

 

Syntax: LINKS

 

*** 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.

 

Syntax:TOPIC <channel>

 TOPIC <channel> <topic>

Example: TOPIC #operhelp

 TOPIC #Lobby Welcome to #Lobby!!

 

*** 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.

 

Syntax : WATCH +nick1 +nick2 +nick3(Add nicknames)

 WATCH -nick (Delete nicknames)

 WATCH (View the watchlist)

 

*** HELPOP Command ***

 

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.

 

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.

 

Usage: /QUOTE LIST options

 

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.

>numberList channels with more than <number> people.

<numberList 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 ****

 

For channels which are invite only, you can "Knock" on the channel to request an invite.

 

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 already there

 

Syntax:KNOCK <channel> <message>

Example: KNOCK #secret_chan I'm an op, let me in!

 

*** SETNAME Command ***

 

Allows users to change their 'Real name'

directly online at IRC without reconnecting

 

Syntax: SETNAME <New Real Name>

 

*** VHOST Command ***

 

Hides your real hostname with a virtual hostname provided by the IRC server , using SetHost.

 

Synatx:VHOST login password

Example: VHOST IWant newhost

 

*** MODE Command ***

 

Sets a mode on a Channel or User.

UnrealIRCd has got some new Channel & User modes.

 

Syntax:MODE <channel/user> <mode>

Example: MODE #Support +tn

 MODE #Support +ootn hAtbLaDe cb

 

### Channel Modes ###

 

p = Private channel

s = Secret channel

i = Invite-only allowed

m = Moderated channel, noone can speak except users with mode +voh

n = No messages from outside channel

t = Only channel operators may set the topic

r = Channel is registered

R = Requires a registered nickname to join the channel

c = No ANSI color can be sent to the channel (ColourBlock)

q = Channel owner

 (*)Q = No kicks able in channel unless by U:Lines

O = IRCop only channel (Setable by IRCops)

A = Administrator only channel (Setable by Admins)

K = /Knock is not allowed

V = /Invite is not allowed

S = Strip all incoming colours away

l <number of max users> = Channel may hold at most <number> of users

b <nick!user@host>= Bans the nick!user@host from the channel

k <key> = Needs the channel key to join the channel

o <nickname>= Gives operator status to the user

v <nickname>= Gives voice to the user (May talk if chan is +m)

L <chan2> = If +l is full, the next user will auto-join <chan2>

a <nickname>= Gives protection to the user (No kick/drop)

e <nick!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).

 

 

 

*** 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.

 

Syntax: IDENTIFY <password>(Identify to NickServ)

IDENTIFY #<channel> <password> (Identify to ChanServ as Founder of #channel)