$Revision: 2.4 $
$Date: 2010/01/12 22:49:57 $
$Author: avenj $
This file is a work-in-progress operator guide for blackcobalt.net/oppresses.us server operators.
Check back for updates (RCS revision tag available in the header above)
This file is specific to the hacked-up hybrid7.2 used by blackcobalt.net.
ircd-hybrid is a very stable, fast, powerful ircd; we also use OFTC's modifications (oftc1.6.7), including UMODE_GOD, +S SSL-only channels, +P services protected mode, etc, and our own patchset.
+w +z +l +s +c +u +r +k +f +y +n +x +b +S +g/G
/OPER opername passwd
Login as an operator.
/WHO ?
Noted here because /WHO is extremely powerful on oftc-hybrid.
It is not, strictly speaking, an oper command, but it is a very useful part of the operator toolset.
The extended /WHO functionality is described fully in /WHO ?
Also see: /QUOTE HELP WHO and /WHO ?
/KILL client reason
Terminate a client's connection to the network.
/KLINE [expiry in minutes] user@host :reason
Hostmask ban on your local server.
KLINE is very flexible on hybrid7.
You can issue a ban to your local server, a designated server, or use wildcards (*)
Expiry times are in minutes.
Reason must be prefixed with a : (colon)
Please include your nickname when adding a KLINE (or XLINE)!
Ban on your local server:
/KLINE [expiry] user@host :reason
Ban on a specified server:
/KLINE [expiry] user@host ON server :reason
Ban across all servers accepting remote klines:
/KLINE [expiry] user@host ON * :reason
Example 24-hr local ban:
/KLINE 1440 *joe@*.ca.isp.net :Abuse (avenj)
Example 24-hr global ban:
/KLINE 1440 *joe@ma-*.zomgfastinet.com ON * :Troll (avenj)
Example permanent global ban:
/KLINE *joe@*.ca.isp.net ON * :Repeat offender (avenj)
List temporary KLINES:
/STATS k
List permanent KLINES:
/STATS K
Remove a KLINE:
/UNKLINE *joe@*.ca.isp.net
Remove a global KLINE:
/UNKLINE *joe@*.ca.isp.net ON *
Also see: /QUOTE HELP KLINE and kline.txt
/XLINE [expiry] gecos :reason
GECOS (realname) ban.
Places a ban based on the realname field, also known as GECOS (viewable via /WHOIS)
Syntax is essentially the same as KLINE and wildcards are acceptable.
This is especially useful for banning webchat users.
Generally the web clients used on blackcobalt share a common hostmask.
However, the real hostname or IP is available in the GECOS field.
Add a global XLINE:
/XLINE *JoeMomma* ON * :Troll (avenj)
Remove a global XLINE:
/UNXLINE *JoeMomma* ON *
Also see /QUOTE HELP XLINE
Deprecated. Local-only IP bans. See /QUOTE HELP DLINE
24-hr global ban, deprecated on blackcobalt (our servers accept remote klines)
GLINE is generally less flexible than KLINE and should be avoided.
It should be unnecessary unless attempting to apply a ban to a misconfigured server.
The RKLINE, RDLINE, and RXLINE commands allow for regular expression use in bans.
They share the same syntax as their non-regexp counterparts.
If you don't know what 'regular expression' means, you probably shouldn't be using regexp bans.
/SQUIT server :[reason]
Disconnect a server.
Usually only used in the course of re-routing.
Disconnect eris:
/SQUIT eris.* :re-hubbing oppresses.us
Also see /CONNECT
/CONNECT server
Link a server to the local server or a hub.
Link a server to the local server:
/CONNECT server
Link a server on a specified port:
/CONNECT server [port]
Remote connect (port 0 = use default port):
/CONNECT serverA 0 hubA
Examples:
eris.oppresses.us (hub) splits from ircd.blackcobalt.net (hub)
Local connect from oper on eris:
/CONNECT ircd.blackcobalt.net
Local connect from oper on ircd:
/CONNECT eris.*
Remote connects ask hubA to connect to serverA on the specified port.
Remote connect from oper on typhon (a leaf of eris):
/CONNECT ircd.blackcobalt.net 0 eris.*
Also see routing.txt, /MAP, /STATS c
/OJOIN #channel
Join past modes.
OJOIN is deprecated on blackcobalt and the module is optional.
You should probably just use OperServ or UMODE_GOD
/OPME #channel
Only usable on opless channels and optional for bc servers.
You should probably just use OperServ or UMODE_GOD
/mode myself +S
Allows walking past modes and opless mode changes.
Use with care!
If at all possible, use OperServ MODE instead
/WALLOPS message
Sends a message to all umode +w users and operators.
/OPERWALL :message
Sends a message to all umode +z operators (the colon before the message isn't a typo)
/NOTICE target message
NOTICE is very flexible on hybrid7.
See /QUOTE HELP NOTICE for information on all of them.
Our primary use on blackcobalt is server notices.
Network-wide noticing can be done via OperServ GLOBAL
Send a notice to all users on a specific server:
/NOTICE $$irc.myserver.com Server restarting in 5mins
Send a notice to all servers on a specific domain or TLD:
/NOTICE $$*.oppresses.us oppresses.us reroutes coming up
Also see /QUOTE HELP NOTICE and OperServ GLOBAL
Server information. Very powerful.
See /QUOTE HELP STATS, especially K, k, x, q, c
/TRACE [user|server]
Displays a trace for either the specified user or server.
Useful for figuring out where traffic is being routed.
/MAP
Shows the layout of the network, relative to the local server.
Unlike LINKS, MAP is always current.
Also see routing.txt and OperServ SERVERMAP
/OPERSPY WHOIS nickname
/OPERSPY WHO nickname|channel
/OPERSPY LIST
/OPERSPY NAMES #channel
Allows operators to see past umode +i (invis) and cmode +s (secret)
UMODE_SPY (operspy/umode +y)
Operspy is also a umode (+y).
+y operators can see full NAMES listings, user modes (via local whois), complete WHOIS info, etc.
Additionally, they receive a lot of useful verbose server notices.
Mode of these modes are set by default upon /OPER
+w - View WALLOPS
+z - View OPERWALL
+l - View LOCOPS
+s - View server notices (SNOTICE)
+c - View client connections
+u - View unauthorized client notices
+r - View rejected client notices
+k - View server kill notices
+f - View "I-line is full" notices
+y - "Spy" umode, view STATS/LINKS/TRACE/WHOIS etc
+n - View nickname changes
+x - View server split/rejoin notices
+b - View bot/flood warnings
+S - UMODE_GOD
+G - CALLERID. See modeg.txt
Also see /QUOTE HELP UMODE and modes.txt
Incomplete, see /OperServ HELP COMMANDS
As a matter of policy AKILL may be (at your discretion) used instead of KLINE.
Same is true of SGLINE vs. XLINE.
This is useful for preserving long-term lines, as they will also be applied to new servers.
The obvious downside is that if services are missing futurely, unapplied AKILL/SGLINE entries are useless.
SQLINE is preferred over remote RESV (and should be used very sparingly)
All commands can be used via your choice of:
/msg OperServ
/OperServ
/OS
/OS GLOBAL message
Sends a global notice to all users on the network.
Primarily used for announcing server/services downtime.
Please sign your global notices with your nickname.
Also see /NOTICE
/OS SERVERMAP
Displays a /MAP as viewed from the utility server.
/OS SESSION LIST threshold
/OS SESSION VIEW host
View session information for users with at least THRESHOLD sessions, or matching HOST
/OS MODE #channel modes
Changes modes on specified channel. Preferred over UMODE_GOD if possible.
/OS CLEARMODES #channel
Clears all modes from a channel. Does NOT override MLOCK.
If "ALL" is specified, +o +v +h will also be cleared.
/OS CLEARCHAN #channel
Masskick, clears all users from a channel.
/OS AKILL ADD [+expiry] mask reason
Kills anyone with the specified mask.
Kills them again upon connect.
Issues a KLINE to servers accepting them.
+0 expiry time is a permanent AKILL
Also see /OS HELP AKILL
/OS KILLCLONES nickname
Kill anyone with the same hostname as the specified user.
Also adds a temporary AKILL to prevent immediate reconnect.
/OS SGLINE ADD [+expiry] gecos reason
Roughly equivalent to a global XLINE.
Users matching the GECOS (realname) mask specified will be killed.
A global XLINE will be sent for the mask.
Also see /OS HELP SGLINE
/OS SQLINE ADD [+expiry] nickname reason
Roughly equivalent to (and preferred over) a global RESV.
Users matching the specified nickname mask will be killed.
A global RESV will be sent for the nickname.
Also see /OS HELP SQLINE
Manipulate the session exception list.
We use ridiculously high session limits on blackcobalt.
It is unlikely that exceptions will be needed.
/OS HELP EXCEPTION