Log in | Back to darenet.org

Server Features

(New page: <pre> Many of the old compile-time options are now configured through the server configuration file, ircd.conf. This file is intended to document each of these features. Logging, althoug...)
Line 1,656: Line 1,656:
Allow this server to act upon a network-issued /die.
Allow this server to act upon a network-issued /die.
</pre>
</pre>
 +
 +
[[Category:Technical]]

Revision as of 03:04, 25 April 2008

Many of the old compile-time options are now configured through the
server configuration file, ircd.conf.  This file is intended to
document each of these features.  Logging, although also configured
through the use of F-lines, is documented in doc/readme.log.  NOTE
THAT THESE NAMES ARE CASE SENSITIVE!  Values are not case sensitive
unless stated otherwise in the documentation for that feature.

DOMAINNAME
 * Type: string
 * Default: picked by ./configure from /etc/resolv.conf

This option allows you to specify what you consider to be "local."  It
is only used for statistics.  When you issue the IRC command /STATS w,
the server will respond with statistics of how many clients have been
connecting to your server in the last minute, hour and day.  It will
give these statistics for all connections (including the servers), all
clients (from anywhere) and also for clients whose hostname ends on
the domain you specify here.  So if you are an ISP and you want to
know what the client load from your own domain is, specify that domain
here.  If you are unsure what to do, then it isn't really important
what you give here, just don't give an empty string.  A good guess is
the last two parts of your own hostname (i.e., if your hostname is
foo.bar.nowhere.org, specify "nowhere.org").  Note that the string you
give should NOT start with a "." and you should not use quotes.

RELIABLE_CLOCK
 * Type: boolean
 * Default: FALSE

You should really ONLY specify "TRUE" here when your system clock is
stable and accurate at all times (within a few seconds).  If you are
running ntpdate on a regular basis, or an equivalent like xntpd, to
keep your system clock synchronized over the network, then you might
have an accurate clock.  However, this is not guaranteed; for example,
it is known that xntpd gives unstable results on Linux in some cases.
Note that an unstable clock is worse then an clock that has a constant
offset, because the servers attempt to correct for a constant offset,
but do not correct jumps of your system clock!  In general you SHOULD
be running ntpdate or equivalent AND make sure it works when you run a
production server on Undernet.  Otherwise leave your clock alone and
specify "FALSE" here.  If unsure specify "FALSE"!

BUFFERPOOL
 * Type: integer
 * Default: 27000000

This specifies the maximum amount of RAM that your server will
allocate for buffering sendQs.  Small leafs can use a value as little
as 1000000, while large HUBs need to specify a value as high as
20000000.  If you run out of memory, clients and/or servers are
dropped with the error "Buffer allocation error"; then you will have
to increase this number (and install more RAM if appropriate).  If you
want a more educated guess for this value then realize that any value
is good if you _really_ would rather drop servers and clients than
allocate more memory; this will be the case when there is the danger
you may run out of memory for other allocations.  Even if you run the
daemon on a dedicated machine, specifying all of the RAM you have is a
bad thing, because running out of memory is a lot worse than dropping
clients in a controlled way; if possible you should have memory left
for all the internal structures (channels, clients, ban lists, receive
buffers) at all times.  On average, clients seem to use 150 bytes of
sendQ, but at peak moments this can easily increase to 2032 bytes per
client (sendQs are allocated in chunks of 2032 bytes).  The maximum
possible amount that can be allocated for sendQs is the number of
connected clients times whatever you specified as the maximum sendQ in
your Y: lines in the ircd.conf file.  That value will likely be larger
then the amount of RAM you have.  The educated guess I talked about
earlier would be "number of clients" times * 2048 bytes + "size of
net.burst" * n, where "n" is 1 for leafs and up to 5 for HUBs.  The
"size of net.burst" is about 125 bytes per online client (on the whole
network).  For large HUBs with 4000 clients on a network with 30,000
users, this results in 27 Mb.  Leafs could use 12 Mb.  Of course you
can use less when you have less than 4000 local clients.  This value
is in bytes.

HAS_FERGUSON_FLUSHER
 * Type: boolean
 * Default: FALSE

If you have a server with a lot of resources available, this option
will cause the server to attempt to flush its internal buffers before
dropping clients during a net break.  Don't define this if you don't
know for certain; if you're not careful this can end up rebooting
FreeBSD boxes.  For more information, refer to freebsd.txt, also in
this directory.

CLIENT_FLOOD
 * Type: integer
 * Default: 1024

Currently, everything that a client sends to a server is read by the
server and stored in a buffer (the clients receive queue).  The server
will process messages from this queue one by one (running over all
clients each time).  When a client sends new messages faster they get
processed, and the size of its receive buffer reaches this value, the
client is dropped with the error "Excess flood."  A reasonable value
is 1024 bytes.  The maximum size is 8000 bytes.

SERVER_PORT
 * Type: integer
 * Default: 4400

When an IRC operator attempts a connect to another server, he or she
may not know which port the connect should go to.  In this server
version, that operator may use the special port 0, in which case the
server will take the port from the C-line.  If no port is specified in
the C-line, however, the port specified by this option will be used
instead.

NODEFAULTMOTD
 * Type: boolean
 * Default: TRUE

Every time a client connects to your server, the full Message of the
Day (as specified by the T-lines or by the file specified by the MPATH
option) is sent to the client.  The server sends the Message of the
Day even though many clients permit the user to ignore it.  Many users
never read the message of the day anyway, making it a huge waste of
bandwidth.  If you specify "TRUE" here, then the server won't send the
MOTD to the client by default; instead, it will only tell the client
when the MOTD was last changed, and give instructions on how to obtain
it by typing /MOTD.

MOTD_BANNER
 * Type: string
 * Default: NULL

If you enable NODEFAULTMOTD, this specifies a one-line banner to be sent
to the client in addition to the instructions mentioned above.

REMOTE_MOTD
 * Type: boolean
 * Default: FALSE

Controls the use of remote message of the day's.
PROVIDER
 * Type: string
 * Default: NULL

This string as added to the 001 numeric prefixed with "via" before the nick.
It's used for providing promotional space to providers as per CFV-202

GEO_LOCATION
 * Type: string
 * Default: NULL

This string as added to the 003 numeric. It's used for providing the location of
the server, eg "Staunton, MI, United States"

KILL_IPMISMATCH
 * Type: boolean
 * Default: FALSE

When a client connects to your server, the IP address of the client is
reverse-resolved to obtain a hostname.  Then that hostname is resolved
to an IP address and compared with the IP address of the client.  If
they don't match, the client will appear with the IP address instead
of the hostname, unless KILL_IPMISMATCH is "TRUE," in which case the
client is simply disconnected.

IDLE_FROM_MSG
 * Type: boolean
 * Default: TRUE

The IRC command WHOIS gives an idle time for clients.  If you want
this idle time to be set to zero only when the client sends a PRIVMSG,
then you should specify "TRUE" here.  If you specify "FALSE," then the
idle time will be nullified on all messages except the server
PING/PONG.

HUB
 * Type: boolean
 * Default: FALSE

All servers of an IRC "network" are connected in a "tree" (no loops).
Servers that are only connected to one other server (called the
"uplink") are called "leafs"; servers that are connected to more than
one other server are called HUBs.  If you specify "FALSE" here then
your server will prevent itself from accidentally connecting to two
servers at once, thus keeping servers in poor network locations from
routing traffic.  Note that on Undernet, all newly linked servers are
linked as leafs during their test phase, and should specify "FALSE"
here.

WALLOPS_OPER_ONLY
 * Type: boolean
 * Default: FALSE

Setting this option removes the ability for clients that are not IRC
operators to see wallops messages.

NODNS
 * Type: boolean
 * Default: FALSE

If you are playing with the server off-line, and no DNS is available,
then long delays occur before the server starts up because it tries to
resolve the name given on the M-line (which usually isn't given in
/etc/hosts) and for each connecting client.  If you specify "TRUE"
here, then a call to gethostbyname() will be done only for the real
hostname, and the server will not try to resolve clients that connect
to "localhost."  Note that other calls to gethostbyname() are still
done if you use VIRTUAL_HOST; also note that the server still tries to
resolve clients that connect to the real IP address of the server.

RANDOM_SEED
 * Type: string
 * Default: none

When a client connects, the server sends the client a "cookie,"
consisting of a random number.  The client must return the cookie to
the server verbatim.  This is done to prevent IP spoofing.  The cookie
is generated by a pseudorandom number generator included in ircd.
This generator must be seeded with a phrase that is kept secret, to
ensure that the numbers it generates are not easily guessed.  The
value given to RANDOM_SEED may be a string of any length.  It should
not contain any characters that are considered special by the
configuration file system, such as ":" or "#"; the string should be at
least 8 characters long, but longer strings are better.  The
RANDOM_SEED may not be retrieved online.

DEFAULT_LIST_PARAM
 * Type: string
 * Default: none

The LIST command takes a single optional argument.  If given, that
argument is either a channel or a filter.  If that argument is not
given, then by default, /LIST will list all channels on the network.
Needless to say, this can generate a large amount of data on large
networks with many channels, as well as chewing up a lot of CPU time.
Server administrators can therefore set a default filter to be applied
to the channel list if the optional argument to LIST is omitted.

NICKNAMEHISTORYLENGTH
 * Type: integer
 * Default: 800

This value specifies the length of the nick name history list, which
is used for /WHOWAS and some nickname chasing in /KILL and /KICK.  It
uses about 300 to 400 bytes per entry.  Note that at a net break, so
many client disappear that the whole "whowas" list is refreshed a few
times (unless you make it rather large).  A reasonable value is "total
number of clients" / 25.

HOST_HIDING
 * Type: boolean
 * Default: TRUE

This selects whether local users can set umode +x, thus allowing them
to hide their hostname if they have also registered with a channel
service (i.e. they have the ACCOUNT flag set).

OPERHOST_HIDING
 * Type: boolean
 * Default: TRUE

When TRUE any oper setting +x will get the hidden host set via
HIDDEN_OPERHOST instead of the host set in HIDDEN_HOST.

HOST_HIDING_STYLE
 * Type: integer
 * Default: 1

Value 1 will give u hidden hosts of ie users.network.tld, Value 2 will
give you Ultimate IRCd style hosts a43sd.a3523f.isp.tld.

HIDDEN_HOST
 * Type: string
 * Default: Users.Nefarious

This selects the suffix for the hidden hostmask (see HOST_HIDING).

HIDDEN_OPERHOST
 * Type: string
 * Default: Staff.Nefarious

This selects the suffix for the hidden hostmask for IRC Operators
(see OPERHOST_HIDING).

HIDDEN_IP
 * Type: string
 * Default: 127.0.0.1

This selects a fake IP to be shown on /USERIP and /WHO %i when the
target has a hidden host (see HOST_HIDING).

CONNEXIT_NOTICES
 * Type: boolean
 * Default: FALSE

This feature controls the generation of server notices when a user
connects to or disconnects from the server.  Enabling this feature may
have a performance impact. If using this features make sure you take
a look at snomask.html in this directory.

EXTENDED_ACCOUNTS
 * Type: boolean
 * Default: TRUE

This enables 'extended' style AC syntax (used by your service to set
the account name.)  TRUE uses the subcommand paramiter R,M,U,C,A,D
to do LOC, rename and removal. FALSE uses old style. Set this to
TRUE if you use X3, FALSE for other services.

LOGIN_ON_CONNECT
 * Type: boolean
 * Default: FALSE

This selects whether local clients can specify a service bot login in
the connection phase. Read doc/readme.login-on-connect for details.

DNSBL_LOC_EXEMPT
 * Type: boolean
 * Default: FALSE

This allows a user who has successfully authed to a service using login
on connect (above) to bypass a DNSBL rejection if they got a positive
result from the earlier check.

LOC_DEFAULT_SERVICE
  * type: string
  * Default: authserv

This is what nick on irc the login-on-connect account verification is sent to. User can override it (to any service that supports it) using 3 param LOC.

DEFAULT_UMODE
 * Type: string
 * Default: "+"

This defines the user modes set when a local user connects.  +x must
not be included in this setting if using host hiding style 1, since
users cannot later remove that flag.

KILLCHASETIMELIMIT
 * Type: integer
 * Default: 30

If a user changes his or her nickname just before an operator issues a
/KILL, the /KILL will be changed to follow the user the operator
intended to get.  This option specifies the time limit, in seconds,
for this nickname change; if the user changed his or her nickname more
than this many seconds ago, the /KILL will not be changed.  Don't
change this unless you really need to.

MAXCHANNELSPERUSER
 * Type: integer
 * Default: 10

This is the maximum number of channels a user can be in at a time.
The "mandatory" value on Undernet is currently 10.  Since it only
influences the local server when you decrease it, its up to you to
decide if you want to use a smaller value.  Do not use a larger value
however, because it DOES cost more memory and bandwidth on all other
servers when you allow users to join more channels simultaneously.
One of the most important reasons to choose a smaller value is the
fact that the "GUI" clients tend to stay on every channel they join
(they aren't bothered by flooding in other channels).  It DOES take
your bandwidth however to send all those messages for 10 different
channels to all your users.

AVEXCEPTLEN
 * Type: integer
 * Default: 40

This is the expected average except mask length.  Leave it at 40.

MAXEXCEPTS
 * Type: integer
 * Default: 30

This is the maximum number of excepts a user may set on a given channel.


CHANNELLEN
 * Type: integer
 * Default: 200

This is the allowed length of locally created channels.  It may not be
larger than the CHANNELLEN #define.  Like the NICKLEN feature, this is
intended to ease changes in channel name length across a network.

AVBANLEN
 * Type: integer
 * Default: 40

This is the expected average ban mask length.  Leave it at 40.

MAXBANS
 * Type: integer
 * Default: 30

This is the maximum number of bans a user may set on a given channel.

MAXSILES
 * Type: integer
 * Default: 15

This is the maximum number of masks a user can silence at a time.  The
silence command allows users to filter messages directed at them from
certain users or domains, at the source server.  Increasing this
number allows users to use up more memory with inefficient use of the
command.  If you're not sure, don't change this.

HALFOPS
 * Type: boolean
 * Default: FALSE

This controls the use of half ops (+h). The server will still accept
half ops from other servers if its set to FALSE (to prevent desyncs)
just not from users.

HANGONGOODLINK
 * Type: integer
 * Default: 300

Often the net breaks for a short time and it is useful to try to
reestablish the same connection faster than CONNECTFREQUENCY would
allow, but to keep from trying again on a bad connection, we require
that the connection be open for a certain minimum time. The
recommended value is 300 seconds.

HANGONRETRYDELAY
 * Type: integer
 * Default: 10

When attempting to quickly reestablish a connection to a good link, we
give the net a few seconds to calm down. This time must be long enough
for the other end to also notice that the connection is broken. The
recommended value is 10 seconds.

CONNECTTIMEOUT
 * Type: integer
 * Default: 90

Number of seconds to wait for a connect(2) call to complete.  NOTE:
this must be at *LEAST* 10.  When a client connects, it has
CONNECTTIMEOUT - 10 seconds for its host to respond to an ident lookup
query and for a DNS lookup to complete. It is recommended that you not
change this value, but if you do, consider the fact that users whose
clients do not support NOSPOOF will have to type /QUOTE PING <big
number> before registration.

TIMESEC
 * Type: integer
 * Default: 60

This is the maximum idle time for the server. If no messages are
received in TIMESEC seconds, PINGFREQUENCY and CONNECTFREQUENCY are
checked.  Recommended value is 60 seconds.

MAXIMUM_LINKS
 * Type: integer
 * Default: 1

This is the maximum number of links for the built-in client class 0.
Leave this value at 1.

PINGFREQUENCY
 * Type: integer
 * Default: 120

If the daemon doesn't receive anything from any of its links within
PINGFREQUENCY seconds, then the it will attempt to check for an active
link with a PING message.  If no reply is received within
(PINGFREQUENCY * 2) seconds, then the connection will be closed.  This
value may be overridden by a Y-line in "ircd.conf" if the connection's
I- or C-line in "ircd.conf" assigns a specific class to the connection
(recommended).

CONNECTFREQUENCY
 * Type: integer
 * Default: 600

This is the default frequency that the server attempts to reconnect
with its uplink server if it is set to auto connect to it. Note that
this value is overridden by a Y-line in ircd.conf if the C-lines in
ircd.conf assign a specific class to the connection (recommended).

DEFAULTMAXSENDQLENGTH
 * Type: integer
 * Default: 40000

This is the default value of the maximum sendQ length of Y-line
classes (see doc/example.conf for details on Y-lines).  You will
probably always override this value in your "ircd.conf" with the
Y-lines.  The given value used to be an often used value for client
sendQs.

GLINEMAXUSERCOUNT
 * Type: integer
 * Default: 20

G-lines that affect too many users have to be set with a special
command, to prevent accidental G-lines of large blocks of users.  This
feature sets that particular threshold.

MPATH
 * Type: string
 * Default: "ircd.motd"

MPATH is the filename (relative to DPATH) or the full path of the
"Message of the Day" file.  The contents of this file will be sent to
every client that connects to the server, after registration.

QPATH
 * Type: string
 * Default: "ircd.quotes"

QPATH is the filename (relative to DPATH) or the full path of the random
quotes file. These quotes will only display if the QUOTES feature is enabled.

EPATH
 * Type: string
 * Default: "ircd.rules"

EPATH is the filename (relative to DPATH) or the full path of the rules file.
Users can see these using the rules command which will need to be enabled if you
wish to use RULES. See the RULES feature.

QMPATH
 * Type: string
 * Default: "ircd.opermotd"

QMPATH is the filename (relative to DPATH) or the full path of the oper message of
the day file. Opers can see the motd via OPERMOTD. OPERMOTD will need to be enabled
if you wish to use it. See the OPERMOTD feature.

RPATH
 * Type: string
 * Default: "remote.motd"

RPATH is the filename (relative to DPATH) or the full path of the
"Remote Message of the Day" file.  The contents of this file will be
sent to every remote client that issues a /MOTD <your server name>.
Only the first three lines are sent, so you might want to keep that in
mind while writing the file.

PPATH
 * Type: string
 * Default: "ircd.pid"

PPATH is the filename (relative to DPATH) or the full path of the
"PID" file.  It is used for storing the server's process ID so that a
ps(1) isn't necessary.

TPATH
 * Type: string
 * Default: "ircd.tune"

TPATH is the filename (relative to DPATH) or the full path of the tune data file.
The file contains user count information for LUSERS so that if the server has to
restart etc for any reason they will not loose their max local/global user counts.

VIRTUAL_HOST
 * Type: boolean
 * Default: FALSE

This option is only needed when you wish to run multiple IRC servers
on the same machine, and they must share at least one port.  This will
require having multiple IP addresses for the machine that will be
hosting the servers.  If you specify "TRUE" here, you can cause the
server to bind to one of these IP addresses.  Use the second field of
the M-line (the "password" field) to specify the IP address.  If you
are unsure, stick with "FALSE."

TOS_SERVER
 * Type: integer
 * Default: 0x08

This option is used to specify the type of service that will be
requested for connections to other servers.  The value may be given as
a hexadecimal integer.

TOS_CLIENT
 * Type: integer
 * Default: 0x08

This option is used to specify the type of service that will be
requested for connections to users.  The value may be given as a
hexadecimal integer.

POLLS_PER_LOOP
 * Type: integer
 * Default: 200

Some of the engines used by the event interface get a number of events
from the kernel at once.  Since the number retrieved can impact
performance, it can be tuned by modifying this value.  The engines
enforce a lower limit of 20.

IRCD_RES_RETRIES
 * Type: integer
 * Default: 2

This is the number of attempts the irc daemon's resolver will have at 
trying to solicit a response from the DNS server.

IRCD_RES_TIMEOUTS
 * Type: integer
 * Default: 4

When a DNS query is sent, the irc daemon's resolver will wait this many
seconds for a reply.  After this timeout has expired, it will retry again,
for as many retries as IRCD_RES_RETRIES allows.  This can be cut short by
AUTH_TIMEOUT expiring.

AUTH_TIMEOUT
 * Type: integer
 * Default: 9

This is the maximum number of seconds to wait for the ident lookup and 
the DNS query to succeed.  On older (pre 2.10.11.06) servers this was
hard coded to 60 seconds.

ANNOUNCE_INVITES
 * Type: boolean
 * Default: TRUE

When a channel operator invites a user to their channel, all other opers
will be notified of the invite.

AUTOJOIN
 * Type: boolean
 * Default: FALSE

Users can be auto joined into a channel on connect. The autojoin channel
is located in ircd_defs.h in the include dir. You WILL HAVE TO recompile
and restart if you change the channel.

AUTOJOIN_NOTICE
 * Type: boolean
 * Default: TRUE

This will display a "warning" message telling the user they are being
autojoined.

AUTOJOIN_NOTICE_VALUE
 * Type: string
 * Default: *** Notice -- You are now being autojoined into \#nefarious

This is the notice that will be displayed to users if AUTOJOIN_NOTICE is
enabled. ALWAYS use a \ before a #!

BADCHAN_REASON
 * Type: string
 * Default: This Channel Has Been Banned

This is the kick reason for users being autokicked from a channel when
it has been bad channel glined.

MOTD_LAST_CHANGED
 * Type: boolean
 * Default: FALSE

A noticed will be displayed to connecting users stating when the message
of the day was last changed.

OPERLEVELS
 * Type: boolean
 * Default: FALSE

Extended oper levels can be enabled. Currently this just adds support for
an IRC Administrator oper level. See example.conf for enabling it on your
O:Line if using this feature.

WHOIS_OPER
 * Type: string
 * Default: is an IRC Operator"

Default whois reply for the is an oper line.

WHOIS_ADMIN
 * Type: string
 * Default: is an IRC Administrator

Default whois reply for is an irc administrator line.

WHOIS_SERVICE
 * Type: string
 * Default: is a Network Service

Default whois reply for is a network service line.

QUOTES
 * Type: boolean
 * Default: TRUE

Controls random quote display for connecting users.

POLICY_NOTICE
 * Type: boolean
 * Default: TRUE

Controls the display of the policy notice for connecting users.

LOCAL_CHANNELS
 * Type: boolean
 * Default: TRUE

When enabled local channels (& perfix) can be used.

OPER_LOCAL_CHANNELS
 * Type: boolean
 * Default: TRUE

Only opers can create local channels if LOCAL_CHANNELS is enabled.

CRYPT_OPER_PASSWORD
 * Type: boolean
 * Default: TRUE

In order to allow certain users to become IRC operators, they must
authenticate themselves with a password.  This password is matched
against an O-line in the "ircd.conf" configuration file; see
doc/example.conf for more details.  If you specify "TRUE" here, you
must use the crypted form of these passwords in your "ircd.conf" file.
Since compromises of the "ircd.conf" file have happened in the past,
you are highly encouraged to use this option.  You can find a program
called "mkpasswd" in the tools directory that will allow you to
generate crypted passwords.

OPER_XTRAOP
 * Type: boolean
 * Default: FALSE

Controls the use of the Xtra Op oper mode (+X).

XTRAOP_CLASS
 * Type: integer
 * Default: 0

This is the class an oper must be in to use the Xtra Op mode if it
is enabled.

OPER_HIDECHANS
 * Type: boolean
 * Default: FALSE

Controls the use of the oper mode for hiding their channels in their
WHOIS output.

OPER_HIDEIDLE
 * Type: boolean
 * Default: FALSE

Controls the use of the oper mode for hiding their idle time in their
WHOIS output.

OPER_NO_CHAN_LIMIT
 * Type: boolean
 * Default: TRUE

If this option is set to "TRUE," IRC operators may join as many
channels as they need to.  This is primarily intended to permit
administrators to run a channel service for local ("&") channels.

OPER_MODE_LCHAN
 * Type: boolean
 * Default: TRUE

If this option is set to "TRUE," IRC operators may change the channel
modes on local ("&") channels.  This is primarily intended to permit
administrators to run a channel service for local channels.

OPER_WALK_THROUGH_LMODES
 * Type: boolean
 * Default: FALSE

If this option is set to "TRUE," IRC operators may join local ("&")
channels regardless of any restrictive modes, including bans.  This
requires giving the special password "OVERRIDE."  This is primarily
intended to permit administrators to run a channel service for local
channels.

NO_OPER_DEOP_LCHAN
 * Type: boolean
 * Default: FALSE

If this option is set to "TRUE," IRC operators may not be deopped on
local ("&") channels.  This is primarily intended to permit
administrators to run a channel service for local channels.

SHOW_INVISIBLE_USERS
 * Type: boolean
 * Default: TRUE

If you specify "TRUE" here, then your (local) IRC Operators will be
able to see all local invisible users (clients connected to your own
server).  This should be used only for investigating instances of
abuse; make sure your operators do not use this for spying on
individuals.

SHOW_ALL_INVISIBLE_USERS
 * Type: boolean
 * Default: TRUE

If you specify "TRUE" here, then your global IRC Operators will be
able to see ALL invisible users.  This should be used only for
investigating instances of abuse; make sure your operators do not use
this for spying on individuals.

UNLIMIT_OPER_QUERY
 * Type: boolean
 * Default: FALSE

A /WHO command can sometimes return several hundred lines of
information.  To reduce the flood potential, the output is truncated.
By setting this option to "TRUE," when an IRC Operator uses /WHO, the
output will not be truncated, no matter how much data is returned.

LOCAL_KILL_ONLY
 * Type: boolean
 * Default: FALSE

If this option is set to "TRUE," operators of this server may only
KILL clients directly connected to this server.  Operators will not be
able to issue KILLs for clients on other servers.  Some networks may
require that this be turned on for newly linking servers.

CHECK
 * Type: boolean
 * Default: TRUE

When enabled an oper is allowed to use the CHECK command.

CHECK_EXTENDED
 * Type: boolean
 * Default: TRUE

When enabled extra information will be displayed for opers who are
using CHECK on local clients. Extra information like traffic counts.

OPER_SINGLELETTERNICK
 * Type: boolean
 * Default: FALSE

This limits single letter nicknames to IRC operators only.

MAX_CHECK_OUTPUT
 * Type: integer
 * Default: 1000

Maximum amount of records displayed in any CHECK query.

CONFIG_OPERCMDS
 * Type: boolean
 * Default: FALSE

For u2.10.11, several new oper-only features have been added that
involve changes to the server<->server protocol.  Until the entire
network is running the new version, these features cannot be enabled.
This configuration option provides a single switch to prevent the use
of these features until the entire network has been upgraded.  It is
not required that all servers set this to "TRUE" in order for the
features to be used.

TOPIC_BURST
 * Type: boolean
 * Default: TRUE

This will burst channel topics on netjoins.

HOST_IN_TOPIC
 * Type: boolean
 * Default: FALSE

When an channel operator changes the channel topic their full
nick!ident@host will be displayed for the person who set the topic.
This can eliminate people faking other people when setting the topic.

TIME_IN_TIMEOUT
 * Type: boolean
 * Default: FALSE

This will display the amount of seconds it took for the user to timeout
in their Ping Timeout quit message.

AUTOCHANMODES
 * Type: boolean
 * Default: FALSE

When a user joins a new channel the modes in AUTOCHANMODES_LIST will
be automatically set

AUTOCHANMODES_LIST
 * Type: string
 * Default: (no default)

If AUTOCHANMODES is enabled then any modes in here will be the modes
set for new channels upon join. Modes should be added in this format
"ntmn" etc.

FAKEHOST
 * Type: boolean
 * Default: TRUE

This enables the FAKEHOST command used for fake hosts (duh).

DEFAULT_FAKEHOST
 * Type: string
 * Default: (empty)

This is the default fakehost given to users who are connecting to the server. If
it is empty or not set then no hostname is set.

SETHOST
 * Type: boolean
 * Default: TRUE

 This enables the /sethost command and user mode +h for opers activating Sethosts.

SETHOST_USER
 * Type: boolean
 * Default: TRUE

 This enabled the /sethost command and user mode +h for users activating Sethosts
 with passwords.

SETHOST_AUTO
 * Type: boolean
 * Default: TRUE

 This enables the automatic application of Sethosts on matching idents and hosts.

SETHOST_FREEFORM
 * Type: boolean
 * Default: TRUE

 This enables opers to set new hostnames that do not have a corresponding S: line
 in the configuration file, as long as the hostname supplied is reasonably valid.
 The usage if this is logged via SNOTICE.

REMOTE_OPER
 * Type: boolean
 * Default: TRUE

Allows remote users to oper up remotly witthout requiring an O:Line on the server
they are on.

BOT_CLASS
 * Type: integer
 * Default: 0

Defines the class a bot must be on to be able to use +B bot mode.

RULES
 * Type: boolean
 * Default: FALSE

Controls the use of the RULES command.

OPERMOTD
 * Type: boolean
 * Default: FALSE

Controls the use of the OPERMOTD command.

EXCEPTS
 * Type: boolean
 * Default: FALSE

Allows the use of channel ban exemptions. THIS WILL BREAK SERVICES THAT ARE
UNPATCHED TO HANDLE THE NEW BURST LINE WE USE! To also use this feature you
MUST enable BREAK_P10.

BREAK_P10
 * Type: boolean
 * Default: FALSE

If enabled and EXCEPTS is enabled then channel ban exemptions will be allowed
to be used.

FLEXABLEKEYS
 * Type: boolean
 * Default: FALSE

Channel key rules over all modes. Eg a user can join a channel with the correct
key and be able to get around modes like limit and invite.

NOTHROTTLE
 * Type: boolean
 * Default: FALSE

Completly disables connection throttling.

CREATE_CHAN_OPER_ONLY
 * Type: boolean
 * Default: FALSE

Only IRC Operators will be able to create new channels.

OPER_KILL
 * Type: boolean
 * Default: TRUE

This selects whether global IRC operators on this server are permitted
to issue the /KILL command.

OPER_REHASH
 * Type: boolean
 * Default: TRUE

This selects whether global IRC operators on this server are permitted
to issue the /REHASH command.

OPER_RESTART
 * Type: boolean
 * Default: TRUE

This selects whether global IRC operators on this server are permitted
to issue the /RESTART command.

OPER_DIE
 * Type: boolean
 * Default: TRUE

This selects whether global IRC operators on this server are permitted
to issue the /DIE command.

OPER_GLINE
 * Type: boolean
 * Default: TRUE

This selects whether global IRC operators on this server are permitted
to issue global G-lines.

OPER_LGLINE
 * Type: boolean
 * Default: TRUE

This selects whether global IRC operators on this server are permitted
to issue local G-lines.

OPER_JUPE
 * Type: boolean
 * Default: TRUE

This selects whether global IRC operators on this server are permitted
to issue global jupes.

OPER_LJUPE
 * Type: boolean
 * Default: TRUE

This selects whether global IRC operators on this server are permitted
to issue local jupes.

OPER_OPMODE
 * Type: boolean
 * Default: TRUE

This selects whether global IRC operators on this server are permitted
to use /OPMODE and /CLEARMODE on ordinary ("#") channels.

OPER_LOPMODE
 * Type: boolean
 * Default: TRUE

This selects whether global IRC operators on this server are permitted
to use /OPMODE and /CLEARMODE on local ("&") channels.

OPER_FORCE_OPMODE
 * Type: boolean
 * Default: TRUE

This selects whether global IRC operators on this server are permitted
to override Q-lines set for /OPMODE and /CLEARMODE on ordinary ("#") channels

OPER_FORCE_LOPMODE
 * Type: boolean
 * Default: TRUE

This selects whether global IRC operators on this server are permitted
to override Q-lines set for /OPMODE and /CLEARMODE on local ("&") channels

OPER_BADCHAN
 * Type: boolean
 * Default: FALSE

This selects whether global IRC operators on this server are permitted
to issue global BADCHANs.  USE OF THIS ON THE UNDERNET IS STRICTLY
REGULATED BY THE UNDERNET ADMINISTRATION.

OPER_LBADCHAN
 * Type: boolean
 * Default: FALSE

This selects whether global IRC operators on this server are permitted
to issue local BADCHANs.  USE OF THIS ON THE UNDERNET IS STRICTLY
REGULATED BY THE UNDERNET ADMINISTRATION.

OPER_SET
 * Type: boolean
 * Default: FALSE

This selects whether global IRC operators on this server are permitted
to use the /SET command to set various feature values.

OPERS_SEE_IN_SECRET_CHANNELS
 * Type: boolean
 * Default: TRUE

If you specify "TRUE" here, then your global IRC Operators will be
able to see who is on a specified secret channel, without joining
themselves.  This can be used to make a reasonable judgment in the
case of a "channel takeover" being reported, while the channel is set
invite-only.  See doc/readme.who for more details.

OPER_WIDE_GLINE
 * Type: boolean
 * Default: TRUE

This selects whether global IRC operators on this server are permitted
to use the /GLINE command with the ! flag to force slightly wide
G-lines to be set.

LOCOP_KILL
 * Type: boolean
 * Default: TRUE

This selects whether local IRC operators are permitted to use the
/KILL command on local clients.

LOCOP_REHASH
 * Type: boolean
 * Default: TRUE

This selects whether local IRC operators are permitted to use the
/REHASH command.

LOCOP_RESTART
 * Type: boolean
 * Default: FALSE

This selects whether local IRC operators are permitted to use the
/RESTART command.

LOCOP_DIE
 * Type: boolean
 * Default: FALSE

This selects whether local IRC operators are permitted to use the /DIE
command.

LOCOP_LGLINE
 * Type: boolean
 * Default: TRUE

This selects whether local IRC operators are permitted to issue local
G-lines.

LOCOP_LJUPE
 * Type: boolean
 * Default: TRUE

This selects whether local IRC operators are permitted to issue local
jupes.

LOCOP_LOPMODE
 * Type: boolean
 * Default: TRUE

This selects whether local IRC operators are permitted to use /OPMODE
and /CLEARMODE on local ("&") channels.

LOCOP_FORCE_LOPMODE
 * Type: boolean
 * Default: TRUE

This selects whether local IRC operators on this server are permitted
to override Q-lines set for /OPMODE and /CLEARMODE on local ("&") channels

LOCOP_LBADCHAN
 * Type: boolean
 * Default: FALSE

This selects whether local IRC operators are permitted to issue local
BADCHANs.  USE OF THIS ON THE UNDERNET IS STRICTLY REGULATED BY THE
UNDERNET ADMINISTRATION.

LOCOP_SET
 * Type: boolean
 * Default: FALSE

This selects whether local IRC operators are permitted to use the /SET
command to set various feature values.

LOCOP_SEE_IN_SECRET_CHANNELS
 * Type: boolean
 * Default: FALSE

If you specify "TRUE" here, then your local IRC Operators will be
able to see who is on a specified secret channel, without joining
themselves.  This can be used to make a reasonable judgment in the
case of a "channel takeover" being reported, while the channel is set
invite-only.  See doc/readme.who for more details.

LOCOP_WIDE_GLINE
 * Type: boolean
 * Default: FALSE

This selects whether local IRC operators are permitted to use the
/GLINE command with the ! flag to force slightly wide G-lines to be
set.

RESTARTPASS
 * Type: string
 * Default: (empty)

This is the password required for a server to actually restart when
the RESTART command is used. The if the password is empty then no
password is required.

DIEPASS
 * Type: string
 * Default: (empty)

This is the password required for a server to actually die when
the DIE command is used. The if the password is empty then no
password is required.

TARGET_LIMITING
 * Type: boolean
 * Default: TRUE

Limits users to a certain amount of targets in the a certain
amount of time.

DNSBL_CHECKS
 * Type: boolean
 * Default: FALSE

Enables DNS blacklist checks controlled via X:Lines. THIS FEATURE
IS HIGHLY BETA! Do not use it in a production enviroment yet.

DNSBL_EXEMPT_CLASS
 * Type: integer
 * Default: 0

Anyone in this class is immune to DNSBL checks if they are enabled.

STATS_C_IPS
 * Type: boolean
 * Default: FALSE

Hides IP addresses in STATS C output for users.

HIS_IRCOPS
 * Type: boolean
 * Default: TRUE

This removes IRCOPS from users.

HIS_IRCOPS_SERVERS
 * Type: boolean
 * Default: TRUE

This removes server names in the IRCOPS output from users.

HIS_MAP
 * Type: boolean
 * Default: TRUE

As per UnderNet CFV-165, this removes /MAP from users.

HIS_MAP_SCRAMBLED
 * Type: boolean
 * Default: TRUE

Scrambles the MAP output for normal users, removing hubs and 
U:lined servers.

HIS_SNOTICES
 * Type: boolean
 * Default: TRUE

As per UnderNet CFV-165, this removes server notices from users.
 
HIS_SNOTICES_OPER_ONLY
 * Type: boolean
 * Default: TRUE

As per UnderNet CFV-165, this removes server notices from users.
 
HIS_DESYNCS
 * Type: boolean
 * Default: TRUE

As per UnderNet CFV-165, this removes server wallops from users.

HIS_DEBUG_OPER_ONLY
 * Type: boolean
 * Default: TRUE

As per UnderNet CFV-165, this removes server wallops from users.

HIS_WALLOPS
 * Type: boolean
 * Default: TRUE

As per UnderNet CFV-165, this removes operator wallops from users.

HIS_LINKS
 * Type: boolean
 * Default: TRUE

As per UnderNet CFV-165, this removes /LINKS from users.

HIS_LINKS_SCRAMBLED
 * Type: boolean
 * Default: TRUE

Scrambles the LINKS output for users, removing hubs and U:Lined
servers.

HIS_TRACE
 * Type: boolean
 * Default: TRUE

As per UnderNet CFV-165, this removes /TRACE from users.

HIS_SHUN_REASON
 * Type: boolean
 * Default: TRUE

This HIDES the shun reason from the target when a shun is set
on them (when TRUE).

HIS_STATS_l
 * Type: boolean
 * Default: TRUE

As per UnderNet CFV-165, this removes /STATS l from users.

HIS_STATS_b
 * Type: boolean
 * Default: TRUE

As per UnderNet CFV-165, this removes /STATS b from users.

HIS_STATS_c
 * Type: boolean
 * Default: TRUE

As per UnderNet CFV-165, this removes /STATS c from users.

HIS_STATS_g
 * Type: boolean
 * Default: TRUE

As per UnderNet CFV-165, this removes /STATS g from users.

HIS_STATS_h
 * Type: boolean
 * Default: TRUE

As per UnderNet CFV-165, this removes /STATS h from users.

HIS_STATS_k
 * Type: boolean
 * Default: TRUE

As per UnderNet CFV-165, this removes /STATS k from users.

HIS_STATS_f
 * Type: boolean
 * Default: TRUE

As per UnderNet CFV-165, this removes /STATS f from users.

HIS_STATS_i
 * Type: boolean
 * Default: TRUE

As per UnderNet CFV-165, this removes /STATS i from users.

HIS_STATS_j
 * Type: boolean
 * Default: TRUE

As per UnderNet CFV-165, this removes /STATS j from users.

HIS_STATS_M
 * Type: boolean
 * Default: TRUE

As per UnderNet CFV-165, this removes /STATS M from users.

HIS_STATS_m
 * Type: boolean
 * Default: TRUE

As per UnderNet CFV-165, this removes /STATS m from users.

HIS_STATS_o
 * Type: boolean
 * Default: TRUE

As per UnderNet CFV-165, this removes /STATS o from users.

HIS_STATS_p
 * Type: boolean
 * Default: TRUE

As per UnderNet CFV-165, this removes /STATS p from users.

HIS_STATS_q
 * Type: boolean
 * Default: TRUE

As per UnderNet CFV-165, this removes /STATS q from users.

HIS_STATS_R
 * Type: boolean
 * Default: TRUE
 
As per UnderNet CFV-165, this removes /STATS R from users.

HIS_STATS_r
 * Type: boolean
 * Default: TRUE

As per UnderNet CFV-165, this removes /STATS r from users.

HIS_STATS_s
 * Type: boolean
 * Default: TRUE

As per SETHOST patch, this removes /STATS s from users.

HIS_STATS_d
 * Type: boolean
 * Default: TRUE

As per UnderNet CFV-165, this removes /STATS d from users.

HIS_STATS_e
 * Type: boolean
 * Default: TRUE

As per UnderNet CFV-165, this removes /STATS e from users.

HIS_STATS_t
 * Type: boolean
 * Default: TRUE

As per UnderNet CFV-165, this removes /STATS t from users.

HIS_STATS_T
 * Type: boolean
 * Default: TRUE

As per UnderNet CFV-165, this removes /STATS T from users.

HIS_STATS_u
 * Type: boolean
 * Default: FALSE

As per UnderNet CFV-165, this allows users to perform /STATS u.

HIS_STATS_U
 * Type: boolean
 * Default: TRUE

As per UnderNet CFV-165, this removes /STATS U from users.

HIS_STATS_v
 * Type: boolean
 * Default: TRUE

As per UnderNet CFV-165, this removes /STATS v from users.

HIS_STATS_w
 * Type: boolean
 * Default: FALSE

As per UnderNet CFV-165, this allows users to perform /STATS w.

HIS_STATS_x
 * Type: boolean
 * Default: TRUE

As per UnderNet CFV-165, this removes /STATS x from users.

HIS_STATS_X
 * Type: boolean
 * Default: TRUE

As per UnderNet CFV-165, this removes /STATS X from users.

HIS_STATS_y
 * Type: boolean
 * Default: TRUE

As per UnderNet CFV-165, this removes /STATS y from users.

HIS_STATS_z
 * Type: boolean
 * Default: TRUE

As per UnderNet CFV-165, this removes /STATS z from users.

HIS_WHOIS_SERVERNAME
 * Type: boolean
 * Default: TRUE

As per UnderNet CFV-165, this removes server names in replies to /WHOIS.

HIS_WHOIS_IDLETIME
 * Type: boolean
 * Default: TRUE

As per UnderNet CFV-165, this removes idle time in replies to /WHOIS.

HIS_WHOIS_LOCALCHAN
 * Type: boolean
 * Default: TRUE

As per UnderNet CFV-165, this removes local channels in replies to /WHOIS.

HIS_WHO_SERVERNAME
 * Type: boolean
 * Default: TRUE

As per UnderNet CFV-165, this removes server names in replies to /WHO.

HIS_WHO_HOPCOUNT
 * Type: boolean
 * Default: TRUE

As per UnderNet CFV-165, this replaces hopcount to a static 3 in replies to /WHO.

HIS_BANWHO
 * Type: boolean
 * Default: TRUE

As per UnderNet CFV-165, this doesn't show which server set a ban.

HIS_EXCEPTWHO
 * Type: boolean
 * Default: TRUE

As per UnderNet CFV-165, this doesn't show which server set a except.

HIS_KILLWHO
 * Type: boolean
 * Default: TRUE

As per UnderNet CFV-165, this doesn't show which server or oper performed a
kill.

HIS_HIDEWHO
 * Type: boolean
 * Default: TRUE

This doesn't show which server preformed various functions like mode, opmode
kick, etc when server preforms..

HIS_REWRITE
 * Type: boolean
 * Default: TRUE

As per UnderNet CFV-165, this remaps remote numerics to come from the local
server.

HIS_GLINE
 * Type: boolean
 * Default: TRUE

This will hide the user who done the gline in the gline message when enabled.

HIS_USERGLINE
 * Type: boolean
 * Default: TRUE

This will disable users using the gline command. (If the nessecary options are
enabled, users can query the gline list using the gline command).

HIS_REMOTE
 * Type: integer
 * Default: 1

As per UnderNet CFV-165, this disallows remote queries. (*sob!*)

HIS_SCRAMBLED_CACHE_TIME
 * Type: integer
 * Default: 604800

Amount of seconds a split server is cached for before dissapearing off MAPS
and LINKS for normal users.

HIS_NETSPLIT
 * Type: boolean
 * Default: TRUE

As per UnderNet CFV-165, this removes server names in net break sign-offs.

HIS_SERVERNAME
 * Type: string
 * Default: "*.Nefarious"

As per UnderNet CFV-165, this is the "name" of the server shown to users on a
/WHOIS of another user.

HIS_SERVERINFO
 * Type: string
 * Default: "evilnet development"

As per UnderNet CFV-165, this is the "info" of the server shown to users on a
/WHOIS of another user.

HIS_URLSERVERS        
 * Type: string 
 * Default: "http://sourceforge.net/projects/evilnet/""
 
As per UnderNet CFV-165, this is the URL shown to users when they do a /MAP or 
/LINKS.

NETWORK
 * Type: string
 * Default: "Nefarious"

This defines the network name as reported in the 005 "supported features"
numeric, and as used by the "Failed to deliver" message.

URL_CLIENTS
 * Type: string
 * Default: "http://www.ircreviews.org/clients/"

This defines a URL that users may visit to find compatible IRC clients.

BADUSER_URL
 * Type: string
 * Default: "http://www.mirc.co.uk/help/servererrors.html"

This defines a URL that users may visit to fix their username/ident when
it is invalid.

NETWORK_REHASH
 * Type: boolean
 * Default: FALSE

Allow this server to act upon a network-issued /rehash.

NETWORK_RESTART
 * Type: boolean
 * Default: FALSE

Allow this server to act upon a network-issued /restart.

NETWORK_DIE
 * Type: boolean
 * Default: FALSE

Allow this server to act upon a network-issued /die.