ViewVC Help

View File | Revision Log | Show Annotations | View Changeset | Root Listing

root/svn/ircd-hybrid/trunk/doc/reference.conf

Comparing ircd-hybrid/trunk/doc/reference.conf (file contents):
Revision 1851 by michael, Wed Apr 24 18:31:06 2013 UTC vs.
Revision 7006 by michael, Fri Jan 1 00:07:54 2016 UTC

#	Line 1 | Line 1
1	<	/* ircd-hybrid reference configuration file
2	<	* Copyright (C) 2000-2013 Hybrid Development Team
1	>	/*
2	>	* This is an example configuration file for ircd-hybrid
3		*
4	<	* Written by ejb, wcampbel, db, leeh and others
4	>	* Copyright (c) 2000-2016 ircd-hybrid development team
5		*
6		* $Id$
7		*/
8
9		/*
10		* ########################################################################
11	<	* IMPORTANT NOTES:
11	>	* IMPORTANT NOTE:
12		*
13	<	* auth {} blocks MUST be specified in order of precedence.  The first one
14	<	* that matches a user will be used.  So place spoofs first, then specials,
13	>	* auth {} blocks MUST be specified in order of precedence. The first one
14	>	* that matches a user will be used. So place spoofs first, then specials,
15		* then general access.
16		* ########################################################################
17		*
#	Line 23 | Line 23
23		*
24		* Times/durations are written as:
25		*        12 hours 30 minutes 1 second
26	<	*
26	>	*
27		* Valid units of time:
28		*        year, month, week, day, hour, minute, second
29		*
30		* Valid units of size:
31		*        megabyte/mbyte/mb, kilobyte/kbyte/kb, byte
32		*
33	<	* Sizes and times may be singular or plural.
34	<	*/
33	>	* Sizes and times may be singular or plural.
34	>	*/
35
36
37		/*
#	Line 39 | Line 39
39		*/
40		serverinfo {
41		/*
42	<	* name: the name of this server.  This cannot be changed at runtime.
42	>	* name: the name of this server. This cannot be changed at runtime.
43		*/
44	<	name = "hades.arpa";
44	>	name = "server.example.net";
45
46		/*
47	<	* sid: a server's unique ID.  This is three characters long and must
48	<	* be in the form [0-9][A-Z0-9][A-Z0-9].  The first character must be
47	>	* sid: a server's unique ID. This is three characters long and must
48	>	* be in the form [0-9][A-Z0-9][A-Z0-9]. The first character must be
49		* a digit, followed by 2 alpha-numerical letters.
50	<	* NOTE: The letters must be capitalized.  This cannot be changed at runtime.
50	>	*
51	>	* NOTE: The letters must be capitalized. This cannot be changed at runtime.
52	>	*
53	>	* A sid is automatically generated at runtime, if you want to configure
54	>	* a specific sid, uncomment the following line.
55		*/
56	<	sid = "0HY";
56	>	#       sid = "0HY";
57
58		/*
59		* description: the description of the server.
#	Line 57 | Line 61 | serverinfo {
61		description = "ircd-hybrid test server";
62
63		/*
64	<	* network info: the name and description of the network this server
65	<	* is on.  Shown in the 005 reply and used with serverhiding.
64	>	* network_name, network_desc: the name and description of the network this
65	>	* server is on. Shown in the 005 reply and used with serverhiding.
66		*/
67		network_name = "MyNet";
68		network_desc = "This is My Network";
#	Line 70 | Line 74 | serverinfo {
74		hub = no;
75
76		/*
77	<	* vhost: the IP to bind to when we connect outward to ipv4 servers.
78	<	* This should be an ipv4 IP only, or "*" for INADDR_ANY.
77	>	* vhost: the IP address to bind to when we connect outward to IPv4 servers.
78	>	* This should be an IPv4 address, or "*" for INADDR_ANY.
79		*/
80	<	#vhost = "192.169.0.1";
80	>	#       vhost = "192.0.2.1";
81
82		/*
83	<	* vhost6: the IP to bind to when we connect outward to ipv6 servers.
84	<	* This should be an ipv6 IP only, or "*" for INADDR_ANY.
83	>	* vhost6: the IP address to bind to when we connect outward to IPv6 servers.
84	>	* This should be an IPv6 address, or "*" for in6addr_any.
85		*/
86	<	#vhost6 = "3ffe:80e8:546::2";
86	>	#       vhost6 = "2001:DB8::1";
87
88	<	/* max_clients: the maximum number of clients allowed to connect */
89	<	max_clients = 512;
88	>	/*
89	>	* default_max_clients: the default maximum number of clients allowed
90	>	* to connect. This can be changed from within IRC via /QUOTE SET MAX.
91	>	*/
92	>	default_max_clients = 512;
93
94		/*
95		* max_nick_length: only applies to local clients. Must be in the
#	Line 98 | Line 105 | serverinfo {
105		max_topic_length = 160;
106
107		/*
108	<	* rsa_private_key_file: the path to the file containing our
109	<	* rsa key for cryptlink.
108	>	* rsa_private_key_file: the path to the file containing the
109	>	* RSA key. RSA keys with less than 2048 bits are no longer
110	>	* supported.
111	>	*
112	>	* Example commands to store a 2048 bit RSA key in rsa.key:
113		*
114	<	* Example command to store a 2048 bit RSA keypair in
115	<	* rsa.key, and the public key in rsa.pub:
116	<	*
107	<	*      openssl genrsa -out rsa.key 2048
108	<	*      openssl rsa -in rsa.key -pubout -out rsa.pub
109	<	*      chown <ircd-user>.<ircd.group> rsa.key rsa.pub
110	<	*      chmod 0600 rsa.key
111	<	*      chmod 0644 rsa.pub
114	>	*    openssl genrsa -out rsa.key 2048
115	>	*    chown <ircd-user>.<ircd.group> rsa.key
116	>	*    chmod 0600 rsa.key
117		*/
118	<	#rsa_private_key_file = "/usr/local/ircd/etc/rsa.key";
118	>	#       rsa_private_key_file = "etc/rsa.key";
119
120		/*
121		* ssl_certificate_file: the path to the file containing our
122	<	* ssl certificate for encrypted client connection.
122	>	* SSL certificate for encrypted client connection.
123		*
124		* This assumes your private RSA key is stored in rsa.key. You
125	<	* MUST have an RSA key in order to generate the certificate
125	>	* MUST have an RSA key in order to generate the certificate.
126		*
127	<	*      openssl req -new -days 365 -x509 -key rsa.key -out cert.pem
127	>	* Example command:
128		*
129	<	* See http://www.openssl.org/docs/HOWTO/certificates.txt
129	>	*    openssl req -new -days 365 -x509 -key rsa.key -out cert.pem
130		*
131		* Please use the following values when generating the cert
132		*
133	<	*      Organization Name: Network Name
134	<	*      Organization Unit Name: changme.someirc.net
135	<	*      Common Name: irc.someirc.net
136	<	*      E-mail: you@domain.com
133	>	*    Organization Name: Network Name
134	>	*    Organization Unit Name: unit.example.net
135	>	*    Common Name: irc.example.net
136	>	*    E-mail: email@example.net
137		*/
138	<	#ssl_certificate_file = "/usr/local/ircd/etc/cert.pem";
138	>	#       ssl_certificate_file = "etc/cert.pem";
139
140		/*
141	<	* ssl_dh_param_file:
142	<	*
143	<	* Path to the PEM encoded Diffie-Hellman parameter file.
139	<	* DH parameters are strictly required when using ciphers
140	<	* with EDH (ephemeral Diffie-Hellman) key exchange.
141	>	* ssl_dh_param_file: path to the PEM encoded Diffie-Hellman
142	>	* parameter file. DH parameters are required when using
143	>	* ciphers with EDH (ephemeral Diffie-Hellman) key exchange.
144		*
145		* A DH parameter file can be created by running:
146		*
147	<	*      openssl dhparam -out dhparam.pem 1024
147	>	*    openssl dhparam -out dhparam.pem 2048
148		*
149	<	* Prime size must be at least 1024 bits. Further information
149	>	* Prime size must be at least 2048 bits. Further information
150		* regarding specific OpenSSL dhparam command-line options
151		* can be found in the OpenSSL manual.
152		*/
153	<	#ssl_dh_param_file = "/usr/local/ircd/etc/dhparam.pem";
153	>	#       ssl_dh_param_file = "etc/dhparam.pem";
154
155		/*
156	<	* ssl_cipher_list:
156	>	* ssl_dh_elliptic_curve: defines the curve to use for the
157	>	* Elliptic Curve Diffie-Hellman (ECDH) algorithm.
158	>	* Default is ANSI X9.62 prime256v1/secp256r1 if nothing else is specified.
159		*
160	<	* List of ciphers that are supported by _this_ server. Can be used to
156	<	* enforce specific ciphers for incoming SSL/TLS connections.
157	<	* If a client (which also includes incoming server connections) isn't
158	<	* capable of any cipher listed below, the connection will simply be
159	<	* rejected.
160	>	* A list of supported curves by OpenSSL can be obtained by running:
161		*
162	<	* A list of supported ciphers can be obtained by running:
162	>	*    openssl ecparam -list_curves
163	>	*/
164	>	#       ssl_dh_elliptic_curve = "secp521r1";
165	>
166	>	/*
167	>	* ssl_cipher_list: list of ciphers to support on _this_ server.
168	>	* Can be used to enforce specific ciphers for incoming SSL/TLS
169	>	* connections. If a client (which also includes incoming server connections)
170	>	* is not capable of using any of the ciphers listed here, the connection will
171	>	* simply be rejected.
172	>	*
173	>	* A list of supported ciphers by OpenSSL can be obtained by running:
174		*
175	<	*      openssl ciphers -ssl3 -tls1 -v
175	>	*    openssl ciphers -tls1 -v
176		*
177		* Multiple ciphers are separated by colons. The order of preference is
178		* from left to right.
179		*/
180	<	#ssl_cipher_list = "DHE-RSA-AES256-SHA:AES256-SHA";
180	>	#       ssl_cipher_list = "ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES256-SHA:AES256-SHA";
181
182		/*
183	<	* ssl_server_method:
184	<	* ssl_client_method:
183	>	* ssl_message_digest_algorithm: defines what cryptographic hash function
184	>	* to use for generating fingerprint hashes of X.509 certificates.
185	>	* Default is SHA-256 if nothing else is specified.
186		*
187	<	* SSL/TLS methods we provide for incoming (server method) and
188	<	* outgoing (client method) SSL/TLS connections.
189	<	* This can be either sslv3 for SSLv3, and/or tlsv1 for TLSv1.
187	>	* A list of supported message digest algorithms by OpenSSL can be obtained by running:
188	>	*
189	>	*    openssl list-message-digest-algorithms
190		*/
191	<	#ssl_server_method = tlsv1, sslv3;
179	<	#ssl_client_method = tlsv1;
191	>	#       ssl_message_digest_algorithm = "sha256";
192		};
193
194		/*
195	<	* admin {}:  contains admin information about the server
195	>	* admin {}:  contains administrative information about the server
196		*/
197		admin {
198		name = "Smurf target";
199		description = "Main Server Administrator";
200	<	email = "<syn@packets.r.us>";
200	>	email = "<admin@server.example.net>";
201		};
202
203		/*
204		* class {}:  contains information about classes for users
205		*/
206		class {
207	<	/* name: the name of the class */
207	>	/* name: the name of the class. */
208		name = "users";
209
210		/*
#	Line 203 | Line 215 | class {
215
216		/*
217		* number_per_ip: how many local users are allowed to connect
218	<	* from one IP  (optional)
218	>	* from a single IP address (optional)
219		*/
220		number_per_ip = 2;
221
222		/*
223		* max_local: how many local users are allowed to connect
224	<	* from one ident@host  (optional)
224	>	* from a single ident@host (optional)
225		*/
226		max_local = 2;
227
228		/*
229	<	* max_global: network-wide limit of users per ident@host  (optional)
229	>	* max_global: network-wide limit of users per ident@host (optional)
230		*/
231		max_global = 10;
232
#	Line 224 | Line 236 | class {
236		max_number = 100;
237
238		/*
239	<	* the following lines are optional and allow you to define
240	<	* how many users can connect from one /NN subnet
239	>	* The following lines are optional and allow you to define
240	>	* how many users can connect from one /NN subnet.
241		*/
242		cidr_bitlen_ipv4 = 24;
243		cidr_bitlen_ipv6 = 120;
244		number_per_cidr = 16;
245
246		/*
247	<	* sendq: the amount of data allowed in a clients send queue before
247	>	* sendq: the amount of data allowed in a client's send queue before
248		* they are dropped.
249		*/
250		sendq = 100 kbytes;
251
252		/*
253	<	* recvq: maximum amount of data in a clients receive queue before
254	<	* they are dropped for flooding. Defaults to 2560 if the chosen
255	<	* value isn't within the range of 512 to 8000.
253	>	* recvq: the amount of data allowed in a client's receive queue before
254	>	* they are dropped for flooding. Defaults to 2560 if the chosen value
255	>	* isn't within the range of 512 to 8000.
256		*/
257		recvq = 2560 bytes;
258		};
#	Line 253 | Line 265 | class {
265		sendq = 100 kbytes;
266
267		/*
268	<	* min_idle: minimum idle time that is shown in /whois
268	>	* max_channels: maximum number of channels users in this class can join.
269	>	*/
270	>	max_channels = 60;
271	>
272	>	/*
273	>	* min_idle: minimum idle time that is shown in WHOIS.
274		*/
275		min_idle = 3 hours;
276
277		/*
278	<	* max_idle: maximum idle time that is shown in /whois
278	>	* max_idle: maximum idle time that is shown in WHOIS.
279		*/
280		max_idle = 8 hours;
281
282		/*
283		* flags:
284		*
285	<	* random_idle          - idle time is randomly selected within the
286	<	*                        range of min_idle to max_idle
287	<	* hide_idle_from_opers - fake idle time will be shown to operators, too
285	>	* random_idle          - a fake idle time is set randomly between
286	>	*                        min_idle and max_idle
287	>	* hide_idle_from_opers - the fake idle time will also be shown to operators
288		*/
289		flags = random_idle, hide_idle_from_opers;
290		};
#	Line 277 | Line 294 | class {
294		ping_time = 90 seconds;
295
296		/*
297	<	* connectfreq: only used in server classes.  Specifies the delay
297	>	* connectfreq: only used in server classes. Specifies the delay
298		* between autoconnecting to servers.
299		*/
300		connectfreq = 5 minutes;
301
302	<	/* max number: the amount of servers to autoconnect to */
302	>	/* max number: the number of servers to autoconnect to. */
303		max_number = 1;
304
305	<	/* sendq: servers need a higher sendq as they send more data */
305	>	/* sendq: servers need a higher sendq as they send more data. */
306		sendq = 2 megabytes;
307		};
308
309		/*
310	+	* motd {}: Allows the display of a different MOTD to a client
311	+	* depending on its origin. Applies to local users only.
312	+	*/
313	+	motd {
314	+	/*
315	+	* mask: multiple mask entries are permitted. Mask can either be
316	+	* a class name or a hostname. CIDR is supported.
317	+	*/
318	+	mask = "*.at";
319	+	mask = "*.de";
320	+	mask = "*.ch";
321	+
322	+	/*
323	+	* file: path to the actual motd file.
324	+	*/
325	+	file = "etc/german.motd";
326	+	};
327	+
328	+	/*
329		* listen {}:  contains information about the ports ircd listens on
330		*/
331		listen {
332		/*
333	<	* port: the specific port to listen on.  If no host is specified
334	<	* before, it will listen on all available IPs.
333	>	* port: the port to listen on. If no host is specified earlier in the
334	>	* listen {} block, it will listen on all available IP addresses.
335		*
336	<	* Ports are separated via a comma, a range may be specified using ".."
336	>	* Ports are separated by commas; a range may be specified using ".."
337		*/
338	<
339	<	/* port: listen on all available IPs, ports 6665 to 6669 */
338	>
339	>	/* port: listen on all available IP addresses, ports 6665 to 6669. */
340		port = 6665 .. 6669;
341
342		/*
343	<	* Listen on 192.168.0.1/6697 with ssl enabled and hidden from STATS P
343	>	* Listen on 192.0.2.2/6697 with SSL enabled and hidden from STATS P
344		* unless you are an administrator.
345		*
346	<	* NOTE: The "flags" directive has to come before "port".  Always!
346	>	* NOTE: The "flags" directive always has to come before "port".
347		*
348		* Currently available flags are:
349		*
#	Line 316 | Line 352 | listen {
352		*  hidden - Port is hidden from /stats P, unless you're an admin
353		*/
354		flags = hidden, ssl;
355	<	host = "192.168.0.1";
355	>	host = "192.0.2.2";
356		port = 6697;
357
358		/*
359	<	* host: set a specific IP/host the ports after the line will listen
360	<	* on.  This may be ipv4 or ipv6.
359	>	* host: set a specific IP address to listen on using the
360	>	* subsequent port definitions. This may be IPv4 or IPv6.
361		*/
362	<	host = "1.2.3.4";
362	>	host = "192.0.2.3";
363		port = 7000, 7001;
364
365	<	host = "3ffe:1234:a:b:c::d";
365	>	host = "2001:DB8::2";
366		port = 7002;
367		};
368
#	Line 336 | Line 372 | listen {
372		auth {
373		/*
374		* user: the user@host allowed to connect. Multiple user
375	<	* lines are permitted per auth block.
375	>	* lines are permitted within each auth {} block.
376		*/
377	<	user = "*@172.16.0.0/12";
378	<	user = "*test@123D:B567:*";
377	>	user = "*@192.0.2.0/24";
378	>	user = "*test@2001:DB8:*";
379
380	<	/* password: an optional password that is required to use this block */
380	>	/* password: an optional password that is required to use this block. */
381		password = "letmein";
382
383		/*
384		* encrypted: controls whether the auth password above has been
385	<	* encrypted.
385	>	* encrypted. Default is 'no' if nothing else is specified.
386		*/
387		encrypted = yes;
388
389		/*
390	<	* spoof: fake the users host to this.  This is free-form,
391	<	* just do everyone a favor and don't abuse it. ('=' prefix on /stats I)
390	>	* spoof: fake the user's host to this. This is free-form, just do
391	>	* everyone a favor and don't abuse it. ('=' prefix on /stats I)
392		*/
393		spoof = "I.still.hate.packets";
394
395	<	/* class: the class the user is placed in */
395	>	/* class: the class the user is placed in. */
396		class = "opers";
397
398		/*
399	<	* need_password - don't allow users who haven't supplied the correct
400	<	*                 password to connect using another auth{} block
401	<	*                 ('&' prefix on /stats I if disabled)
366	<	* need_ident    - require the user to have identd to connect ('+' prefix on /stats I)
399	>	* need_password - don't allow users who haven't supplied the correct  | ('&' prefix on /stats I if disabled)
400	>	*                 password to connect using another auth {} block
401	>	* need_ident    - require the user to have identd to connect          | ('+' prefix on /stats I)
402		* spoof_notice  - enable spoofing notification to admins
403	<	* exceed_limit  - allow a user to exceed class limits ('>' prefix on /stats I)
404	<	* kline_exempt  - exempt this user from k/glines ('^' prefix on /stats I)
405	<	* gline_exempt  - exempt this user from glines ('_' prefix on /stats I)
406	<	* resv_exempt   - exempt this user from resvs ('$' prefix on /stats I)
407	<	* no_tilde      - remove ~ from a user with no ident ('-' prefix on /stats I)
408	<	* can_flood     - allow this user to exceed flood limits ('|' prefix on /stats I)
409	<	* webirc        - enables WEBIRC authentication for web-based clients such as Mibbit
410	<	*                 ('<' prefix on /stats I)
403	>	* exceed_limit  - allow a user to exceed class limits                 | ('>' prefix on /stats I)
404	>	* kline_exempt  - exempt this user from k-lines                       | ('^' prefix on /stats I)
405	>	* xline_exempt  - exempt this user from x-lines                       | ('!' prefix on /stats I)
406	>	* resv_exempt   - exempt this user from resvs                         | ('$' prefix on /stats I)
407	>	* no_tilde      - remove ~ from a user with no ident                  | ('-' prefix on /stats I)
408	>	* can_flood     - allow this user to exceed flood limits              | ('|' prefix on /stats I)
409	>	* webirc        - enables WEBIRC authentication for web-based         | ('<' prefix on /stats I)
410	>	*                 clients such as Mibbit
411		*/
412		flags = need_password, spoof_notice, exceed_limit, kline_exempt,
413	<	gline_exempt, resv_exempt, no_tilde, can_flood;
413	>	xline_exempt, resv_exempt, no_tilde, can_flood;
414		};
415
416		auth {
417		/*
418	<	* redirect: the server and port to redirect a user to.  A user does
419	<	* not have to obey the redirection, the ircd just suggests an alternative
420	<	* server for them.
418	>	* redirserv, redirport: the server and port to redirect a user to.
419	>	* A user does not have to obey the redirection; the ircd just
420	>	* suggests an alternative server for them.
421		*/
422	<	redirserv = "this.is.not.a.real.server";
422	>	redirserv = "server2.example.net";
423		redirport = 6667;
389	–
390	–	user = "*.server";
424
425	<	/* class: a class is required even though it is not used */
425	>	user = "*@*.ch";
426	>
427	>	/* class: a class is required even though it is not used. */
428		class = "users";
429		};
430
#	Line 401 | Line 436 | auth {
436
437		/*
438		* operator {}:  defines ircd operators
404	–	*
405	–	* ircd-hybrid no longer supports local operators, privileges are
406	–	* controlled via flags.
439		*/
440		operator {
441	<	/* name: the name of the oper */
441	>	/* name: the name of the operator */
442		name = "sheep";
443
444		/*
445	<	* user: the user@host required for this operator. Multiple
446	<	* user="" lines are supported.
445	>	* user: the user@host required for this operator. Multiple user
446	>	* lines are permitted within each operator {} block.
447		*/
448	<	user = "*sheep@192.168.0.0/16";
449	<	user = "*@127.0.0.0/8";
448	>	user = "*sheep@192.0.2.0/26";
449	>	user = "*@192.0.2.240/28";
450
451		/*
452	<	* password: the password required to oper.  By default this will
453	<	* need to be encrypted by using the provided mkpasswd tool.
454	<	* Several password hash algorithms are available depending
455	<	* on your system's crypt() implementation. For example, a modern
424	<	* glibc already has support for SHA-256/512, and MD5 encryption
425	<	* algorithms.
452	>	* password: the password required to oper. By default this will need
453	>	* to be encrypted by using the provided mkpasswd tool.
454	>	* The availability of various password hashing algorithms may vary
455	>	* depending on the system's crypt(3) implementation.
456		*/
457		password = "$5$x5zof8qe.Yc7/bPp$5zIg1Le2Lsgd4CvOjaD20pr5PmcfD7ha/9b2.TaUyG4";
458
459		/*
460		* encrypted: controls whether the oper password above has been
461	<	* encrypted.
461	>	* encrypted. Default is 'yes' if nothing else is specified.
462		*/
463		encrypted = yes;
464
465		/*
466	<	* rsa_public_key_file: the public key for this oper when using Challenge.
467	<	* A password should not be defined when this is used, see
468	<	* doc/challenge.txt for more information.
466	>	* ssl_certificate_fingerprint: enhances security by additionally checking
467	>	* the oper's client certificate fingerprint against the specified
468	>	* fingerprint below.
469	>	*
470	>	* Hint: your users can use the following command to obtain a SHA-256 hash
471	>	* of their ssl certificate:
472	>	*
473	>	*    openssl x509 -sha256 -noout -fingerprint -in cert.pem | sed -e 's/^.*=//;s/://g'
474		*/
475	<	#       rsa_public_key_file = "/usr/local/ircd/etc/oper.pub";
475	>	#       ssl_certificate_fingerprint = "4C62287BA6776A89CD4F8FF10A62FFB35E79319F51AF6C62C674984974FCCB1D";
476
477	<	/* class: the class the oper joins when they successfully /oper */
477	>	/*
478	>	* ssl_connection_required: client must be connected over SSL/TLS
479	>	* in order to be able to use this operator {} block.
480	>	* Default is 'no' if nothing else is specified.
481	>	*/
482	>	ssl_connection_required = no;
483	>
484	>	/* class: the class the oper joins when they successfully OPER. */
485		class = "opers";
486
487		/*
488	<	* umodes: default usermodes opers get when they /oper.  If defined,
489	<	* it will override oper_umodes settings in general {}.
490	<	* Available usermodes:
488	>	* whois: allows to override the default RPL_WHOISOPERATOR numeric
489	>	* string shown in /whois.
490	>	* This string is propagated to all servers on the network.
491	>	*/
492	>	#       whois = "is a Smurf Target (IRC Operator)";
493	>
494	>	/*
495	>	* umodes: the default user modes opers get when they successfully OPER.
496	>	* If defined, it will override oper_umodes settings in general {}.
497	>	* Available user modes:
498		*
499		* +b - bots         - See bot and drone flooding notices
500		* +c - cconn        - Client connection/quit notices
452	–	* +C - cconn_full   - Client connection/quit notices full
501		* +D - deaf         - Don't receive channel messages
502		* +d - debug        - See debugging notices
503		* +e - external     - See remote server connection and split notices
504	<	* +f - full         - See auth{} block full notices
504	>	* +F - farconnect   - Remote client connection/quit notices
505	>	* +f - full         - See auth {} block full notices
506		* +G - softcallerid - Server Side Ignore for users not on your channels
507		* +g - callerid     - Server Side Ignore (for privmsgs etc)
508		* +H - hidden       - Hides operator status to other users
509	<	* +i - invisible    - Not shown in NAMES or WHO unless you share a
461	<	*                     a channel
509	>	* +i - invisible    - Not shown in NAMES or WHO unless you share a channel
510		* +j - rej          - See rejected client notices
511		* +k - skill        - See server generated KILL messages
512		* +l - locops       - See LOCOPS messages
513		* +n - nchange      - See client nick changes
514	+	* +p - hidechans    - Hides channel list in WHOIS
515	+	* +q - hideidle     - Hides idle and signon time in WHOIS
516	+	* +R - nononreg     - Only receive private messages from registered clients
517		* +s - servnotice   - See general server notices
518		* +u - unauth       - See unauthorized client notices
519		* +w - wallop       - See server generated WALLOPS
520		* +y - spy          - See LINKS, STATS, TRACE notices etc.
470	–	* +z - operwall     - See oper generated WALLOPS
521		*/
522	<	#       umodes = locops, servnotice, operwall, wallop;
522	>	umodes = locops, servnotice, wallop;
523
524		/*
525	<	* privileges: controls the activities and commands an oper is
526	<	* allowed to do on the server. All options default to no.
527	<	* Available options:
528	<	*
529	<	* module       - allows MODULE
530	<	* global_kill  - allows remote users to be /KILL'd
531	<	* remote       - allows remote SQUIT and CONNECT
532	<	* remoteban    - allows remote KLINE/UNKLINE
533	<	* dline        - allows DLINE
534	<	* undline      - allows UNDLINE
535	<	* kline        - allows KILL and KLINE
536	<	* unkline      - allows UNKLINE
537	<	* gline        - allows GLINE
538	<	* xline        - allows XLINE
539	<	* globops      - allows GLOBOPS
540	<	* operwall     - allows OPERWALL
541	<	* nick_changes - allows oper to see nickchanges via usermode +n
542	<	* rehash       - allows oper to REHASH config
543	<	* die          - allows DIE
544	<	* restart      - allows RESTART
545	<	* set          - allows SET
546	<	* admin        - gives admin privileges. admins for example,
547	<	*                may see the real IP addresses of servers.
525	>	* flags: controls the activities and commands an oper is
526	>	* allowed to do on the server. All flags default to 'no'.
527	>	* Available flags:
528	>	*
529	>	* admin          - gives administrator privileges      | ('A' flag)
530	>	* close          - allows CLOSE                        | ('B' flag)
531	>	* connect        - allows local CONNECT                | ('C' flag)
532	>	* connect:remote - allows remote CONNECT               | ('D' flag)
533	>	* die            - allows DIE                          | ('E' flag)
534	>	* dline          - allows DLINE                        | ('F' flag)
535	>	* globops        - allows GLOBOPS                      | ('G' flag)
536	>	* join:resv      - allows to JOIN resv {} channels     | ('H' flag)
537	>	* kill           - allows to KILL local clients        | ('I' flag)
538	>	* kill:remote    - allows remote users to be /KILL'd   | ('J' flag)
539	>	* kline          - allows KLINE                        | ('K' flag)
540	>	* locops         - allows LOCOPS                       | ('L' flag)
541	>	* module         - allows MODULE                       | ('M' flag)
542	>	* nick:resv      - allows to use NICK on resv {} nicks | ('N' flag)
543	>	* opme           - allows OPME                         | ('O' flag)
544	>	* rehash         - allows oper to REHASH config        | ('P' flag)
545	>	* remoteban      - allows remote KLINE/UNKLINE         | ('Q' flag)
546	>	* restart        - allows RESTART                      | ('R' flag)
547	>	* resv           - allows RESV                         | ('S' flag)
548	>	* set            - allows SET                          | ('T' flag)
549	>	* squit          - allows local SQUIT                  | ('U' flag)
550	>	* squit:remote   - allows remote SQUIT                 | ('V' flag)
551	>	* undline        - allows UNDLINE                      | ('W' flag)
552	>	* unkline        - allows UNKLINE                      | ('X' flag)
553	>	* unresv         - allows UNRESV                       | ('Y' flag)
554	>	* unxline        - allows UNXLINE                      | ('Z' flag)
555	>	* wallops        - allows WALLOPS                      | ('a' flag)
556	>	* xline          - allows XLINE                        | ('b' flag)
557		*/
558	<	flags = global_kill, remote, kline, unkline, xline, globops, restart,
559	<	die, rehash, nick_changes, admin, operwall, module;
501	<	};
502	<
503	<	/*
504	<	* service {}: specifies what server may act as a network service
505	<	*
506	<	* NOTE: it is absolutely important that every single server on the network
507	<	*       has the same service{} block.
508	<	*/
509	<	service {
510	<	name = "service.someserver";
511	<	name = "stats.someserver";
558	>	flags = admin, connect, connect:remote, die, globops, kill, kill:remote,
559	>	kline, module, rehash, restart, set, unkline, unxline, xline;
560		};
561
562		/*
563	<	* connect {}:  controls servers we connect to
563	>	* connect {}: define a server to connect to
564		*/
565		connect {
566	<	/* name: the name of the server */
567	<	name = "irc.uplink.com";
566	>	/* name: the name of the server. */
567	>	name = "uplink.example.net";
568
569		/*
570	<	* host: the host or IP to connect to.  If a hostname is used it
571	<	* must match the reverse dns of the server.
570	>	* host: the host or IP address to connect to. If a hostname is used it
571	>	* must match the reverse DNS of the server.
572		*/
573	<	host = "192.168.0.1";
573	>	host = "192.0.2.4";
574
575		/*
576	<	* vhost: the IP to bind to when we connect outward to servers.
576	>	* vhost: the IP address to bind to when making outgoing connections to
577	>	* servers.
578		* serverinfo::vhost and serverinfo::vhost6 will be overridden
579		* by this directive.
580		*/
581	<	vhost = "192.168.0.2";
581	>	vhost = "192.0.2.5";
582
583		/*
584	<	* passwords: the passwords we send (OLD C:) and accept (OLD N:).
585	<	* The remote server will have these passwords reversed.
584	>	* send_password, accept_password: the passwords to send and accept.
585	>	* The remote server will have these passwords swapped.
586		*/
587		send_password = "password";
588		accept_password = "anotherpassword";
#	Line 544 | Line 593 | connect {
593		*/
594		encrypted = no;
595
596	<	/* port: the port to connect to this server on */
596	>	/* port: the port to connect to this server on. */
597		port = 6666;
598
599		/*
600	<	* hub_mask: the mask of servers that this server may hub.  Multiple
601	<	* entries are permitted
600	>	* hub_mask: the mask of servers that this server may hub. Multiple
601	>	* entries are permitted.
602		*/
603		hub_mask = "*";
604
605		/*
606	<	* leaf_mask: the mask of servers this server may not hub.  Multiple
607	<	* entries are permitted.  Useful for forbidding EU -> US -> EU routes.
606	>	* leaf_mask: the mask of servers this server may not hub. Multiple
607	>	* entries are permitted. Useful for forbidding EU -> US -> EU routes.
608		*/
609		#       leaf_mask = "*.uk";
610
611	<	/* class: the class this server is in */
611	>	/* class: the class this server is in. */
612		class = "server";
613
614		/*
615	<	* ssl_cipher_list:
616	<	*
617	<	* List of ciphers that the server we are connecting to must support.
569	<	* If the server isn't capable of any cipher listed below, the
570	<	* connection will simply be rejected.
615	>	* ssl_cipher_list: list of ciphers that the server we are connecting to
616	>	* must support. If the server is not capable of using any of the ciphers
617	>	* listed below, the connection will simply be rejected.
618		* Can be used to enforce stronger ciphers, even though this option
619		* is not necessarily required to establish a SSL/TLS connection.
620		*
621		* Multiple ciphers are separated by colons. The order of preference
622		* is from left to right.
623		*/
624	<	#ssl_cipher_list = "DHE-RSA-AES256-SHA:AES256-SHA";
624	>	#       ssl_cipher_list = "ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES256-SHA:AES256-SHA";
625	>
626	>	/*
627	>	* ssl_certificate_fingerprint: enhances security by additionally checking
628	>	* the server's client certificate fingerprint against the specified
629	>	* fingerprint below.
630	>	*/
631	>	#       ssl_certificate_fingerprint = "4C62287BA6776A89CD4F8FF10A62FFB35E79319F51AF6C62C674984974FCCB1D";
632
633		/*
634		* autoconn   - controls whether we autoconnect to this server or not,
#	Line 585 | Line 639 | connect {
639		};
640
641		connect {
642	<	name = "ipv6.some.server";
643	<	host = "3ffd:dead:beef::1";
642	>	name = "ipv6.example.net";
643	>	host = "2001:DB8::3";
644		send_password = "password";
645		accept_password = "password";
646		port = 6666;
#	Line 605 | Line 659 | connect {
659		*/
660		cluster {
661		/*
662	<	* name: the server to share with, this can take wildcards
662	>	* name: the server to share with; this can take wildcards
663		*
664	<	* NOTE: only local actions will be clustered, meaning if
664	>	* NOTE: only local actions will be clustered, meaning that if
665		*       the server receives a shared kline/unkline/etc, it
666		*       will not be propagated to clustered servers.
667		*
668		*       Remote servers are not necessarily required to accept
669	<	*       clustered lines, they need a shared{} for *THIS* server
670	<	*       in order to accept them.
669	>	*       clustered lines, they need a shared {} block for *THIS*
670	>	*       server in order to accept them.
671		*/
672	<	name = "*.arpa";
672	>	name = "*.example.net";
673
674		/*
675	<	* type: list of what to share, options are as follows:
675	>	* type: list of what to share; options are as follows:
676		*      dline   - share dlines
677		*      undline - share undlines
678		*      kline   - share klines
#	Line 636 | Line 690 | cluster {
690		/*
691		* shared {}: users that are allowed to remote kline
692		*
693	<	* NOTE: This can be effectively used for remote klines.
693	>	* NOTE: This can effectively be used for remote klines.
694		*       Please note that there is no password authentication
695	<	*       for users setting remote klines.  You must also be
695	>	*       for users setting remote klines. You must also be
696		*       /oper'd in order to issue a remote kline.
697		*/
698		shared {
699		/*
700	<	* name: the server the user must be on to set klines.  If this is not
701	<	* specified, the user will be allowed to kline from all servers.
700	>	* name: the server the user must be connected to in order to set klines.
701	>	* If this is not specified, the user will be allowed to kline from all
702	>	* servers.
703		*/
704	<	name = "irc2.some.server";
704	>	name = "irc2.example.net";
705
706		/*
707	<	* user: the user@host mask that is allowed to set klines.  If this is
707	>	* user: the user@host mask that is allowed to set klines. If this is
708		* not specified, all users on the server above will be allowed to set
709		* a remote kline.
710		*/
#	Line 673 | Line 728 | shared {
728
729		/*
730		* kill {}:  users that are not allowed to connect
731	<	* Oper issued klines will be added to the specified kline config
731	>	* Oper issued klines will be added to the specified kline database
732		*/
733		kill {
734	<	user = "bad@*.hacked.edu";
734	>	user = "bad@*.example.net";
735		reason = "Obviously hacked account";
736		};
737
683	–	kill {
684	–	user = "^O[[:alpha:]]?[[:digit:]]+(x\.o|\.xo)$@^[[:alnum:]]{4}\.evilnet.tld$";
685	–
686	–	/*
687	–	* NOTE: You have to set type=regex; when using a regular expression
688	–	* based user entry
689	–	*/
690	–	type = regex;
691	–	};
692	–
738		/*
739	<	* deny {}:  IPs that are not allowed to connect (before DNS/ident lookup)
740	<	* Oper issued dlines will be added to the specified dline config
739	>	* deny {}:  IP addresses that are not allowed to connect
740	>	* (before DNS/ident lookup)
741	>	* Oper issued dlines will be added to the specified dline database
742		*/
743		deny {
744	<	ip = "10.0.1.0/24";
744	>	ip = "192.0.2.0/28";
745		reason = "Reconnecting vhosted bots";
746		};
747
748		/*
749	<	* exempt {}: IPs that are exempt from deny {} and Dlines
749	>	* exempt {}:  IP addresses that are exempt from deny {} and Dlines
750		*/
751		exempt {
752	<	ip = "192.168.0.0/16";
752	>	ip = "192.0.2.240/28";
753		};
754
755		/*
756		* resv {}:  nicks and channels users may not use/join
757		*/
758	<	resv { nick = "clone*"; reason = "Clone bots"; };
759	<	resv { nick = "NickServ"; reason = "Reserved for services"; };
760	<	resv { nick = "OperServ"; reason = "Reserved for services"; };
761	<	resv { nick = "MemoServ"; reason = "Reserved for services"; };
762	<	resv { nick = "BotServ"; reason = "Reserved for services"; };
763	<	resv { nick = "HelpServ"; reason = "Reserved for services"; };
764	<	resv { nick = "HostServ"; reason = "Reserved for services"; };
765	<	resv { nick = "StatServ"; reason = "Reserved for services"; };
766	<	resv { channel = "#*services*"; reason = "Reserved for services"; };
758	>	resv { mask = "clone*"; reason = "Clone bots"; };
759	>	resv { mask = "Global"; reason = "Reserved for services"; };
760	>	resv { mask = "ChanServ"; reason = "Reserved for services"; };
761	>	resv { mask = "NickServ"; reason = "Reserved for services"; };
762	>	resv { mask = "OperServ"; reason = "Reserved for services"; };
763	>	resv { mask = "MemoServ"; reason = "Reserved for services"; };
764	>	resv { mask = "BotServ"; reason = "Reserved for services"; };
765	>	resv { mask = "HelpServ"; reason = "Reserved for services"; };
766	>	resv { mask = "HostServ"; reason = "Reserved for services"; };
767	>	resv { mask = "StatServ"; reason = "Reserved for services"; };
768	>	resv { mask = "#*services*"; reason = "Reserved for services"; };
769	>
770	>	resv {
771	>	/*
772	>	* mask: masks starting with a '#' are automatically considered
773	>	* as channel name masks.
774	>	*/
775	>	mask = "#helsinki";
776	>	reason = "Channel is reserved for Finnish inhabitants";
777	>
778	>	/*
779	>	* exempt: can be either a ISO 3166 alpha-2 two letter country
780	>	* code, or a nick!user@host mask. CIDR is supported. Exempt
781	>	* entries can be stacked.
782	>	*/
783	>	exempt = "FI";
784	>	};
785
786		/*
787	<	* gecos {}:  The X: replacement, used for banning users based on
724	<	* their "realname".
787	>	* gecos {}:  used for banning users based on their "realname".
788		*/
789		gecos {
790		name = "*sex*";
#	Line 733 | Line 796 | gecos {
796		reason = "Trojan drone";
797		};
798
799	<	gecos {
800	<	name = "^\[J[0o]hn Do[3e]\]-[0-9]{2,5}$";
799	>	/*
800	>	* service {}: specifies a server which may act as a network service
801	>	*
802	>	* NOTE: it is very important that every server on the network
803	>	*       has the same service {} block.
804	>	*/
805	>	service {
806	>	name = "service.example.net";
807	>	name = "stats.example.net";
808	>	};
809
810	<	/*
811	<	* NOTE: You have to set type=regex; when using a regular expression
812	<	* based name entry
813	<	*/
814	<	type = regex;
810	>	/*
811	>	* pseudo {}: adds pseudo/custom commands also known as service aliases
812	>	*/
813	>	pseudo {
814	>	/* command: the actual command/alias. */
815	>	command = "IDENTIFY";
816	>
817	>	/* prepend: optional text that can be prepended before the user's message. */
818	>	prepend = "IDENTIFY ";
819	>
820	>	/* name: the service name, used for error messages. */
821	>	name = "NickServ";
822	>
823	>	/* target: the actual target where this message should be sent to. */
824	>	target = "NickServ@service.example.net";
825	>	};
826	>
827	>	pseudo {
828	>	command = "CHANSERV";
829	>	name = "ChanServ";
830	>	target = "ChanServ@service.example.net";
831	>	};
832	>
833	>	pseudo {
834	>	command = "CS";
835	>	name = "ChanServ";
836	>	target = "ChanServ@service.example.net";
837	>	};
838	>
839	>	pseudo {
840	>	command = "NICKSERV";
841	>	name = "NickServ";
842	>	target = "NickServ@service.example.net";
843	>	};
844	>
845	>	pseudo {
846	>	command = "NS";
847	>	name = "NickServ";
848	>	target = "NickServ@service.example.net";
849	>	};
850	>
851	>	pseudo {
852	>	command = "MEMOSERV";
853	>	name = "MemoServ";
854	>	target = "MemoServ@service.example.net";
855	>	};
856	>
857	>	pseudo {
858	>	command = "MS";
859	>	name = "MemoServ";
860	>	target = "MemoServ@service.example.net";
861	>	};
862	>
863	>	pseudo {
864	>	command = "OPERSERV";
865	>	name = "OperServ";
866	>	target = "OperServ@service.example.net";
867	>	};
868	>
869	>	pseudo {
870	>	command = "OS";
871	>	name = "OperServ";
872	>	target = "OperServ@service.example.net";
873	>	};
874	>
875	>	pseudo {
876	>	command = "HOSTSERV";
877	>	name = "HostServ";
878	>	target = "HostServ@service.example.net";
879	>	};
880	>
881	>	pseudo {
882	>	command = "HS";
883	>	name = "HostServ";
884	>	target = "HostServ@service.example.net";
885	>	};
886	>
887	>	pseudo {
888	>	command = "BOTSERV";
889	>	name = "BotServ";
890	>	target = "BotServ@service.example.net";
891	>	};
892	>
893	>	pseudo {
894	>	command = "BS";
895	>	name = "BotServ";
896	>	target = "BotServ@service.example.net";
897		};
898
899		/*
900	<	* channel {}:  The channel block contains options pertaining to channels
900	>	* channel {}:  the channel block contains options pertaining to channels
901		*/
902		channel {
903		/*
904		* disable_fake_channels: this option, if set to 'yes', will
905	<	* disallow clients to create or join channels that have one
905	>	* disallow clients from creating or joining channels that have one
906		* of the following ASCII characters in their name:
907		*
908		*   2 | bold
#	Line 763 | Line 916 | channel {
916		disable_fake_channels = yes;
917
918		/*
919	<	* restrict_channels: reverse channel RESVs logic, only reserved
920	<	* channels are allowed
919	>	* invite_client_count, invite_client_time: how many INVITE commands
920	>	* are permitted per client per invite_client_time.
921		*/
922	<	restrict_channels = no;
922	>	invite_client_count = 10;
923	>	invite_client_time = 5 minutes;
924
925		/*
926	<	* knock_delay: The amount of time a user must wait between issuing
927	<	* the knock command.
926	>	* invite_delay_channel: how often an INVITE to any specific channel
927	>	* is permitted, regardless of the user sending the INVITE.
928		*/
929	<	knock_delay = 5 minutes;
929	>	invite_delay_channel = 5 seconds;
930
931		/*
932	<	* knock_delay_channel: How often a knock to any specific channel
933	<	* is permitted, regardless of the user sending the knock.
932	>	* knock_client_count, knock_client_time: how many KNOCK commands
933	>	* are permitted per client per knock_client_time.
934		*/
935	<	knock_delay_channel = 1 minute;
935	>	knock_client_count = 1;
936	>	knock_client_time = 5 minutes;
937
938		/*
939	<	* max_chans_per_user: The maximum number of channels a user can
940	<	* join/be on.
939	>	* knock_delay_channel: how often a KNOCK to any specific channel
940	>	* is permitted, regardless of the user sending the KNOCK.
941		*/
942	<	max_chans_per_user = 25;
942	>	knock_delay_channel = 1 minute;
943
944		/*
945	<	* max_chans_per_oper: The maximum number of channels an oper can
946	<	* join/be on.
945	>	* max_channels: the maximum number of channels a user can join/be on.
946	>	* This is a default value which can be overriden with class {} blocks.
947		*/
948	<	max_chans_per_oper = 50;
794	<
795	<	/* quiet_on_ban: stop banned people talking in channels. */
796	<	quiet_on_ban = yes;
948	>	max_channels = 25;
949
950	<	/* max_bans: maximum number of +b/e/I modes in a channel */
950	>	/* max_bans: maximum number of +b/e/I modes in a channel. */
951		max_bans = 100;
952
953		/*
954	<	* how many joins in how many seconds constitute a flood, use 0 to
955	<	* disable. +b opers will be notified (changeable via /set)
956	<	*/
957	<	join_flood_count = 16;
806	<	join_flood_time = 8 seconds;
807	<
808	<	/*
809	<	* splitcode: The ircd will now check splitmode every few seconds.
810	<	*
811	<	* Either split users or split servers can activate splitmode, but
812	<	* both conditions must be met for the ircd to deactivate splitmode.
813	<	*
814	<	* You may force splitmode to be permanent by /quote set splitmode on
815	<	*/
816	<
817	<	/*
818	<	* default_split_user_count: when the usercount is lower than this level,
819	<	* consider ourselves split.  This must be set for automatic splitmode.
954	>	* default_join_flood_count, default_join_flood_time:
955	>	* how many joins in how many seconds constitute a flood. Use 0 to disable.
956	>	* +b opers will be notified. These are only default values which can be
957	>	* changed via "/QUOTE SET JFLOODCOUNT" and "/QUOTE SET JFLOODTIME".
958		*/
959	<	default_split_user_count = 0;
960	<
823	<	/*
824	<	* default_split_server_count: when the servercount is lower than this,
825	<	* consider ourselves split.  This must be set for automatic splitmode.
826	<	*/
827	<	default_split_server_count = 0;
828	<
829	<	/* no_create_on_split: disallow users creating channels on split. */
830	<	no_create_on_split = yes;
831	<
832	<	/* no_join_on_split: disallow users joining channels at all on a split. */
833	<	no_join_on_split = no;
959	>	default_join_flood_count = 18;
960	>	default_join_flood_time = 6 seconds;
961		};
962
963		/*
964	<	* serverhide {}:  The serverhide block contains the options regarding
965	<	* serverhiding
964	>	* serverhide {}:  the serverhide block contains the options regarding
965	>	* to server hiding. For more information regarding server hiding,
966	>	* please see doc/serverhide.txt
967		*/
968		serverhide {
969		/*
970	+	* disable_remote_commands: disable users issuing commands
971	+	* on remote servers.
972	+	*/
973	+	disable_remote_commands = no;
974	+
975	+	/*
976		* flatten_links: this option will show all servers in /links appear
977	<	* that they are linked to this current server
977	>	* as though they are linked to this current server.
978		*/
979		flatten_links = no;
980
981		/*
982	<	* links_delay: how often to update the links file when it is
982	>	* flatten_links_delay: how often to update the links file when it is
983		* flattened.
984		*/
985	<	links_delay = 5 minutes;
985	>	flatten_links_delay = 5 minutes;
986	>
987	>	/*
988	>	* flatten_links_file: path to the flatten links cache file.
989	>	*/
990	>	flatten_links_file = "var/lib/links.txt";
991
992		/*
993		* hidden: hide this server from a /links output on servers that
994	<	* support it.  This allows hub servers to be hidden etc.
994	>	* support it. This allows hub servers to be hidden etc.
995		*/
996		hidden = no;
997
#	Line 862 | Line 1001 | serverhide {
1001		*/
1002		hide_servers = no;
1003
865	–
1004		/*
1005		* hide_services: define this if you want to hide the location of
1006	<	* services servers thar are specified service{} block.
1006	>	* services servers that are specified in the service {} block.
1007		*/
1008		hide_services = no;
1009
1010		/*
1011	<	* Use this as the servername users see if hide_servers = yes.
1011	>	* hidden_name: use this as the servername users see if hide_servers = yes.
1012		*/
1013	<	hidden_name = "*.hidden.com";
1013	>	hidden_name = "*.example.net";
1014
1015		/*
1016	<	* hide_server_ips: If this is disabled, opers will be unable to see
1017	<	* servers ips and will be shown a masked ip, admins will be shown the
1018	<	* real ip.
1016	>	* hide_server_ips: if this is disabled, opers will be unable to see
1017	>	* servers' IP addresses and will be shown a masked IP address; admins
1018	>	* will be shown the real IP address.
1019		*
1020	<	* If this is enabled, nobody can see a servers ip. *This is a kludge*,
1021	<	* it has the side effect of hiding the ips everywhere, including
1022	<	* logfiles.
1020	>	* If this is enabled, nobody can see a server's IP address.
1021	>	* *This is a kludge*: it has the side effect of hiding the IP addresses
1022	>	* everywhere, including logfiles.
1023		*
1024		* We recommend you leave this disabled, and just take care with who you
1025		* give administrator privileges to.
#	Line 890 | Line 1028 | serverhide {
1028		};
1029
1030		/*
1031	<	* general {}:  The general block contains many of the options that were once
1031	>	* general {}:  the general block contains many of the options that were once
1032		* compiled in options in config.h
1033		*/
1034		general {
1035	<	/* services_name: servername of nick/channel services */
1036	<	services_name = "service.someserver";
1035	>	/*
1036	>	* cycle_on_host_change: sends a fake QUIT/JOIN combination
1037	>	* when services change the hostname of a specific client.
1038	>	*/
1039	>	cycle_on_host_change = yes;
1040
1041		/* max_watch: maximum WATCH entries a client can have. */
1042	<	max_watch = 60;
1042	>	max_watch = 50;
1043
1044	<	/* gline_enable: enable glines, network wide temp klines */
1045	<	gline_enable = yes;
1044	>	/* max_accept: maximum allowed /accept's for +g user mode. */
1045	>	max_accept = 50;
1046
1047		/*
1048	<	* gline_duration: the amount of time a gline will remain on your
1049	<	* server before expiring
1048	>	* dline_min_cidr: the minimum required length of a CIDR bitmask
1049	>	* for IPv4 based D-lines.
1050		*/
1051	<	gline_duration = 1 day;
1051	>	dline_min_cidr = 16;
1052
1053		/*
1054	<	* gline_request_duration:  how long a pending G-line can be around.
1055	<	* 10 minutes should be plenty
1054	>	* dline_min_cidr6: the minimum required length of a CIDR bitmask
1055	>	* for IPv6 based D-lines.
1056		*/
1057	<	gline_request_duration = 10 minutes;
1057	>	dline_min_cidr6 = 48;
1058
1059		/*
1060	<	* gline_min_cidr: the minimum required length of a CIDR bitmask
1061	<	* for IPv4 based glines
1060	>	* kline_min_cidr: the minimum required length of a CIDR bitmask
1061	>	* for IPv4 based K-lines.
1062		*/
1063	<	gline_min_cidr = 16;
1063	>	kline_min_cidr = 16;
1064
1065		/*
1066	<	* gline_min_cidr6: the minimum required length of a CIDR bitmask
1067	<	* for IPv6 based glines
1066	>	* kline_min_cidr6: the minimum required length of a CIDR bitmask
1067	>	* for IPv6 based K-lines.
1068		*/
1069	<	gline_min_cidr6 = 48;
1069	>	kline_min_cidr6 = 48;
1070
1071		/*
1072	<	* Whether to automatically set mode +i on connecting users.
1072	>	* invisible_on_connect: whether to automatically set user mode +i
1073	>	* on connecting users.
1074		*/
1075		invisible_on_connect = yes;
1076
1077		/*
1078	<	* Max time from the nickname change that still causes KILL
1079	<	* automatically to switch for the current nick of that user.
1078	>	* kill_chase_time_limit: KILL chasing is a feature whereby a KILL
1079	>	* issued for a user who has recently changed nickname will be applied
1080	>	* automatically to the new nick. kill_chase_time_limit is the maximum
1081	>	* time following a nickname change that this chasing will apply.
1082		*/
1083	<	kill_chase_time_limit = 90 seconds;
1083	>	kill_chase_time_limit = 30 seconds;
1084
1085		/*
1086	<	* If hide_spoof_ips is disabled, opers will be allowed to see the real
1087	<	* IP of spoofed users in /trace etc. If this is defined they will be
1088	<	* shown a masked IP.
945	<	*/
946	<	hide_spoof_ips = yes;
947	<
948	<	/*
949	<	* Ignore bogus timestamps from other servers.  Yes, this will desync
950	<	* the network, but it will allow chanops to resync with a valid non TS 0
1086	>	* ignore_bogus_ts: ignore bogus timestamps from other servers.
1087	>	* Yes, this will desync the network, but it will allow chanops
1088	>	* to resync with a valid non TS 0.
1089		*
1090		* This should be enabled network wide, or not at all.
1091		*/
#	Line 955 | Line 1093 | general {
1093
1094		/*
1095		* disable_auth: completely disable ident lookups; if you enable this,
1096	<	* be careful of what you set need_ident to in your auth {} blocks
1096	>	* be careful of what you set need_ident to in your auth {} blocks.
1097		*/
1098		disable_auth = no;
1099
962	–	/* disable_remote_commands: disable users doing commands on remote servers */
963	–	disable_remote_commands = no;
964	–
1100		/*
1101		* tkline_expire_notices: enables or disables temporary kline/xline
1102		* expire notices.
#	Line 970 | Line 1105 | general {
1105
1106		/*
1107		* default_floodcount: the default value of floodcount that is configurable
1108	<	* via /quote set floodcount.  This is the amount of lines a user
1109	<	* may send to any other user/channel in one second.
1108	>	* via /quote set floodcount. This is the number of lines a user may send
1109	>	* to any other user/channel in one second. Set to 0 to disable.
1110		*/
1111		default_floodcount = 10;
1112
1113		/*
1114	<	* failed_oper_notice: send a notice to all opers on the server when
1114	>	* failed_oper_notice: send a notice to all opers on the server when
1115		* someone tries to OPER and uses the wrong password, host or ident.
1116		*/
1117		failed_oper_notice = yes;
1118
1119		/*
1120	<	* dots_in_ident: the amount of '.' characters permitted in an ident
1120	>	* dots_in_ident: the number of '.' characters permitted in an ident
1121		* reply before the user is rejected.
1122		*/
1123		dots_in_ident = 2;
1124
1125		/*
1126	<	* min_nonwildcard: the minimum non wildcard characters in k/d/g lines
1127	<	* placed via the server.  klines hand placed are exempt from limits.
1128	<	* wildcard chars: '.' ':' '*' '?' '@' '!' '#'
1126	>	* min_nonwildcard: the minimum number of non-wildcard characters in
1127	>	* k/d lines placed via the server. K-lines hand-placed are exempt from
1128	>	* this limit.
1129	>	* Wildcard characters: '.', ':', '*', '?'
1130		*/
1131		min_nonwildcard = 4;
1132
1133		/*
1134	<	* min_nonwildcard_simple: the minimum non wildcard characters in
1135	<	* gecos bans.  wildcard chars: '*' '?' '#'
1134	>	* min_nonwildcard_simple: the minimum number of non-wildcard characters
1135	>	* in gecos bans. Wildcard characters: '*', '?'
1136		*/
1137		min_nonwildcard_simple = 3;
1138
1139	<	/* max_accept: maximum allowed /accept's for +g usermode */
1004	<	max_accept = 20;
1005	<
1006	<	/* anti_nick_flood: enable the nickflood control code */
1139	>	/* anti_nick_flood: enable the nickflood control code. */
1140		anti_nick_flood = yes;
1141
1142	<	/* nick flood: the nick changes allowed in the specified period */
1143	<	max_nick_time = 20 seconds;
1142	>	/*
1143	>	* max_nick_changes, max_nick_time: the number of nick changes allowed in
1144	>	* the specified period.
1145	>	*/
1146		max_nick_changes = 5;
1147	+	max_nick_time = 20 seconds;
1148	+
1149	+	/*
1150	+	* away_count, away_time: how many AWAY command are permitted per
1151	+	* client per away_time.
1152	+	*/
1153	+	away_count = 2;
1154	+	away_time = 10 seconds;
1155
1156		/*
1157		* anti_spam_exit_message_time: the minimum time a user must be connected
#	Line 1017 | Line 1160 | general {
1160		anti_spam_exit_message_time = 5 minutes;
1161
1162		/*
1163	<	* ts delta: the time delta allowed between server clocks before
1164	<	* a warning is given, or before the link is dropped.  all servers
1165	<	* should run ntpdate/rdate to keep clocks in sync
1163	>	* ts_warn_delta, ts_max_delta: the time delta allowed between server
1164	>	* clocks before a warning is given, or before the link is dropped.
1165	>	* All servers should run ntpdate/rdate to keep clocks in sync.
1166		*/
1167	<	ts_warn_delta = 30 seconds;
1168	<	ts_max_delta = 5 minutes;
1167	>	ts_warn_delta = 3 seconds;
1168	>	ts_max_delta = 15 seconds;
1169
1170		/*
1171	<	* warn_no_nline: warn opers about servers that try to connect but
1172	<	* we don't have a connect {} block for.  Twits with misconfigured
1173	<	* servers can get really annoying with this enabled.
1171	>	* warn_no_connect_block: warn opers about servers that try to connect
1172	>	* but for which we don't have a connect {} block. Twits with
1173	>	* misconfigured servers can become really annoying with this enabled.
1174		*/
1175	<	warn_no_nline = yes;
1175	>	warn_no_connect_block = yes;
1176
1177		/*
1178		* stats_e_disabled: set this to 'yes' to disable "STATS e" for both
1179	<	* operators and administrators.  Doing so is a good idea in case
1180	<	* there are any exempted (exempt{}) server IPs you don't want to
1181	<	* see leaked.
1179	>	* operators and administrators. Doing so is a good idea in case
1180	>	* there are any exempted (exempt {}) server IP addresses you don't
1181	>	* want to see leaked.
1182		*/
1183		stats_e_disabled = no;
1184
1185	<	/* stats_o_oper only: make stats o (opers) oper only */
1185	>	/* stats_m_oper_only: make /stats m/M (messages) oper only. */
1186	>	stats_m_oper_only = yes;
1187	>
1188	>	/* stats_o_oper_only: make stats o (opers) oper only. */
1189		stats_o_oper_only = yes;
1190
1191	<	/* stats_P_oper_only: make stats P (ports) oper only */
1191	>	/* stats_P_oper_only: make stats P (ports) oper only. */
1192		stats_P_oper_only = yes;
1193
1194	+	/* stats_u_oper_only: make stats u (uptime) oper only. */
1195	+	stats_u_oper_only = no;
1196	+
1197		/*
1198	<	* stats i oper only: make stats i (auth {}) oper only. set to:
1199	<	*     yes:    show users no auth blocks, made oper only.
1200	<	*     masked: show users first matching auth block
1201	<	*     no:     show users all auth blocks.
1198	>	* stats_i_oper_only: make stats i (auth {}) oper only. Set to:
1199	>	*     yes    - show users no auth {} blocks, made oper only
1200	>	*     masked - show users the first matching auth {} block
1201	>	*     no     - show users all auth {} blocks
1202		*/
1203		stats_i_oper_only = yes;
1204
1205		/*
1206	<	* stats_k_oper_only: make stats k/K (klines) oper only.  set to:
1207	<	*     yes:    show users no auth blocks, made oper only
1208	<	*     masked: show users first matching auth block
1209	<	*     no:     show users all auth blocks.
1206	>	* stats_k_oper_only: make stats k/K (klines) oper only. Set to:
1207	>	*     yes    - show users no klines, made oper only
1208	>	*     masked - show users the first matching kline
1209	>	*     no     - show users all klines
1210		*/
1211		stats_k_oper_only = yes;
1212
#	Line 1069 | Line 1218 | general {
1218
1219		/*
1220		* opers_bypass_callerid: allows operators to bypass +g and message
1221	<	* anyone who has it set (useful if you use services).
1221	>	* anyone who has it set.
1222		*/
1223		opers_bypass_callerid = no;
1224
1225		/*
1226	<	* pace_wait_simple: time between use of less intensive commands
1227	<	* (ADMIN, HELP, (L)USERS, VERSION, remote WHOIS)
1226	>	* pace_wait_simple: minimum time required between use of less
1227	>	* intensive commands
1228	>	* (ADMIN, HELP, LUSERS, VERSION, remote WHOIS)
1229		*/
1230		pace_wait_simple = 1 second;
1231
1232		/*
1233	<	* pace_wait: time between more intensive commands
1234	<	* (AWAY, INFO, LINKS, MAP, MOTD, STATS, WHO, wildcard WHOIS, WHOWAS)
1233	>	* pace_wait: minimum time required between use of more intensive commands
1234	>	* (INFO, LINKS, MAP, MOTD, STATS, WHO, WHOWAS)
1235		*/
1236		pace_wait = 10 seconds;
1237
1238		/*
1239	<	* short_motd: send clients a notice telling them to read the motd
1240	<	* instead of forcing a motd to clients who may simply ignore it.
1239	>	* short_motd: send clients a notice telling them to read the MOTD
1240	>	* instead of forcing an MOTD to clients who may simply ignore it.
1241		*/
1242		short_motd = no;
1243
1244		/*
1245	<	* ping_cookie: require clients to respond exactly to a ping command,
1245	>	* ping_cookie: require clients to respond exactly to a PING command,
1246		* can help block certain types of drones and FTP PASV mode spoofing.
1247		*/
1248		ping_cookie = no;
#	Line 1101 | Line 1251 | general {
1251		no_oper_flood = yes;
1252
1253		/*
1254	<	* true_no_oper_flood: completely eliminate flood limits for opers
1255	<	* and for clients with can_flood = yes in their auth {} blocks
1106	<	*/
1107	<	true_no_oper_flood = yes;
1108	<
1109	<	/* oper_pass_resv: allow opers to over-ride RESVs on nicks/channels */
1110	<	oper_pass_resv = yes;
1111	<
1112	<	/* REMOVE ME.  The following line checks you've been reading. */
1113	<	havent_read_conf = 1;
1114	<
1115	<	/*
1116	<	* max_targets: the maximum amount of targets in a single
1117	<	* PRIVMSG/NOTICE.  Set to 999 NOT 0 for unlimited.
1254	>	* max_targets: the maximum number of targets in a single
1255	>	* PRIVMSG/NOTICE. Set to 999 NOT 0 for unlimited.
1256		*/
1257		max_targets = 4;
1258
1259		/*
1260	<	* usermodes configurable: a list of usermodes for the options below
1260	>	* user modes configurable: a list of user modes for the options below
1261		*
1262		* +b - bots         - See bot and drone flooding notices
1263		* +c - cconn        - Client connection/quit notices
1126	–	* +C - cconn_full   - Client connection/quit notices full
1264		* +D - deaf         - Don't receive channel messages
1265		* +d - debug        - See debugging notices
1266		* +e - external     - See remote server connection and split notices
1267	<	* +f - full         - See auth{} block full notices
1267	>	* +F - farconnect   - Remote client connection/quit notices
1268	>	* +f - full         - See auth {} block full notices
1269		* +G - softcallerid - Server Side Ignore for users not on your channels
1270		* +g - callerid     - Server Side Ignore (for privmsgs etc)
1271		* +H - hidden       - Hides operator status to other users
1272	<	* +i - invisible    - Not shown in NAMES or WHO unless you share a
1135	<	*                     a channel
1272	>	* +i - invisible    - Not shown in NAMES or WHO unless you share a channel
1273		* +j - rej          - See rejected client notices
1274		* +k - skill        - See server generated KILL messages
1275		* +l - locops       - See LOCOPS messages
1276		* +n - nchange      - See client nick changes
1277	+	* +p - hidechans    - Hides channel list in WHOIS
1278	+	* +q - hideidle     - Hides idle and signon time in WHOIS
1279	+	* +R - nononreg     - Only receive private messages from registered clients
1280		* +s - servnotice   - See general server notices
1281		* +u - unauth       - See unauthorized client notices
1282		* +w - wallop       - See server generated WALLOPS
1283		* +y - spy          - See LINKS, STATS, TRACE notices etc.
1144	–	* +z - operwall     - See oper generated WALLOPS
1284		*/
1285
1286	<	/* oper_only_umodes: usermodes only opers may set */
1287	<	oper_only_umodes = bots, cconn, cconn_full, debug, full, hidden, skill,
1288	<	nchange, rej, spy, external, operwall,
1150	<	locops, unauth;
1151	<
1152	<	/* oper_umodes: default usermodes opers get when they /oper */
1153	<	oper_umodes = bots, locops, servnotice, operwall, wallop;
1286	>	/* oper_only_umodes: user modes only operators may set. */
1287	>	oper_only_umodes = bots, cconn, debug, external, farconnect, full, hidden,
1288	>	locops, nchange, rej, skill, spy, unauth;
1289
1290	<	/*
1291	<	* use_egd: if your system does not have *random devices yet you
1157	<	* want to use OpenSSL and encrypted links, enable this.  Beware -
1158	<	* EGD is *very* CPU intensive when gathering data for its pool
1159	<	*/
1160	<	#       use_egd = yes;
1290	>	/* oper_umodes: default user modes operators get when they successfully OPER. */
1291	>	oper_umodes = bots, locops, servnotice, wallop;
1292
1293		/*
1294	<	* egdpool_path: path to EGD pool. Not necessary for OpenSSL >= 0.9.7
1295	<	* which automatically finds the path.
1294	>	* throttle_count: the maximum number of connections from the same
1295	>	* IP address allowed in throttle_time duration.
1296		*/
1297	<	#       egdpool_path = "/var/run/egd-pool";
1297	>	throttle_count = 1;
1298
1299		/*
1300	<	* throttle_time: the minimum amount of time between connections from
1301	<	* the same ip.  exempt {} blocks are excluded from this throttling.
1302	<	* Offers protection against flooders who reconnect quickly.
1300	>	* throttle_time: the minimum amount of time required between
1301	>	* connections from the same IP address. exempt {} blocks are
1302	>	* excluded from this throttling.
1303	>	* Offers protection against flooders who reconnect quickly.
1304		* Set to 0 to disable.
1305		*/
1306	<	throttle_time = 10;
1306	>	throttle_time = 2 seconds;
1307		};
1308
1309		modules {
#	Line 1179 | Line 1311 | modules {
1311		* path: other paths to search for modules specified below
1312		* and in "/module load".
1313		*/
1314	<	path = "/usr/local/ircd/lib/ircd-hybrid/modules";
1315	<	path = "/usr/local/ircd/lib/ircd-hybrid/modules/autoload";
1314	>	path = "lib/ircd-hybrid/modules";
1315	>	#       path = "lib/ircd-hybrid/modules/extra";
1316	>	path = "lib/ircd-hybrid/modules/autoload";
1317
1318	<	/* module: the name of a module to load on startup/rehash */
1319	<	#module = "some_module.la";
1318	>	/* module: the name of a module to load on startup/rehash. */
1319	>	#       module = "some_module.la";
1320		};
1321
1322		/*
#	Line 1195 | Line 1328 | log {
1328
1329		file {
1330		type = oper;
1331	<	name = "/home/ircd/var/log/oper.log";
1331	>	name = "var/log/oper.log";
1332		size = unlimited;
1333		};
1334
1335		file {
1336		type = user;
1337	<	name = "/home/ircd/var/log/user.log";
1337	>	name = "var/log/user.log";
1338		size = 50 megabytes;
1339		};
1340
1341		file {
1342		type = kill;
1343	<	name = "/home/ircd/var/log/kill.log";
1343	>	name = "var/log/kill.log";
1344		size = 50 megabytes;
1345		};
1346
1347		file {
1348		type = kline;
1349	<	name = "/home/ircd/var/log/kline.log";
1349	>	name = "var/log/kline.log";
1350		size = 50 megabytes;
1351		};
1352
1353		file {
1354		type = dline;
1355	<	name = "/home/ircd/var/log/dline.log";
1355	>	name = "var/log/dline.log";
1356	>	size = 50 megabytes;
1357	>	};
1358	>
1359	>	file {
1360	>	type = xline;
1361	>	name = "var/log/xline.log";
1362		size = 50 megabytes;
1363		};
1364
1365		file {
1366	<	type = gline;
1367	<	name = "/home/ircd/var/log/gline.log";
1366	>	type = resv;
1367	>	name = "var/log/resv.log";
1368		size = 50 megabytes;
1369		};
1370
1371		file {
1372		type = debug;
1373	<	name = "/home/ircd/var/log/debug.log";
1373	>	name = "var/log/debug.log";
1374		size = 50 megabytes;
1375		};
1376		};

Diff Legend

–	Removed lines
+	Added lines
<	Changed lines (old)
>	Changed lines (new)