Server Features
(Update DOMAINNAME) |
|||
Line 1: | Line 1: | ||
{{NeedUpdate}} | {{NeedUpdate}} | ||
- | This page documents various features supported by ircd-darenet | + | This page documents various features supported by ircd-darenet that can be configured at run-time. |
+ | |||
==DOMAINNAME== | ==DOMAINNAME== | ||
- | {| class=" | + | {| class="simpletable" |
| '''Type''' | | '''Type''' | ||
| string | | string | ||
Line 12: | Line 13: | ||
|} | |} | ||
- | + | Sets the domain the ircd will consider as "local", which is ONLY used for statistical purposes. | |
+ | |||
+ | The <code>/STATS w</code> and <code>/STATS usrload</code> commands return statistical data, such as how many clients have connected to the server in the last minute, hour and day. These statistics are shown for all connections, including servers, with a separate entry for clients who's hostname ends on the domain specified for <code>DOMAINNAME</code>. | ||
- | + | The string should not start with a '.' and cannot be empty. If you don't want to specify a domain, do not define this feature. | |
==RELIABLE_CLOCK== | ==RELIABLE_CLOCK== |
Revision as of 05:22, 5 January 2013
This page documents various features supported by ircd-darenet that can be configured at run-time.
DOMAINNAME
Type | string |
Default: | ircd.darenet |
Sets the domain the ircd will consider as "local", which is ONLY used for statistical purposes.
The /STATS w
and /STATS usrload
commands return statistical data, such as how many clients have connected to the server in the last minute, hour and day. These statistics are shown for all connections, including servers, with a separate entry for clients who's hostname ends on the domain specified for DOMAINNAME
.
The string should not start with a '.' and cannot be empty. If you don't want to specify a domain, do not define this feature.
RELIABLE_CLOCK
Type | boolean |
Default: | FALSE |
This option should ONLY be specified as "TRUE" when your system clock is stable and accurate at all times (e.g. 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 not guaranteed. For example, it is known that xntpd gives unreliable results on linux in some cases.
An unreliable clock is worse than a 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 SHOULD be running ntpd or equivalent AND make sure it works. On DareNET, this should always be "FALSE" unless a member of the Infrastructure Team has told you otherwise.
BUFFERPOOL
integer | |
Default: | 27000000 |
This option 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 need 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.
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 than 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: | 7325 |
When an IRC operator attempts a connect to another server, he or she may not know which port the connect should go to. In ircd-darenet, that operator may use the special port 0, in which case the server will take the port from the Connect block. If no port is specified in the Connect block, then the port specified by this option will be used instead.
NODEFAULTMOTD
Type | boolean |
Default: | TRUE |
Each time a client connects to the server, the full Message of the Day (MOTD), as specified by the motd block or file specified by the MPATH option, is sent to the client. The server sends the MOTD even though many clients permit the user to ignore it (e.g. hide it). Therefore, many users never read the MOTD anyway, making it a huge waste of bandwidth. If "TRUE" is specified here, then the server will not send the MOTD to the client by default; instead, it will only inform the client of when the MOTD was last changed, and give them instructions in how to obtain it by typing /MOTD.
MOTD_BANNER
Type | string |
Default: | NULL |
If the NODEFAULTMOTD option is enabled, then the one-line banner specified here is sent to the client in addition to the instructions , as mentioned above.
REMOTE_MOTD
Type | boolean |
Default: | TRUE |
Controls the use of remote message of the day's.
PROVIDER
Type | string |
Default: | NULL |
This string is added to the 001 numeric prefixed with "via" before the nick. It's used for providing promotional space to providers.
GEO_LOCATION
Type | string |
Default: | NULL |
This string as added to the 003 numeric, is used for providing the location of the server, e.g. "Los Angeles, CA, 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 DareNET, 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: | NULL |
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 clients 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 and authenticated with N (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 use ircu-style hostmasking. Value 2 uses Ultimate IRCd style hostmangling, such as a43sd.a3523f.isp.tld.
HIDDEN_HOST
Type | string |
Default: | user.darenet |
This selects the suffix for the hidden hostmask (see HOST_HIDING).
HOST_HIDING_PREFIX
Type | string |
Default: | DareNET |
This selects the suffix for the hidden hostmask style 2.
HIDDEN_OPERHOST
Type | string |
Default: | staff.darenet |
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: | TRUE |
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 feature make sure you take a look at SNOMASKs.
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 parameter R,M,U,C,A,D to do LOC, rename and removal. FALSE uses old style. Set this to TRUE if you're linking to DareNET / using services-darenet, FALSE for other services.
LOGIN_ON_CONNECT
Type | boolean |
Default: | TRUE |
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: | TRUE |
This allows a user who has successfully authed to a service using login on connect (above) to bypass a DNSBL rejection if they get a positive result from the earlier check.
DNSBL_LOC_EXEMPT_N_ONE
Type | string |
Default: | If you have an account with DareNET's N then you can bypass the DNSBL ban by logging in like this (where Account is your account name and Password is your password): |
If DNSBL_LOC_EXEMPT is enabled and a user matches a dnsbl then they will be sent a notice containing the string for this feature.
DNSBL_LOC_EXEMPT_N_TWO
Type | string |
Default: | Type \002/QUOTE PASS N Account :Password\002 to connect |
If DNSBL_LOC_EXEMPT is enabled and a user matches a dnsbl then they will be sent a notice containing the string for this feature.
DNSBL_WALLOPS_ONLY
Type | boolean |
Default: | FALSE |
If enabled DNSBL filter matches will be alerted to opers via wallops.
DNSBL_MARK_FAKEHOST
Type | boolean |
Default: | TRUE |
If enabled then users who match DNSBL's will be marked.
LOC_DEFAULT_SERVICE
Type | string |
Default: | N |
This is what nick on IRC the login-on-connect account verification is sent to. Users can override it (to any service that supports it) using 3 param LOC.
DEFAULT_UMODE
Type | string |
Default: | +iw |
This defines the user modes set when a local user connects. +x should 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: | 50 |
This is the maximum number of channels a user can be in at a time. The "mandatory" value on DareNET 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 | boolean |
Default: | 100 |
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: | 100 |
This is the maximum number of bans a user may set on a given channel.
MAXSILES
Type | integer |
Default: | 50 |
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.
MAXACCEPTS
Type | binteger |
Default: | 50 |
This is the maximum number of masks a user can accept at a time. The accept command allows users to "always accept" messages directed at them from certain users or domains when they have callerid enabled (umode +g). 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.
HANGONGOODLINK
Type | integer |
Default: | 300 |
Ocassionally 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.
OMPATH
Type | string |
Default: | ircd.opermotd |
OMPATH 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 operator upon opering.
RPATH
Type | string |
Default: | ircd.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: | TRUE |
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, change to "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.
NICKLEN
Type | integer |
Default: | 30 |
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.
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: | TRUE |
When a channel operator invites a user to their channel, all other opers will be notified of the invite.
BADCHAN_REASON
Type | string |
Default: | This channel has been closed |
This is the kick reason for users being autokicked from a channel when it has been bad channel glined.
OPERFLAGS
Type | boolean |
Default: | TRUE |
Extended oper levels can be enabled. Currently this adds support for a Server Administrator oper level, and a few additional privileges granted through oper flags. See example.conf for enabling these on your O:Line if using this feature.
POLICY_NOTICE
Type | boolean |
Default: | TRUE |
Controls the display of the policy notice for connecting users.
LOCAL_CHANNELS
Type | boolean |
Default: | FALSE |
When enabled local channels (& perfix) can be used.
OPER_LOCAL_CHANNELS
Type | boolean |
Default: | FALSE |
Only opers can create local channels if LOCAL_CHANNELS is enabled.
OPER_XTRAOP
Type | boolean |
Default: | FALSE |
Controls the use of the (Quakenet-style) Xtra Op oper mode (+X).
XTRAOP_CLASS
Type | string |
Default: | XtraOp |
This is the class an oper must be in to use the Xtra Op mode if it is enabled.
OPER_HIDECHANS
Type | boolean |
Default: | TRUE |
Controls the use of the oper mode for hiding their channels in their WHOIS output.
OPER_HIDEIDLE
Type | boolean |
Default: | TRUE |
Controls the use of the oper mode for hiding their idle time in their WHOIS output.
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: | TRUE |
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: | TRUE |
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.
HOST_IN_TOPIC
Type | boolean |
Default: | TRUE |
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: | TRUE |
When a user joins a new channel the modes in AUTOCHANMODES_LIST will be automatically set
AUTOCHANMODES_LIST
Type | string |
Default: | nt |
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 "nt" etc.
FAKEHOST
Type | boolean |
Default: | TRUE |
This enables the FAKEHOST command used for fake hosts (duh).
DEFAULT_FAKEHOST
Type | string |
Default: | NULL |
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: | FALSE |
This enables the /SETHOST
command and user mode +h for opers activating Sethosts.
SETHOST_USER
Type | boolean |
Default: | FALSE |
This enabled the /SETHOST
command and user mode +h for users activating Sethosts with passwords.
SETHOST_AUTO
Type | boolean |
Default: | FALSE |
This enables the automatic application of Sethosts on matching idents and hosts.
SETHOST_FREEFORM
Type | boolean |
Default: | FALSE |
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 of 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 | string |
Default: | Bots |
Defines the class a bot must be on to be able to use +B bot mode.
NOTE: On DareNET, users in this class will also be exempted from /LIST
restrictions. Intended for IRC search crawlers (e.g. SearchIRC, netsplit.de, etc).
OPERMOTD
Type | boolean |
Default: | FALSE |
Controls the use of the OPERMOTD command.
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.
CREATE_CHAN_ACC_ONLY
Type | boolean |
Default: | FALSE |
Only users authenticated to a services account will be able to create new channels.
RESTARTPASS
Type | string |
Default: | NULL |
This is the password required for a server to actually restart when the RESTART command is used. If the password is empty then no password is required.
DIEPASS
Type | string |
Default: | NULL |
This is the password required for a server to actually die when the DIE command is used. 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: | TRUE |
Enables DNS blacklist checks controlled via X:Lines.
DNSBL_EXEMPT_CLASS
Type | string |
Default: | DNSBL_exempt |
Anyone in this class is immune to DNSBL checks if they are enabled.
HIS_IRCOPS
Type | boolean |
Default: | FALSE |
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 |
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 |
This removes server notices from users entirely.
HIS_SNOTICES_OPER_ONLY
Type | boolean |
Default: | TRUE |
This prevents users from receiving server notices.
HIS_SNOTICES_OPER_AND_BOT
Type | boolean |
Default: | FALSE |
This removes server notices from non-opers and non-+B users.
HIS_DESYNCS
Type | boolean |
Default: | TRUE |
This removes the ability for users to see desynch notices.
HIS_DEBUG_OPER_ONLY
Type | boolean |
Default: | TRUE |
This removes the ability for users to see debug notices.
HIS_WALLOPS
Type | boolean |
Default: | TRUE |
This removes operator wallops from users. They can still see wallusers.
HIS_LINKS
Type | boolean |
Default: | TRUE |
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 |
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_WELCOMES
Type | boolean |
Default: | TRUE |
This removes /STATS A
from users.
HIS_STATS_FORWARDS
Type | boolean |
Default: | TRUE |
This removes /STATS b
from users.
HIS_STATS_MAPPINGS
Type | boolean |
Default: | TRUE |
This removes /STATS B
from users.
HIS_STATS_LINKS
Type | boolean |
Default: | TRUE |
This removes /STATS l
from users.
HIS_STATS_MODULES
Type | boolean |
Default: | TRUE |
This removes /STATS L
from users.
HIS_STATS_CONNECT
Type | boolean |
Default: | TRUE |
This removes /STATS c
from users.
HIS_STATS_GLINES
Type | boolean |
Default: | TRUE |
This removes /STATS g
from users.
HIS_STATS_KLINES
Type | boolean |
Default: | TRUE |
This removes /STATS k
from users.
HIS_STATS_FILTERS
Type | boolean |
Default: | TRUE |
This removes /STATS f
from users.
HIS_STATS_FEATURES
Type | boolean |
Default: | TRUE |
This removes <code/STATS F</code> from users.
HIS_STATS_ACCESS
Type | boolean |
Default: | TRUE |
This removes /STATS i
from users.
HIS_STATS_HISTOGRAM
Type | boolean |
Default: | TRUE |
This removes /STATS j
from users.
HIS_STATS_JUPES
Type | boolean |
Default: | TRUE |
This removes /STATS J
from users.
HIS_STATS_COMMANDS
Type | boolean |
Default: | TRUE |
This removes /STATS m
from users.
HIS_STATS_OPERATORS
Type | boolean |
Default: | TRUE |
This removes /STATS o
from users.
HIS_STATS_PORTS
Type | boolean |
Default: | TRUE |
This removes /STATS p
from users.
HIS_STATS_QUARAUNTINES
Type | boolean |
Default: | TRUE |
This removes /STATS q
from users.
HIS_STATS_USAGE
Type | boolean |
Default: | TRUE |
This removes /STATS r
from users.
HIS_STATS_REDIRECTIONS
Type | boolean |
Default: | TRUE |
This removes /STATS R
from users.
HIS_STATS_CRULES
Type | boolean |
Default: | TRUE |
This removes /STATS d
from users.
HIS_STATS_EXCEPTIONS
Type | boolean |
Default: | TRUE |
This removes /STATS E
from users.
HIS_STATS_ENGINE
Type | boolean |
Default: | TRUE |
This removes /STATS e
from users.
HIS_STATS_SPOOFHOSTS
Type | boolean |
Default: | TRUE |
This removes /STATS s
from users.
HIS_STATS_SHUNS
Type | boolean |
Default: | TRUE |
This removes /STATS S
from users.
HIS_STATS_LOCALS
Type | boolean |
Default: | TRUE |
This removes /STATS t
from users.
HIS_STATS_MOTDS
Type | boolean |
Default: | TRUE |
This removes /STATS T
from users.
HIS_STATS_UPTIME
Type | boolean |
Default: | TRUE |
This removes /STATS u
from users.
HIS_STATS_UWORLD
Type | boolean |
Default: | TRUE |
This removes /STATS U
from users.
HIS_STATS_VSERVERS
Type | boolean |
Default: | TRUE |
This removes /STATS v
from users.
HIS_STATS_USERLOAD
Type | boolean |
Default: | TRUE |
This removes /STATS w
from users.
HIS_STATS_WEBIRCS
Type | boolean |
Default: | TRUE |
This removes /STATS W
from users.
HIS_STATS_MEMUSAGE
Type | boolean |
Default: | TRUE |
This removes /STATS x
from users.
HIS_STATS_DNSBLS
Type | boolean |
Default: | TRUE |
This removes /STATS X
from users.
HIS_STATS_CLASSES
Type | boolean |
Default: | TRUE |
This removes /STATS y
from users.
HIS_STATS_MEMORY
Type | boolean |
Default: | TRUE |
This removes /STATS z
from users.
HIS_STATS_ZLINES
Type | boolean |
Default: | TRUE |
This removes /STATS Z
from users.
HIS_WHOIS_SERVERNAME
- Type: boolean
- Default: TRUE
This removes server names in replies to /WHOIS
.
HIS_WHOIS_IDLETIME
- Type: boolean
- Default: TRUE
This removes idle time in replies to /WHOIS
.
HIS_WHOIS_LOCALCHAN
- Type: boolean
- Default: TRUE
This removes local channels in replies to /WHOIS
.
HIS_WHO_SERVERNAME
- Type: boolean
- Default: TRUE
This removes server names in replies to /WHO
.
HIS_WHO_HOPCOUNT
- Type: boolean
- Default: TRUE
This replaces hopcount to a static 3 in replies to /WHO
.
HIS_BANWHO
- Type: boolean
- Default: TRUE
This doesn't show which server set a ban.
HIS_EXCEPTWHO
- Type: boolean
- Default: TRUE
This doesn't show which server set an except.
HIS_KILLWHO
- Type: boolean
- Default: TRUE
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
This remaps remote numerics to come from the local server.
HIS_GLINE
- Type: boolean
- Default: TRUE
This will hide the user who performed 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
This disallows remote queries from non-opers. (*sob!*)
HIS_USERIP
- Type: boolean
- Default: FALSE
This will hide the IP of a user in the output of a USERIP
command. The real IP will be shown for opers.
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
This removes server names in net break sign-offs. Instead they are shown as (*.net *.split).
HIS_SERVERNAME
- Type: string
- Default: "*.darenet.org"
This is the "name" of the server shown to users on a /WHOIS
of another user.
HIS_SERVERINFO
- Type: string
- Default: "DareNET Client Server"
This is the "info" of the server shown to users on a /WHOIS
of another user.
HIS_URLSERVERS
- Type: string
- Default: "http://www.darenet.org/servers"
This is the URL shown to users when they do a /MAP
or /LINKS
.
NETWORK
- Type: string
- Default: "DareNET"
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://wiki.darenet.org/index.php/IRC_Clients"
This defines a URL that users may visit to find compatible IRC clients.
BADUSER_URL
- Type: string
- Default: "http://wiki.darenet.org/index.php/Why_do_I_get_error_Bad_Username"
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.
MAX_CHECK_OUTPUT
- Type: integer
- Default: 1000
The maximum results in a /CHECK
response.
SWHOIS
- Type: boolean
- Default: TRUE
Allows the IRCd to accept SWHOIS
commands from services.
HOST_HIDING_KEY1
- Type: string
- Default: aoAr1HnR6gl3sJ7hVz4Zb7x4YwpW
One of the 3 unique host hiding keys used to encrypt style 2 hidden hosts. These must all be different.
HOST_HIDING_KEY2
- Type: string
- Default: sdfjkLJKHlkjdkfjsdklfjlkjKLJ
One of the 3 unique host hiding keys used to encrypt style 2 hidden hosts. These must all be different.
HOST_HIDING_KEY3
- Type: string
- Default: KJklJSDFLkjLKDFJSLKjlKJFlkjS
One of the 3 unique host hiding keys used to encrypt style 2 hidden hosts. These must all be different.
CTCP_VERSIONING
- Type: boolean
- Default: FALSE
Enables CTCP versioning for clients on connect.
CTCP_VERSIONING_KILL
- Type: boolean
- Default: FALSE
Kills clients who match specified versions.
CTCP_VERSIONING_CHAN
- Type: boolean
- Default: FALSE
If enabled version replies will be sent to the channel set for CTCP_VERSIONING_CHANNAME
CTCP_VERSIONING_CHANNAME
- Type: string
- Default: #opers
Channel where version replies are sent to if CTCP_VERSIONING_CHAN is enabled (See above).
CTCP_VERSIONING_USEMSG
- Type: boolean
- Default: FALSE
If enabled version replies sent to the channel set for CTCP_VERSIONING_CHANNAME will be sent using privmsgs instead of notices.
CTCP_VERSIONING_NOTICE
- Type: string
- Default: *** Checking your client version
Message sent to clients during the versioning process on connect.
DEF_ALIST_LIMIT
- Type: integer
- Default: 30
Maximum responses allowed in a ALIST search output.
ALIST_SEND_FREQ
- Type: integer
- Default: 300
How often (in seconds) ALIST updates are checked across the server.
ALIST_SEND_DIFF
- Type: integer
- Default: 600
If the last message for the channel is over the current time minus to setting for ALIST_SEND_DIFF then an ALIST update will be sent out to other servers.
EXEMPT_EXPIRE
- Type: integer
- Default: 172800
If no one has triggered an exempt within this amount of time (in seconds) then the exempt will expire.
STRICTUSERNAME
- Type: boolean
- Default: TRUE
If enabled then strict ident/username rules will be applied.
ZLINEMAXUSERCOUNT
- Type: integer
- Default: 20
Maximum amount of users a Z:line can affect when a Z:line is set via /ZLINE
. Zlines set via services or servers will not be affected by this rule.
NICK_DELAY
- Type: integer
- Default: 30
How often a user can change thier nick (in seconds).
HELP_PACE
- Type: integer
- Default: 5
How often a user can request /HELP (in seconds).
IPCHECK
- Type: boolean
- Default: TRUE
Controls the clone and throttle detection system in ircd-darenet. If you disable this then the maximum setting in I-lines will not have any effect. You would need to use clone detection systems in the services you use.
LUSERS_AUTHED
- Type: boolean
- Default: TRUE
If enabled a count of logged in users (e.g., authed to N) will be shown in /LUSERS
.
SHUNMAXUSERCOUNT
- Type: integer
- Default: 20
Maximum amount of users a Shun can affect when a shun is set via /SHUN
. Shuns set via services or servers will not be affected by this rule.
OPER_WHOIS_PARANOIA
- Type: boolean
- Default: TRUE
Allows the use of the W opermode which will show /WHOIS
attempts to opers when they are done on themselves. (*ugh*)
HIS_SHUN_REASON
- Type: boolean
- Default: TRUE
Will prevent the reason from being shown to a user if enabled.
HIS_USERSHUN
- Type: boolean
- Default: TRUE
Will prevent normal users from getting shun lists via /SHUN
if enabled.
HIS_ZLINE
- Type: boolean
- Default: TRUE
This will hide the user who issued the zline in the zline message when enabled.
HIS_USERZLINE
- Type: boolean
- Default: TRUE
Will prevent normal users from getting zline lists via /ZLINE
if enabled.
HIS_ZLINE_REASON
- Type: boolean
- Default: TRUE
Will prevent the reason from being shown to a user if enabled.
IDENT_CHALLENGE
- Type: boolean
- Default: FALSE
If enabled, and a user does not have ident enabled or the server is unable to retrieve a successful response for whatever reason, the user will be challenged with a cookie prompt, similar to the following:
*** Ident broken or disabled, to continue to connect you must type /QUOTE PASS 1623745
GLINE_URL
Type | string |
Default: | http://www.darenet.org/gline |
Defines the URL shown, in addition to the G-line reason given, when a G-lined user tries to connect.
ANTI_SPAMBOT
Type | boolean |
Default: | FALSE |
Enable/disable spam bot checking.
ANTI_DRONE_FLOOD
Type | boolean |
Default: | FALSE |
Enable/disable channel/message flood checking.
OPER_BYPASS_CALLERID
Type | boolean |
Default: | FALSE |
If TRUE, IRC operators will always be able to send private messages/notices to users who have callerid (umode +g) enabled, regardless if they are on the user's ACCEPT list or not.
NETCHAN_NOTICE
Type | boolean |
Default: | FALSE |
If TRUE, the server will send a notice to users when they join a channel marked as being network-owned. The actual notice sent is defined in NETCHAN_NOTICE_MSG.
NETCHAN_NOTICE_MSG
Type | string |
Default: | is an official network channel. |
Defines the actual notice sent to users when NETCHAN_NOTICE is enabled.