ViewVC Help

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

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

Comparing:
ircd-hybrid-8/doc/example.conf (file contents), Revision 1534 by michael, Sun Sep 23 13:17:14 2012 UTC vs.
ircd-hybrid/trunk/doc/reference.conf (file contents), Revision 7256 by michael, Thu Feb 4 17:38:51 2016 UTC

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

Diff Legend

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