Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
branch: master
Fetching contributors…

Octocat-spinner-32-eaf2f5

Cannot retrieve contributors at this time

file 967 lines (633 sloc) 32.109 kb

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

      Syntax: LUSERS





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

      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.







      • 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 +foobar@aol.com 600 :Spamming (Shuns foobar@aol.com for 10 mins for Spamming) 
                SHUN +foobar@aol.com 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 foo@aol.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.






,<channel2></channel2>..]

      Example: SAPART hAtbLaDe #OperHtbLaDe #Support,#IRCHelp









      SyntaAMODE #Support +m

      • RPING Command ***




      Syntax: RPING &lt;servermask&gt;&lt;/servermask&gt;

 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.

      Syntax: OPERMOTD

      • 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 &lt;method&gt;&lt;/method&gt; &lt;password&gt;&lt;/password&gt;

      • TSCTL Command ***
      This is a highly advanced command
      IRC Operators only.

      Syntax: TSCTL OFFSET +|- &lt;time&gt;&lt;/time&gt;   (Adjust internal IRC clock)
              TSCTL TIME                (Will give TS report)
              TSCTL ALLTIME   (Shows the TS report of all Servers)
              TSCTL SVSTIME &lt;timestamp&gt;&lt;/timestamp&gt;  (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 &lt;value&gt;&lt;/value&gt; - 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:

 hAtbLaDe &lt;hatblade@roxnet.org&gt;&lt;/hatblade@roxnet.org&gt;
Something went wrong with that request. Please try again.