added basic ssl support to ircu
[ircu2.10.12-pk.git] / doc / readme.features
index 116e4465576f8dd4e7d188f68703eb26ae11d16e..de1b33276cf3769e9bea5e8de4cbfb6c062926cd 100644 (file)
@@ -1,7 +1,9 @@
 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.
+through the use of Feature entries, 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
@@ -61,7 +63,7 @@ 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
+your Class blocks 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
@@ -101,16 +103,16 @@ SERVER_PORT
 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.
+server will take the port from the Connect block.  If no port is
+specified in the Connect block, 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
+Day (as specified by the Motd blocks 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
@@ -126,6 +128,13 @@ MOTD_BANNER
 If you enable NODEFAULTMOTD, this specifies a one-line banner to be sent
 to the client in addition to the instructions mentioned above.
 
+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
+
 KILL_IPMISMATCH
  * Type: boolean
  * Default: FALSE
@@ -174,13 +183,12 @@ NODNS
 
 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.
+resolve the name given in the General block (which usually isn't given
+in /etc/hosts) and for each connecting client.  If you specify "TRUE"
+here, then a DNS lookup will be done only for the real hostname, and
+the server will not try to resolve clients that connect to
+"localhost."  Note that other DNS lookups are still done for outbound
+connections.
 
 RANDOM_SEED
  * Type: string
@@ -223,7 +231,7 @@ number of clients" / 25.
 
 HOST_HIDING
  * Type: boolean
- * Default: FALSE
+ * 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
@@ -235,6 +243,21 @@ HIDDEN_HOST
 
 This selects the suffix for the hidden hostmask (see HOST_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.
+
 KILLCHASETIMELIMIT
  * Type: integer
  * Default: 30
@@ -270,7 +293,7 @@ This is the expected average ban mask length.  Leave it at 40.
 
 MAXBANS
  * Type: integer
- * Default: 30
+ * Default: 45
 
 This is the maximum number of bans a user may set on a given channel.
 
@@ -315,14 +338,6 @@ 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
@@ -338,9 +353,9 @@ 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).
+value may be overridden by a Class block in "ircd.conf" if the
+connection's Client or Connect block in "ircd.conf" assigns a specific
+class to the connection (recommended).
 
 CONNECTFREQUENCY
  * Type: integer
@@ -348,18 +363,16 @@ CONNECTFREQUENCY
 
 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).
+this value is overridden by a Class block in ircd.conf if the Connect
+entries in ircd.conf assign a specific class to the connection.
 
 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.
+This is the default value of the maximum sendQ length of connection
+classes (see doc/example.conf for details on Class blocks).  You will
+generally override this value in your "ircd.conf" with a Class block.
 
 GLINEMAXUSERCOUNT
  * Type: integer
@@ -395,18 +408,6 @@ 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.
 
-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
@@ -432,292 +433,464 @@ 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.
 
-CRYPT_OPER_PASSWORD
+CONFIG_OPERCMDS
+ * Type: boolean
+ * Default: FALSE
+
+Since u2.10.11, several new oper-only features have been added that
+involve changes to the server<->server protocol.  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,
+as long as all servers are running u2.10.11 or above.
+
+HIS_MAP
  * 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.
+As per UnderNet CFV-165, this removes /MAP from users.
 
-OPER_NO_CHAN_LIMIT
+HIS_SNOTICES
  * 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.
+As per UnderNet CFV-165, this removes server notices from users.
 
-OPER_MODE_LCHAN
+HIS_SNOTICES_OPER_ONLY
  * 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.
+As per UnderNet CFV-165, this removes server notices from users.
 
-OPER_WALK_THROUGH_LMODES
+HIS_DEBUG_OPER_ONLY
  * Type: boolean
- * Default: FALSE
+ * Default: TRUE
 
-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.
+As per UnderNet CFV-165, this removes server wallops from users.
 
-NO_OPER_DEOP_LCHAN
+HIS_WALLOPS
  * Type: boolean
- * Default: FALSE
+ * Default: TRUE
 
-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.
+As per UnderNet CFV-165, this removes operator wallops from users.
 
-SHOW_INVISIBLE_USERS
+HIS_LINKS
  * 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.
+As per UnderNet CFV-165, this removes /LINKS from users.
 
-SHOW_ALL_INVISIBLE_USERS
+HIS_TRACE
  * 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.
+As per UnderNet CFV-165, this removes /TRACE from users.
 
-UNLIMIT_OPER_QUERY
+HIS_STATS_a
  * Type: boolean
- * Default: FALSE
+ * Default: TRUE
 
-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.
+As per UnderNet CFV-165, this removes /STATS a from users.
 
-LOCAL_KILL_ONLY
+HIS_STATS_c
  * Type: boolean
- * Default: FALSE
+ * Default: TRUE
 
-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.
+As per UnderNet CFV-165, this removes /STATS c from users.
 
-CONFIG_OPERCMDS
+HIS_STATS_d
  * Type: boolean
- * Default: FALSE
+ * Default: TRUE
 
-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.
+As per UnderNet CFV-165, this removes /STATS d from users.
 
-OPER_KILL
+HIS_STATS_e
  * Type: boolean
  * Default: TRUE
 
-This selects whether global IRC operators on this server are permitted
-to issue the /KILL command.
+As per UnderNet CFV-165, this removes /STATS e from users.
 
-OPER_REHASH
+HIS_STATS_f
  * Type: boolean
  * Default: TRUE
 
-This selects whether global IRC operators on this server are permitted
-to issue the /REHASH command.
+As per UnderNet CFV-165, this removes /STATS f from users.
 
-OPER_RESTART
+HIS_STATS_g
  * Type: boolean
  * Default: TRUE
 
-This selects whether global IRC operators on this server are permitted
-to issue the /RESTART command.
+As per UnderNet CFV-165, this removes /STATS g from users.
 
-OPER_DIE
+HIS_STATS_i
  * Type: boolean
  * Default: TRUE
 
-This selects whether global IRC operators on this server are permitted
-to issue the /DIE command.
+As per UnderNet CFV-165, this removes /STATS i from users.
 
-OPER_GLINE
+HIS_STATS_j
  * Type: boolean
  * Default: TRUE
 
-This selects whether global IRC operators on this server are permitted
-to issue global G-lines.
+As per UnderNet CFV-165, this removes /STATS j from users.
 
-OPER_LGLINE
+HIS_STATS_J
  * Type: boolean
  * Default: TRUE
 
-This selects whether global IRC operators on this server are permitted
-to issue local G-lines.
+As per UnderNet CFV-165, this removes /STATS J from users.
 
-OPER_JUPE
+HIS_STATS_k
  * Type: boolean
  * Default: TRUE
 
-This selects whether global IRC operators on this server are permitted
-to issue global jupes.
+As per UnderNet CFV-165, this removes /STATS k from users.
 
-OPER_LJUPE
+HIS_STATS_l
  * Type: boolean
  * Default: TRUE
 
-This selects whether global IRC operators on this server are permitted
-to issue local jupes.
+As per UnderNet CFV-165, this removes /STATS l from users.
 
-OPER_OPMODE
+HIS_STATS_L
  * Type: boolean
  * Default: TRUE
 
-This selects whether global IRC operators on this server are permitted
-to use /OPMODE and /CLEARMODE on ordinary ("#") channels.
+As per UnderNet CFV-165, this removes /STATS L from users.
 
-OPER_LOPMODE
+HIS_STATS_M
  * Type: boolean
  * Default: TRUE
 
-This selects whether global IRC operators on this server are permitted
-to use /OPMODE and /CLEARMODE on local ("&") channels.
+As per UnderNet CFV-165, this removes /STATS M from users.
 
-OPER_BADCHAN
+HIS_STATS_m
  * Type: boolean
- * Default: FALSE
+ * Default: TRUE
 
-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.
+As per UnderNet CFV-165, this removes /STATS m from users.
 
-OPER_LBADCHAN
+HIS_STATS_o
  * Type: boolean
- * Default: FALSE
+ * Default: TRUE
 
-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.
+As per UnderNet CFV-165, this removes /STATS o from users.
 
-OPER_SET
+HIS_STATS_p
  * Type: boolean
- * Default: FALSE
+ * Default: TRUE
+
+As per UnderNet CFV-165, this removes /STATS p from users.
+
+HIS_STATS_q
+ * Type: boolean
+ * Default: TRUE
 
-This selects whether global IRC operators on this server are permitted
-to use the /SET command to set various feature values.
+As per UnderNet CFV-165, this removes /STATS q from users.
 
-OPERS_SEE_IN_SECRET_CHANNELS
+HIS_STATS_r
  * 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.
+As per UnderNet CFV-165, this removes /STATS r from users.
 
-OPER_WIDE_GLINE
+HIS_STATS_R
  * 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.
+As per UnderNet CFV-165, this removes /STATS R from users.
 
-LOCOP_KILL
+HIS_STATS_t
  * Type: boolean
  * Default: TRUE
 
-This selects whether local IRC operators are permitted to use the
-/KILL command on local clients.
+As per UnderNet CFV-165, this removes /STATS t from users.
 
-LOCOP_REHASH
+HIS_STATS_T
  * Type: boolean
  * Default: TRUE
 
-This selects whether local IRC operators are permitted to use the
-/REHASH command.
+As per UnderNet CFV-165, this removes /STATS T from users.
 
-LOCOP_RESTART
+HIS_STATS_u
  * Type: boolean
  * Default: FALSE
 
-This selects whether local IRC operators are permitted to use the
-/RESTART command.
+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.
 
-LOCOP_DIE
+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
 
-This selects whether local IRC operators are permitted to use the /DIE
-command.
+As per UnderNet CFV-165, this allows users to perform /STATS w.
 
-LOCOP_LGLINE
+HIS_STATS_x
  * Type: boolean
  * Default: TRUE
 
-This selects whether local IRC operators are permitted to issue local
-G-lines.
+As per UnderNet CFV-165, this removes /STATS x from users.
 
-LOCOP_LJUPE
+HIS_STATS_y
  * Type: boolean
  * Default: TRUE
 
-This selects whether local IRC operators are permitted to issue local
-jupes.
+As per UnderNet CFV-165, this removes /STATS y from users.
 
-LOCOP_LOPMODE
+HIS_STATS_z
  * Type: boolean
  * Default: TRUE
 
-This selects whether local IRC operators are permitted to use /OPMODE
-and /CLEARMODE on local ("&") channels.
+As per UnderNet CFV-165, this removes /STATS z from users.
 
-LOCOP_LBADCHAN
+HIS_STATS_IAUTH
  * Type: boolean
- * Default: FALSE
+ * Default: TRUE
 
-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.
+As per UnderNet CFV-165, this disables /STATS IAUTH and
+/STATS IAUTHCONF from users.
 
-LOCOP_SET
+HIS_WHOIS_SERVERNAME
  * Type: boolean
- * Default: FALSE
+ * 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_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_MODEWHO
+ * Type: boolean
+ * Default: TRUE
+
+As per UnderNet CFV-165, this doesn't show which server performed a channel
+mode change.
+
+HIS_BANWHO
+ * Type: boolean
+ * Default: TRUE
+
+As per UnderNet CFV-165, this doesn't show which server set a ban.
+
+HIS_KILLWHO
+ * Type: boolean
+ * Default: TRUE
 
-This selects whether local IRC operators are permitted to use the /SET
-command to set various feature values.
+As per UnderNet CFV-165, this doesn't show which server or oper performed a
+kill.
 
-LOCOP_SEE_IN_SECRET_CHANNELS
+HIS_REWRITE
+ * Type: boolean
+ * Default: TRUE
+
+As per UnderNet CFV-165, this remaps remote numerics to come from the local
+server.
+
+HIS_REMOTE
+ * Type: integer
+ * Default: 1
+
+As per UnderNet CFV-165, this disallows remote queries. (*sob!*)
+
+HIS_NETSPLIT
+ * Type: boolean
+ * Default: TRUE
+
+As per UnderNet CFV-165, this removes server names in net break sign-offs.
+
+HIS_WHOIS_LOCALCHAN
+ * Type: boolean
+ * Default: TRUE
+
+As per UnderNet CFV-165, this removes local channels in replies to /WHOIS.
+
+HIS_SERVERNAME
+ * Type: string
+ * Default: "*.undernet.org"
+
+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: "The Undernet Underworld"
+
+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://www.undernet.org/servers.php"
+
+As per UnderNet CFV-165, this is the URL shown to users when they do a /MAP or
+/LINKS.
+
+NETWORK
+ * Type: string
+ * Default: "UnderNet"
+
+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: "ftp://ftp.undernet.org/pub/irc/clients"
+
+This defines a URL that users may visit to find compatible IRC clients.
+
+URLREG
+ * Type: string
+ * Default: "http://cservice.undernet.org/live/"
+
+This defines a URL that is used in server response 477 (ERR_NEEDREGGEDNICK) to
+let users know which website they must visit to obtain a proper account for
+authentication.
+
+NICKLEN
+ * Type: integer
+ * Default: 12
+
+This is the allowed length of the nickname length.  It may not be
+larger than the NICKLEN #define, and should usually be the same
+length.  The real purpose of this feature is to permit easy increases
+in nickname length for a network.
+
+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_TIMEOUT
+ * 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.
+NOTE: Has no effect when using the adns resolver.
+
+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.
+
+IPCHECK_CLONE_LIMIT
+ * Type: integer
+ * Default: 4
+
+The number of times you are allowed to connect within IPCHECK_CLONE_PERIOD
+seconds before you are considered abusing the server and throttled.
+
+IPCHECK_CLONE_PERIOD
+ * Type: integer
+ * Default: 40
+
+The number of seconds you are allowed to connect IPCHECK_CLONE_LIMIT times
+within before you are considered abusing the server and throttled.
+For instance if you set IPCHECK_CLONE_LIMIT to 1, and IPCHECK_CLONE_PERIOD
+to 10, then a user is only allowed to connect once in 10s, if they connect
+again within 10s, then they are considered to be connecting too fast and
+they are throttled.
+
+IPCHECK_CLONE_DELAY
+ * Type: integer
+ * Default: 600
+
+The number of seconds grace after restarting the server before the throttle
+code kicks in.  Even if a user connects repetitively during this period,
+they will never get throttled.  This is so after a restart users on a
+multiuser box can all connect to a server simultaniously without being
+considered an attack.
+
+SOCKSENDBUF
+ * Type: integer
+ * Default: 61440
+
+The send window size used for connections to other servers.
+
+SOCKRECVBUF
+ * Type: integer
+ * Default: 61440
+
+The receive window size used for connections to other servers.
+
+ANNOUNCE_INVITES
  * 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.
+If set, send RPL_ISSUEDINVITE (345) to a channel's operators to
+announce when someone is invited to the channel.
+
+LOCAL_CHANNELS
+ * Type: boolean
+ * Default: TRUE
+
+If set, allow users to create local channels.
 
-LOCOP_WIDE_GLINE
+TOPIC_BURST
  * 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.
+If set, send the current topic value and timestamp for channels during
+burst.  This generally only makes sense for hubs to use, and it causes
+a large increase in net.burst size.
+
+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.
+
+OPLEVELS
+ * Type: boolean
+ * Default: TRUE
+
+This allows local users to set the +A and +U modes (admin and user
+passwords, respectively) on channels where they are marked as channel
+managers.  This feature must be disabled until all servers on the
+network are able to interpret and handle these modes correctly.
+
+ZANNELS
+ * Type: boolean
+ * Default: TRUE
+
+This preserves empty channels with no admin password so that it is
+impractical to become the channel manager by clearing out the channel.
+It must be set to FALSE if there are both 2.10.11.x servers and
+2.10.12.y servers on the network where y < 4.  It should be set to
+TRUE whenever the OPLEVELS features is TRUE.