** DarkFire IRCd **

Oper Manual
Updated 01/24/2004 (df-1.3.7) by dave

This document describes the special features of DarkFire IRCd for IRC
Operators. This document does not describe services related commands,
policy, or anything else regarding how to be an IRCop.

Table of Contents
=================
Ch. 1	Setting o:line flags
Ch. 2	Operator Modes
Ch. 3	Basic Operator Commands
	.......	OPER
	....... REHASH
	....... KILL, RKILL, FQUIT
	....... HUSH, UNHUSH
	....... MKILL
	....... KLINE, UNKLINE
	....... ZLINE, UNZLINE
	....... CONNECT
	....... SQUIT
	....... TRACE
	....... CLOSE
	....... HASH, DNS
	....... LOCOPS
Ch. 4	Operator Commands for Globals Only
	....... WALLOPS
	....... GLOBOPS, GNOTICE
	....... CHATOPS
	....... ALLOW
Ch. 5	Super Operator Commands
	....... DVS
Ch. 6	Services Administrator Commands
	....... SAJOIN
	....... UNBANME
	....... WKILL
	....... SAMODE
	....... AKILL
	....... GOPER
Ch. 7	Server Administrator Commands
	....... RESTART
	....... DIE
	....... SET
	....... QOTD

Chapter 1: Setting o:line flags
===============================

Basic o:line syntax...
O:[user@]host:password:opernick:flags:class

The basic oper flags ("levels"):
m	Oper can set oper modes (see Ch. 2)
o	Oper can do local operator commands (includes m)
O	Oper can do global operator commands (include mo)

Additional oper flags (none are inclusive):
r	Oper can remotely kline/rehash
S	Super priveleges (flood exemption, services override w/ SA)
a	Services Administrator (can set +a, use /akill, /sajoin, /samode,
	/unbanme -- /akill and /samode can only be used when services is
	online if the oper has "Super Privleges" (oflag S)
A	Server Administrator (can set +A, use /set, /die, /restart, /qotd)

Wildcard:
*	Includes moOr but not SAa
	A full o:line is SAa*

Chapter 2: Operator Modes
=========================

When a client uses /oper, they receive umode +o if they are a global IRCop or
umode +O if they are a local IRCop. Operators without either global or local
priveleges receive no mode (i.e., o:lines with only the 'm' flag)

If the oper is global/local, the following modes are automatically added:
s	Receive server notices (not an oper-only mode)
w	Can receive (and send) wallops (not an oper-only mode)
g	Can receive (and send) globops/locops (whichever is appropriate)
b	Can send/receive chatops
k	Can see kills (not an oper-only mode)

If the oper has the modes flag (or local/global), the following are added:
u	Can see hush notices
f	Can see flood notices

An oper with the modes flag can also set:
c	See clients connecting/disconnecting locally

If the oper has the Admin and/or Services Admin flag, the apppropriate umodes
are also given (+A and/or +a respectively).

Chapter 3: Basic Operator Commands
==================================

OPER
----
Syntax: /oper <user> <password>
Access operator privleges.

REHASH
------
Syntax: /rehash
Rehash local server configuration file (ircd.conf) and remove any temporary
lines (including temp klines, zlines, and akills).

Syntax: /rehash <server> [Limit to GLOBAL w/ REMOTE flag]
Rehash a remote server.

KILL, RKILL, FQUIT
------------------
Syntax: /kill <nick> <reason>
Syntax: /rkill <nick> <reason>
Syntax: /fquit <nick> <reason>

Note: <nick> may be a list of nicks in the form of nick1,nick2,nick3,etc.

Kill is the preferred method for removing a client from the network. It sends
a message to the server in which the client resides and then that server sends
a QUIT message. Fquit and rkill (an alias) force a user to quit. In other
words, rather than waiting for a quit, once the FQUIT message is received the
client is disconnected.

Note: Local Operators cannot kill remote clients.

HUSH, UNHUSH
------------
Syntax: /hush <nick> <time in seconds> <reason>
Syntax: /unhush <nick>

Severely limit a client's ability to use IRC for a given period of time. A
time of 0 implies an indefinite hush.

Note: Local Operators cannot hush remote clients.

MKILL
-----
Syntax: /mkill <nick>
Syntax: /mkill <mask>

Kill all clients with the same hostname as <nick>. If <mask> is supplied, find
the first client that matches the mask and kill all clients with that host.

For a better mass kill function, see the WKILL command in the Services Admin
section.

Note: Local Operators cannot kill remote clients.

KLINE, UNKLINE
--------------
Syntax: /kline <nick> :<reason>
Syntax: /kline <mask> :<reason>
Syntax: /unkline <mask>

Add/remove a temporary Kill Line for a mask (giving <nick> simply creates the
best mask). Clients cannot connect if their mask matches a kill line.

Syntax: /kline <nick or mask>:<server> :<reason>
Syntax: /kline <nick or mask>:<server> [Limit both to GLOBAL w/ REMOTE flag]

Kline/unkline remotely.

ZLINE, UNZLINE
--------------
Essentially the same as k:line but works based on IPs.

CONNECT
-------
Syntax: /connect <server> [<port>]

Attempt to establish a connection to a server (using the given remote port if
specified).

Syntax: /connect <server> <port> <remote server> [Limit to GLOBAL]

Have <remote server> attempt to connect to <server> on <port>.

SQUIT
-----
Syntax: /squit <server>

Disconnect a server. Only GLOBAL IRCops can disconnect remote servers.

TRACE
-----
Syntax: /trace [<server or nick>]

Show all local clients, or do the same for the specified <server> or the
server with <nick> as a local client.

CLOSE
-----
Syntax: /close

Close all unknown, connecting, and handshaking connections.

HASH, DNS
---------
Syntax: /hash
Syntax: /dns

Debugging commands.

LOCOPS
------
Syntax: /locops <message>

Send a message to all Local Operators on the same server with umode +g.

Chapter 4: Operator Commands for Globals Only
=============================================

WALLOPS
-------
Syntax: /wallops <message>

Send a message to all +w users. Regular users can set +w but cannot send out
wallops.

GLOBOPS, GNOTICE
----------------
Syntax: /globops <message>
Syntax: /gnotice <message> (Alias for globops)

Send a message to all Global Operators with umode +g.

CHATOPS
-------
Same as GLOBOPS, except uses umode +b. Generally used for more social messages.

ALLOW
-----
Syntax: /allow <nick>

Allow a client to use the network despite being DVS Protected. This client
would otherwise have to identify to a nickname or become a Global IRCop.

Chapter 5: Super Operator Commands
==================================

DVS
---
Syntax: /dvs <LOCK|UNLOCK>
Syntax: /dvs <LEVEL> [<LOCK|UNLOCK>]

The first syntax toggles the DVSLock status (if DVSLock is on, DVS is still
enabled when services is offline).

The second syntax changes the DVS Status level. <LEVEL> must be an integer
of either 0, 1, 2, or 3. The lock status may also be changed in one command.

Chapter 6: Services Administrator Commands
==========================================

SAJOIN
------
Syntax: /sajoin <channel>

This command allows an SA to forcably join a channel. If the SA would have
otherwise been allowed to join, no notice is sent. If the SA would have been
prevented from joining (banned, limit, key, etc.), a global notice is sent.

SAJOIN cannot be used on channels with mode +S (NOSAJOIN, this can only be set
by ULined servers).

UNBANME
-------
Syntax: /unbanme <channel>

This command (essentially /rmban) allows an SA to have all bans matching his
host/ip be removed from a channel's banlist without being an op or even in the
channel.

WKILL
-----
Syntax: /wkill <who pattern> <reason>

This command kills all users matching the given <who pattern>. It uses the same
syntax as the /who command (See /who ? for more information).

This command will never kill IRCops and cannot be used on channels with mode +S
(NOSAJOIN, this can only be set by ULined servers).

SAMODE
------
Syntax: /samode <channel> <mode>

Changes a mode on a channel.

Note: this command can only be used while services is online if the SA also    
has "Super Privileges". Please use /os mode instead.

AKILL
-----
Syntax: /akill <user@host> <time in seconds> :<reason>

Add an expiring autokill.

Note: this command can only be used while services is online if the SA also
has "Super Privileges". Please use /os akill instead.

GOPER
-----
Syntax: /goper <message>

Send a message to ALL +o clients.

Chapter 7: Server Administrator Commands
========================================

RESTART
-------
Syntax: /restart [<password>]

Restart the IRCd. A password is only necessary if there is an X: line in the
ircd.conf.

DIE
---
Syntax: /die [<password>]

Shutdown the IRCd. A password is only necessary if there is an X: line in the
ircd.conf.

SET
---
Syntax: /set
Syntax: /set <option> <value>

Allows runtime configuration of variables that previously required a compile
to change. Use /set to see a list of options and current values. Be careful.

QOTD
----
Syntax: /qotd [<message>]

This commands sets the Quote of the Day (no <message> means delete) which is
displayed at the end of every /motd request. This can be no longer than the
length of a topic (307 chars).