RootServ Commands

      We use RootServ in place of OperServ.

      Commands are indexed alphabetically. Examples of the actual commands that you can copy, paste, and send are listed in italics. A description of the command follows the command. Underlined words in the command are variables that need to be changed to send the command correctly. For example #channel should be changed to your channel's name, Nick is your nick or the nick of the user, Text might be the message you want to be displayed. These can vary by command and will be explained in the command's description that follows. Variables inside curly braces like {ON|OFF} are selections that require one of the options inside the curly braces to be specified.

Commands available to IRCOps only:

• ADMIN LIST: /msg rootserv admin list
  List all Services Admins
• GLOBAL: /msg rootserv global message
  Allows IRCOps to send messages to all users on the network. The message will be sent from the nick Globalz.
• OPER LIST: /msg rootserv oper list
  List all Services operators
• STAFF: /msg rootserv staff
  Displays all Services Staff nicks along with level and on-line status.
• STATS: Show status of Services and network. Without any option, shows the current number of users and IRCOps online (excluding Services), the highest number of users online since Services was started, and the length of time Services has been running.
• AKILL: /msg rootserv stats akill
  Displays the current size of the AKILL list and the current default expiry time.
• ALL: /msg rootserv stats all
  The ALL option is available only to Services Admins, and displays information on Services' memory usage. Using this option can freeze Services for a short period of time on large networks, so don't overuse it!
• RESET: /msg rootserv stats reset
  The RESET option currently resets the maximum user count to the number of users currently present on the network.

Commands available to Services Operators and Admins only:

• AKILL: Allows Services operators to manipulate the AKILL list. If a user matching an AKILL mask attempts to connect, Services will issue a KILL for that user and, on supported server types, will instruct all servers to add a ban (K-line) for the mask which the user matched. Limited to Services operators.
  
  • ADD: /msg rootserv akill add +expiry mask reason
    AKILL ADD adds the given user@host mask to the AKILL list for the given reason (which must be given). Expiry is specified as an integer followed by one of d (days), h (hours), or m (minutes). Combinations (such as 1h30m) are not permitted. If a unit specifier is not included, the default is days (so +30 by itself means 30 days). To add an AKILL which does not expire, use +0. If the usermask to be added starts with a +, an expiry time must be given, even if it is the same as the default. The current AKILL default expiry time can be found with the /msg rootserv STATS AKILL command.
  • DEL: /msg rootserv akill del {mask|entry-num|list}
    The AKILL DEL command removes the given mask from the AKILL list if it is present. If a list of entry numbers is given, those entries are deleted. (See the example for LIST below.)
  • LIST: /msg rootserv akill list mask|list
    The AKILL LIST command displays the AKILL list. If a wildcard mask is given, only those entries matching the mask are displayed. If a list of entry numbers is given, only those entries are shown; for example: /msg rootserv AKILL LIST 2-5,7-9 Lists AKILL entries numbered 2 through 5 and 7 through 9.
  • VIEW: /msg rootserv AKILL VIEW mask|list
    AKILL VIEW is a more verbose version of AKILL LIST, and will show who added an AKILL, the date it was added, and when it expires, as well as the user@host mask and reason.
  • CLEAR: /msg rootserv AKILL CLEAR
    AKILL CLEAR clears all entries of the AKILL list.
• CHANKILL: /msg rootserv chankill +expiry #channel reason
  Puts an AKILL for every nick on the specified channel. It uses the entire and complete real ident@host for every nick, then enforces the AKILL.
• CLEARMODES: /msg rootserv CLEARMODES #channel ALL
  Clears all binary modes (i,k,l,m,n,p,s,t) and bans from a channel. If ALL is given, also clears all ops and voices (+o and +v modes) from the channel. Limited to Services operators.
• KICK: /msg rootserv kick #channel user reason
  Allows IRCOps to kick a user from any channel. Parameters are the same as for the standard /KICK command. The kick message will have the nickname of the IRCOp sending the KICK command prepended; for example: *** SpamMan has been kicked off channel #my_channel by RootServ (_Mist_ (Flood))
• KILLCLONES: /msg rootserv killclones nick
  Kills all users who have the same hostname as nick. A temporary AKILL, in the form *@host, is added to prevent the offending clients from immediately reconnecting. A wallops is also sent indicating who used the command, which host was affected and how many users were killed. It's useful for removing numerous clones from the network. Limited to Services operators.
• MODE: /msg rootserv mode #channel modes
  Allows Services operators to set channel modes for any channel. Parameters are the same as for the standard /MODE command. Limited to Services operators.
• SQLINE: Allows Services operators to manipulate the SQLINE list. If a user with a nick matching an SQLINE mask attempts to connect, Services will not allow it to pursue his IRC session. If the first character of the mask is #, services will prevent the use of matching channels (on IRCds that support it). Limited to Services operators.
  
  • ADD: /msg rootserv sqline add +expiry mask :reason
    SQLINE ADD adds the given mask to the SQLINE list for the given reason (which must be given). expiry is specified as an integer followed by one of d (days), h (hours), or m (minutes). Combinations (such as 1h30m) are not permitted. If a unit specifier is not included, the default is days (so +30 by itself means 30 days). To add an SQLINE which does not expire, use +0. If the mask to be added starts with a +, an expiry time must be given, even if it is the same as the default. The current SQLINE default expiry time can be found with the /msg rootserv STATS AKILL command.
  • DEL: /msg rootserv sqline del {mask|entry-num|list}
    The SQLINE DEL command removes the given mask from the SQLINE list if it is present. If a list of entry numbers is given, those entries are deleted. (See the example for LIST below.)
  • LIST: /msg rootserv sqline list mask|list
    The SQLINE LIST command displays the SQLINE list. If a wildcard mask is given, only those entries matching the mask are displayed. If a list of entry numbers is given, only those entries are shown; for example: /msg rootserv sgline list 2-5,7-9 Lists SQLINE entries numbered 2 through 5 and 7 through 9.
  • VIEW: /msg rootserv sqline view mask|list
    SQLINE VIEW is a more verbose version of SQLINE LIST, and will show who added an SQLINE, the date it was added, and when it expires, as well as the mask and reason.
  • CLEAR: /msg rootserv sqline clear
    SQLINE CLEAR clears all entries of the SQLINE list.

Commands available to Services Admins only:

• CACHE:
  Lists hostname cache used by the proxy detector.
  • DEL: /msg rootserv cache del hostname
    Deletes the specified hostname from the cache. This is meant for debug purpose only.
  • LIST: /msg rootserv cache list pattern QUEUED|ALL
    Lists all found proxies that match the given pattern. If the QUEUED option is given, it will list the queued or in progress scans instead, and if the ALL option is given, it will list all cached hostnames.
• CHANLIST: /msg rootserv chanlist {pattern|nick}[SECRET]
  Lists all channels currently in use on the IRC network, whether they are registered or not. If pattern is given, lists only channels that match it. If a nickname is given, lists only the channels the user using it is on. If SECRET is specified, lists only channels matching pattern that have the +s or +p mode.
• DEFCON: The defcon system is used to implement a pre-defined set of restrictions to services useful during an attempted attack on the network.
  
  • DEFCON 5: /msg rootserv defcon 5
    Peace
  • DEFCON 4: /msg rootserv defcon 4
    Reduced Session Limit + No new memos + No new channel registrations + No New Nick Registrations
  • DEFCON 3: /msg rootserv defcon 3
    As DefCon4 + Force Chan Mode + No MLOCK changes + Services will ignore everyone but opers
  • DEFCON 2: /msg rootserv defcon 2
    As DefCon3 + Services will silently ignore everyone but opers
  • DEFCON 1: /msg rootserv defcon 1
    As DefCon2 + AKILL all new clients trying to connect
• EXCEPTION: Allows Services admins to manipulate the list of hosts that have specific session limits - allowing certain machines, such as shell servers, to carry more than the default number of clients at a time. Once a host reaches it's session limit, all clients attempting to connect from that host will be killed. Before the user is killed, they are notified, via a /NOTICE from RootServ, of a source of help regarding session limiting. The content of this notice is a config setting. Note that a connecting client will "use" the first exception their host matches. Large exception lists and widely matching exception masks are likely to degrade services' performance.
  
  • ADD: /msg rootserv exception add +expiry mask limit reason
    Adds the given host mask to the exception list. Note that nick!user@host and user@host masks are invalid! Only real host masks, such as box.host.dom and *.host.dom, are allowed because sessions limiting does not take nick or user names into account. limit must be a number greater than or equal to zero. This determines how many sessions this host may carry at a time. A value of zero means the host has an unlimited session limit. See the AKILL help for details about the format of the optional expiry parameter.
  • DEL: /msg rootserv exception del {mask|list}
    Removes the given mask from the exception list.
  • MOVE: /msg rootserv exception move num position
    Moves exception num to position. The exceptions in-between will be shifted up or down to fill the gap.
  • LIST: /msg rootserv exception list mask|list
    Show all current exceptions; if the optional mask is given, the list is limited to those exceptions matching the mask.
  • VIEW: /msg rootserv exception view mask|list
    More verbose than LIST, displays the name of the person who added the exception, it's session limit, reason, host mask and the expiry date and time.
• IGNORE: Allows Services Admins to make Services ignore a nick for a certain time or until the next restart. The default time format is seconds. You can specify it by using units. Valid units are: s for seconds, m for minutes, h for hours and d for days. Combinations of these units are not permitted. To make Services permanently ignore the user type 0 as time.
  
  • ADD: /msg rootserv ignore add time nick
    Adds the given ignore.
  • DEL: /msg rootserv ignore del time nick
    Removes the given ignore.
  • LIST: /msg rootserv ignore list
    Lists all ignores.
  • CLEAR: /msg rootserv ignore clear time nick
    Clears all ignores.
• JUPE: /msg rootserv jupe server reason
  Tells Services to jupiter a server -- that is, to create a fake "server" connected to Services which prevents the real server of that name from connecting. The jupe may be removed using a standard SQUIT. If a reason is given, it is placed in the server information field; otherwise, the server information field will contain the text "Juped by nick", showing the nickname of the person who jupitered the server.
• LOGONNEWS: Edits or displays the list of logon news messages. When a user connects to the network, these messages will be sent to them. (However, no more than three messages will be sent in order to avoid flooding the user. If there are more than three news messages, only the three most recent will be sent.) LOGONNEWS LIST may be used by any IRC operator to list the current news messages. ADD and DEL may only be used by Services admins.
  
  • ADD: /msg rootserv logonnews add text
    Adds a logon news message.
  • DEL: /msg rootserv logonnews del {num|ALL}
    Deletes a logon news message. All will delete all messages.
  • LIST: /msg rootserv logonnews list
    Lists all logon news messages
• OPER: Allows the Services admins to add or remove nicknames to or from the Services operator list. A user whose nickname is on the Services operator list and who has identified to NickServ will be able to access Services operator commands. Any IRC operator may use the OPER LIST form of the command. All other use limited to Services admins.
  
  • ADD: /msg rootserv oper add nick
    The OPER ADD command adds the given nickname to the Services operator list.
  • DEL: /msg rootserv oper del {nick|entry-num|list}
    The OPER DEL command removes the given nick from the Services operator list. If a list of entry numbers is given, those entries are deleted. (See the example for LIST below.)
  • LIST: /msg rootserv oper list mask|list
    The OPER LIST command displays the Services operator list. If a wildcard mask is given, only those entries matching the mask are displayed. If a list of entry numbers is given, only those entries are shown; for example:/msg rootserv oper list 2-5,7-9 Lists SzLINE entries numbered 2 through 5 and 7 through 9.
  • CLEAR: /msg rootserv oper clear
    The OPER CLEAR command clears all entries of the Services operator list.
• OPERNEWS: Edits or displays the list of oper news messages. When a user opers up (with the /OPER command), these messages will be sent to them. (However, no more than three messages will be sent in order to avoid flooding the user. If there are more than three news messages, only the three most recent will be sent.) OPERNEWS LIST may be used by any IRC operator to list the current oper news messages. ADD and DEL may only be used by Services admins.
  
  • ADD: /msg rootserv opernews add text
    Adds a oper news message.
  • DEL: /msg rootserv opernews del {num|ALL}
    Deletes a oper news message. All will delete all messages.
  • LIST: /msg rootserv opernews list
    Lists all oper news messages
• NOOP: Temporarily remove all O:lines of a server remotely. Note: The server is not checked at all by the Services.
  
  • SET: /msg rootserv noop set server
    Remove all O:lines of the given server and kill all IRCOps currently on it to prevent them from rehashing the server (because this would just cancel the effect).
  • REVOKE: /msg rootserv noop revoke server
    Makes all removed O:lines available again on the given server.
• QUIT: /msg rootserv quit
  Causes Services to do an immediate shutdown; databases are not saved. This command should not be used unless damage to the in-memory copies of the databases is feared and they should not be saved. For normal shutdowns, use the SHUTDOWN command.
• RANDOMNEWS: Edits or displays the list of random news messages. When a user connects to the network, one (and only one) of the random news will be randomly chosen and sent to them. RANDOMNEWS LIST may be used by any IRC operator to list the current news messages. ADD and DEL may only be used by Services admins.
  
  • ADD: /msg rootserv randomnews add text
    Adds a random news message.
  • DEL: /msg rootserv randomnews del {num|ALL}
    Deletes a random news message. All will delete all messages.
  • LIST: /msg rootserv randomnews list
    Lists all random news messages
• RELOAD: /msg rootserv reload
  Causes Services to reload the configuration file. Note that some directives still need the restart of the Services to take effect (such as Services' nicknames, activation of the session limitation, etc.)
• RESTART: /msg rootserv restart
  Causes Services to save all databases and then restart (i.e. exit and immediately re-run the executable).
• SESSION: Allows Services admins to view the session list. (See the EXCEPTION help for more information about session limiting and how to set session limits specific to certain hosts and groups thereof.)
  
  • LIST: /msg rootserv session list threshold
    Lists hosts with at least threshold sessions. The threshold must be a number greater than 1. This is to prevent accidental listing of the large number of single session hosts.
  • VIEW: /msg rootserv session view host
    Displays detailed information about a specific host - including the current session count and session limit. The host value may not include wildcards.
• SET: Set various global Services options
  
  • DEBUG: /msg rootserv set debug {ON|OFF|num}
    Sets debug mode on or off. In debug mode, all data sent to and from Services as well as a number of other debugging messages are written to the log file. If num is given, debug mode is activated, with the debugging level set to num. This option is equivalent to the command-line option -debug.
  • LOGCHAN: /msg rootserv set logchan {on|off}
    With this setting on, Services will send its logs to a specified channel as well as the log file. LogChannel must also be defined in the Services configuration file for this setting to be of any use.
  • NOEXPIRE: /msg rootserv set noexpire {ON|OFF}
    Sets no expire mode on or off. In no expire mode, nicks, channels, akills and exceptions won't expire until the option is unset. This option is equivalent to the command-line option -noexpire.
  • READONLY: /msg rootserv set readonly {ON|OFF}
    Sets read-only mode on or off. In read-only mode, normal users will not be allowed to modify any Services data, including channel and nickname access lists, etc. IRCOps with sufficient Services privileges will be able to modify Services' AKILL list and drop or forbid nicknames and channels, but any such changes will not be saved unless read-only mode is deactivated before Services is terminated or restarted. This option is equivalent to the command-line option -readonly.
  • SUPERADMIN: /msg rootserv set superadmin {on|off}
    Setting this will grant you extra privileges such as the ability to be "founder" on all channel's etc. This option is not persistent, and should only be used when needed, and set back to OFF when no longer needed.
• SHUTDOWN: /msg rootserv shutdown
  Causes Services to save all databases and then shut down.
• SVSNICK: /msg rootserv raw SVSNICK :oldnick newnick
  Changes the nick of a user.
• USERLIST: /msg rootserv userlist {pattern|channel}[INVISIBLE]
  Lists all users currently online on the IRC network, whether their nick is registered or not. If pattern is given, lists only users that match it (it must be in the format nick!user@host). If channel is given, lists only users that are on the given channel. If INVISIBLE is specified, only users with the +i flag will be listed.
• UPDATE: /msg rootserv update
  Causes Services to update all database files as soon as you send the command.

Commands available to the Services Super Admins only:

• ADMIN: Allows the Services Root to add or remove nicknames to or from the Services admin list. A user whose nickname is on the Services admin list and who has identified to NickServ will be able to access Services admin commands. Any IRC operator may use the ADMIN LIST form of the command. All other use limited to Services Root.
  
  • ADD: /msg rootserv admin add nick
    Adds the given nickname to the Services admin list.
  • DEL: /msg rootserv admin del {nick|entry-num|list}
    Removes the given nick from the Services admin list. If a list of entry numbers is given, those entries are deleted. (See the example for LIST below.)
  • LIST: /msg rootserv admin list mask|list
    The ADMIN LIST command displays the Services admin list. If a wildcard mask is given, only those entries matching the mask are displayed. If a list of entry numbers is given, only those entries are shown; for example: /msg rootserv admin list 2-5,7-9 Lists Services admin entries numbered 2 through 5 and 7 through 9.
  • CLEAR: /msg rootserv admin clear
    The ADMIN CLEAR command clears all entries of the Services admin list.
• OLINE: /msg rootserv oline user flags
  Allows super admins to give Operflags to any user. Flags have to be prefixed with a "+" or a "-". To remove all flags simply type a "-" instead of any flags.
• SVSNICK: /msg rootserv svsnick nick newnick
  Forcefully changes a user's nickname from nick to newnick.
• UMODE: /msg rootserv umode user modes
  Allows super admins to set user modes for any user. Parameters are the same as for the standard /mode command.

Commands available to the Services Root Admins only:

• MODINFO: /msg rootserv modinfo filename
  This command lists information about the specified loaded module.
• MODLIST: /msg rootserv modlist
  Lists all currently loaded modules.
• MODLOAD: /msg rootserv modload filename
  This command loads the module named FileName from the modules directory.
• MODUNLOAD: /msg rootserv modunload filename
  This command unloads the module named FileName from the modules directory.

The following commands have been loaded by a module:

• MKILL: /msg rootserv mkill nick!ident@host or #channel reason
  Allows opers to forcefully disconnect multiple users via RootServ. A reason is not mandatory, however it is often useful for you put a valid one. Note: only the first 1024 users matching the pattern will be killed if a non-channel pattern is given. This command will NOT kill any opered clients
• QAKILL: /msg rootserv qakill nick reason
  Allows Services Admins to add an akill with just a nick. A reason is not mandatory, however it is often useful for you put a valid one. The akill placed will be in the form *@full.host.mask for the default AKILL expiry time. You will not be able to QAKILL identified services admins or services roots unless you are a services root.