This page was updated in 08/29/04

Operserv
  • HELP
     
     OperServ commands:
         GLOBAL      Send a message to all users
         STATS       Show status of Services and network
         OPER LIST   List all Services operators
         ADMIN LIST  List all Services admins
         STAFF       Display Services staff and online status
    
    
  • GLOBAL
     
     Syntax: /msg OperServ  GLOBAL message
     
     Allows IRCops to send messages to all users on the network.
     The message will be sent from the nick OperServ.
    
    
  • STATS
     
     Syntax: /msg OperServ  STATS [AKILL | ALL | RESET]
     
     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.
     
     With the AKILL option, displays the current size of the
     AKILL list and the current default expiry time.
     
     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!
     
     The RESET option currently resets the maximum user count
     to the number of users currently present on the network.
     
     UPTIME may be used as a synonym for STATS.
    
    
  • OPER
     
     Syntax: /msg OperServ  OPER ADD nick
             OPER DEL {nick | entry-num | list}
             OPER LIST [mask | list]
             OPER CLEAR
     
     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
     OperServ will be able to access Services operator commands.
     
     The OPER ADD command adds the given nickname to the
     Services operator 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.)
     
     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:
    
        OPER LIST 2-5,7-9
           Lists Services operator entries numbered 2 through 
           5 and 7 through 9.
           
     The OPER CLEAR command clears all entries of the
     Services operator list.
     
     Any IRC operator may use the OPER LIST form of the command.
     All other use limited to Services admins.
    
    
  • ADMIN
     
     Syntax: /msg OperServ  ADMIN ADD nick
             ADMIN DEL {nick | entry-num | list}
             ADMIN LIST [mask | list]
             ADMIN CLEAR
     
     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
     OperServ will be able to access Services admin commands.
     
     The ADMIN ADD command adds the given nickname to the
     Services admin list.
     
     The ADMIN DEL command 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.)
     
     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:
    
        ADMIN LIST 2-5,7-9
           Lists Services admin entries numbered 2 through 
           5 and 7 through 9.
           
     The ADMIN CLEAR command clears all entries of the
     Services admin list.
     
     Any IRC operator may use the ADMIN LIST form of the command.
     All other use limited to Services root.
    
    
  • IGNORE
     
     Syntax: /msg OperServ  IGNORE {ADD|DEL|LIST|CLEAR} [time] [nick]
    
     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.
    
    
  • MODE
     
     Syntax: /msg OperServ  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.
    
    
  • UMODE
     
     Syntax: /msg OperServ  UMODE user modes
     
     Allows Services admins to set user modes for any user.
     Parameters are the same as for the standard /MODE
     command.
     
     Limited to Services admins.
    
    
  • OLINE
     
     Syntax: /msg OperServ  OLINE user flags
     
     Allows Services 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.
    
     Limited to Services admins.
    
    
  • CLEARMODES
     
     Syntax: /msg OperServ  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
     
     Syntax: /msg OperServ  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 OperServ (Alcan (Flood))
     
     Limited to Services operators.
    
    
  • AKILL
     
     Syntax: /msg OperServ  AKILL ADD [+expiry] mask reason
             AKILL DEL {mask | entry-num | list}
             AKILL LIST [mask | list]
             AKILL VIEW [mask | list]
             AKILL CLEAR
     
     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.
     
     AKILL ADD adds the given user@host/ip 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
     STATS AKILL command.
     
     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.)
     
     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:
    
        AKILL LIST 2-5,7-9
           Lists AKILL entries numbered 2 through 5 and 7 
           through 9.
           
     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/ip mask and reason.
     
     AKILL CLEAR clears all entries of the AKILL list.
     
     Limited to Services operators.
     
    
  • SGLINE
     
     Syntax: /msg OperServ  SGLINE ADD [+expiry] mask:reason
         SGLINE DEL {mask | entry-num | list}
             SGLINE LIST [mask | list]
             SGLINE VIEW [mask | list]
             SGLINE CLEAR
     
     Allows Services operators to manipulate the SGLINE list.  If
     a user with a realname matching an SGLINE mask attempts to 
     connect, Services will not allow it to pursue his IRC
     session.
     
     SGLINE ADD adds the given realname mask to the SGLINE
     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 SGLINE which does not expire, use +0.  If the
     realname mask to be added starts with a +, an expiry time must
     be given, even if it is the same as the default.  The
     current SGLINE default expiry time can be found with the
     STATS AKILL command.
     Note: because the realname mask may contain spaces, the
     separator between it and the reason is a colon.
     
     The SGLINE DEL command removes the given mask from the
     SGLINE list if it is present.  If a list of entry numbers is 
     given, those entries are deleted.  (See the example for LIST 
     below.)
     
     The SGLINE LIST command displays the SGLINE 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:
    
        SGLINE LIST 2-5,7-9
           Lists SGLINE entries numbered 2 through 5 and 7 
           through 9.
           
     SGLINE VIEW is a more verbose version of SGLINE LIST, and 
     will show who added an SGLINE, the date it was added, and when 
     it expires, as well as the realname mask and reason.
     
     SGLINE CLEAR clears all entries of the SGLINE list.
     
     Limited to Services operators.
    
    
  • SQLINE
     
     Syntax: /msg OperServ  SQLINE ADD [+expiry] mask:reason
             SQLINE DEL {mask | entry-num | list}
             SQLINE LIST [mask | list]
             SQLINE VIEW [mask | list]
             SQLINE CLEAR
     
     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).
     
     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
     STATS AKILL command.
     
     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.)
     
     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:
    
        SQLINE LIST 2-5,7-9
           Lists SQLINE entries numbered 2 through 5 and 7 
           through 9.
           
     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.
     
     SQLINE CLEAR clears all entries of the SQLINE list.
     
     Limited to Services operators.
    
    
  • SZLINE
     
     Syntax: /msg OperServ  SZLINE ADD [+expiry] mask reason
             SZLINE DEL {mask | entry-num | list}
             SZLINE LIST [mask | list]
             SZLINE VIEW [mask | list]
             SZLINE CLEAR
     
     Allows Services operators to manipulate the SZLINE list.  If
     a user with an IP matching an SZLINE mask attempts to 
     connect, Services will not allow it to pursue his IRC
     session (and this, whether the IP has a PTR RR or not).
     
     SZLINE ADD adds the given IP mask to the SZLINE
     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 SZLINE which does not expire, use +0.  If the
     realname mask to be added starts with a +, an expiry time must
     be given, even if it is the same as the default.  The
     current SZLINE default expiry time can be found with the
     STATS AKILL command.
     
     The SZLINE DEL command removes the given mask from the
     SZLINE list if it is present.  If a list of entry numbers is 
     given, those entries are deleted.  (See the example for LIST 
     below.)
     
     The SZLINE LIST command displays the SZLINE 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:
    
        SZLINE LIST 2-5,7-9
           Lists SZLINE entries numbered 2 through 5 and 7 
           through 9.
           
     SZLINE VIEW is a more verbose version of SZLINE LIST, and 
     will show who added an SZLINE, the date it was added, and when
     it expires, as well as the IP mask and reason.
     
     SZLINE CLEAR clears all entries of the SZLINE list.
     
     Limited to Services operators.
    
    
  • SET
     
     Syntax: /msg OperServ  SET option setting
    
     Sets various global Services options.  Option names
     currently defined are:
         READONLY   Set read-only or read-write mode
         LOGCHAN    Report log messages to a channel
         DEBUG      Activate or deactivate debug mode
         NOEXPIRE   Activate or deactivate no expire mode
         SUPERADMIN Activate or deactivate super-admin mode
    
     Limited to Services admins.
    
    
  • SET READONLY
     
     Syntax: /msg OperServ  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.
    
    
  • SET LOGCHAN
     
     Syntax: /msg OperServ  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.
    
     Note: This can have strong security implications if your log
     channel is not properly secured.
    
    
  • SET DEBUG
     
     Syntax: /msg OperServ  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.
    
    
  • SET NOEXPIRE
     
     Syntax: /msg OperServ  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.
    
    
  • SET SUPERADMIN
     
     Syntax: /msg OperServ  SET SUPERADMIN {ON | OFF}
    
     Setting this will grant you extra privlages such as the
     ability to be "founder" on all channel's etc...
    
     This opion is not persistant, and should only be used when
     needed, and set back to OFF when no longer needed.
    
    
    
  • NOOP
     
     Syntax: /msg OperServ  NOOP SET server
             NOOP REVOKE server
    
     NOOP SET 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).
    
     NOOP REVOKE makes all removed O:lines available again
     on the given server.
    
     Note: The server is not checked at all by the
     Services.
     
     Limited to Services admins.
    
    
  • JUPE
     
     Syntax: /msg OperServ  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.
     
     Limited to Services admins.
    
    
  • RAW
     
     Syntax: /msg OperServ  RAW text
     
     Sends a string of text directly to the server to which
     Services is connected.  This command has a very limited
     range of uses, and can wreak havoc on a network if used
     improperly.  DO NOT USE THIS COMMAND unless you are
     absolutely certain you know what you are doing!
     
     Limited to Services admins.
    
    
  • UPDATE
     
     Syntax: /msg OperServ  UPDATE
     
     Causes Services to update all database files as soon as you
     send the command.
     
     Limited to Services admins.
     
    
  • RELOAD
     
     Syntax: /msg OperServ  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.)
     
     Limited to Services admins.
    
    
  • QUIT
     
     Syntax: /msg OperServ  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.
     
     Limited to Services admins.
    
    
  • SHUTDOWN
     
     Syntax: /msg OperServ  SHUTDOWN
     
     Causes Services to save all databases and then shut down.
     
     Limited to Services admins.
    
    
  • RESTART
     
     Syntax: /msg OperServ  RESTART
     
     Causes Services to save all databases and then restart
     (i.e. exit and immediately re-run the executable).
     
     Limited to Services admins.	
    
    
  • KILLCLONES
     
     Syntax: /msg OperServ  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 usefull for removing numerous 
     clones from the network.
    
     Limited to Services operators.
     
    
  • CHANLIST
     
     Syntax: /msg OperServ  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.
     
     Limited to Services admins.
    
    
  • USERLIST
     
     Syntax: /msg OperServ  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.
     
     Limited to Services admins.
    
    
  • CACHE
     
     Syntax: /msg OperServ  CACHE DEL hostname
             CACHE LIST pattern [QUEUED | ALL]
     
     The CACHE DEL command deletes the specified hostname from 
     the cache. This is meant for debug purpose only.
    
     The CACHE LIST command 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.
     
     Limited to Services admins.
    
    
  • EXCEPTION
     
     Syntax: /msg OperServ  EXCEPTION ADD [+expiry] mask limit reason
             EXCEPTION DEL {mask | list}
             EXCEPTION MOVE num position
             EXCEPTION LIST [mask | list]
             EXCEPTION VIEW [mask | list]
     
     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 OperServ, of a source of help regarding session
     limiting. The content of this notice is a config setting.
     
     EXCEPTION ADD 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.
     EXCEPTION DEL removes the given mask from the exception list.
     EXCEPTION MOVE moves exception num to position. The
     exceptions inbetween will be shifted up or down to fill the gap.
     EXCEPTION LIST and EXCEPTION VIEW show all current
     exceptions; if the optional mask is given, the list is limited
     to those exceptions matching the mask. The difference is that
     EXCEPTION VIEW is more verbose, displaying the name of the
     person who added the exception, it's session limit, reason, 
     host mask and the expiry date and time.
     
     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.
     
     Limited to Services admins.
    
    
  • SESSION
     
     Syntax: /msg OperServ  SESSION LIST threshold
             SESSION VIEW host
     
     Allows Services admins to view the session list.
    
     SESSION LIST lists hosts with atleast 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.
     SESSION VIEW displays detailed information about a specific
     host - including the current session count and session limit.
     The host value may not include wildcards.
    
     See the EXCEPTION help for more information about session
     limiting and how to set session limits specific to certain
     hosts and groups thereof.
     
     Limited to Services admins.
    
    
  • CHANKILL
     
     Syntax: /msg OperServ  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. 
    
    
    
  • DEFCON
     
     Syntax: /msg OperServ  DEFCON [1|2|3|4|5]
    
     The defcon system can be used to implement a pre-defined
     set of restrictions to services useful during an attemtped
     attack on the network.
    
    
  • DEFCON AKILL NEW CLIENTS
     
     * AKILL any new clients connecting
    
  • DEFCON FORCE CHAN MODES
     
     * Force Chan Modes (OperServ) to be set on all channels
    
  • DEFCON NO MLOCK CHANGE
     
     * No MLOCK changes
    
  • DEFCON NO NEW CHANNELS
     
     * No new channel registrations
    
  • DEFCON NO NEW CLIENTS
     
     * Kill any NEW clients connecting
    
  • DEFCON NO NEW MEMOS
     
     * No new memos sent
    
  • DEFCON NO NEW NICKS
     
     * No new nick registrations
    
  • DEFCON ONLY
     
     * Ignore any non-opers with message
    
  • DEFCON REDUCE SESSION
     
     * Use the reduced session limit of <num>
    
  • DEFCON SILENT ONLY
     
     * Silently ignore non-opers
    
  • LOGGED
     
     Notice: All commands sent to OperServ are logged!
    
    
  • MODINFO
     
     Syntax: /msg OperServ  MODINFO FileName
    
     This command lists information about the specified loaded module
    
     Limited to Services Roots.
    
    
  • MODLIST
     
     Syntax: /msg OperServ  MODLIST
    
     Lists all currently loaded modules.
    
     Limited to Services Roots.
    
    
     
    
  • MODLOAD
     
     Syntax: /msg OperServ  MODLOAD FileName
    
     This command loads the module named FileName from the modules
     directory.
    
     Limited to Services Roots.
    
    
  • MODUNLOAD
     
     Syntax: /msg OperServ  MODUNLOAD FileName
    
     This command unloads the module named FileName from the modules
     directory.
    
     Limited to Services Roots.
    
    
  • SVSNICK
     
     Syntax: /msg OperServ  SVSNICK nick newnick
     
     Forcefully changes a user's nickname from nick to newnick.
     
     Limited to Services admins