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 2322 by michael, Sun Jun 23 12:01:30 2013 UTC vs.
Revision 7924 by michael, Sat Dec 31 13:57:08 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) 1997-2017 ircd-hybrid development team
5		*
6		* $Id$
7		*/
#	Line 10 | Line 10
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		*
#	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		*
#	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	+	*
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 connecting 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 address to bind to when we make outgoing connections
84	<	* to IPv6 servers. This should be an IPv6 address, or "*" for INADDR_ANY.
83	>	* vhost6: the IP address to bind to when connecting 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 the
109	<	* RSA key for cryptlink.
108	>	* libgeoip_database_options: used to control the libGeoIP database handling.
109	>	*
110	>	* Available options:
111	>	*
112	>	* standard     - Read database from file system. This uses the least memory.
113	>	* memory_cache - Load database into memory. Provides faster performance but
114	>	*                uses more memory.
115	>	* mmap_cache   - Load database into mmap shared memory.
116	>	* check_cache  - Check for updated database. If database has been updated,
117	>	*                reload file handle and/or memory cache.
118	>	*/
119	>	#       libgeoip_database_options = memory_cache, check_cache;
120	>
121	>	/*
122	>	* libgeoip_ipv4_database_file: the path to the GeoIP IPv4 database file.
123	>	*/
124	>	#       libgeoip_ipv4_database_file = "etc/GeoIP.dat";
125	>
126	>	/*
127	>	* libgeoip_ipv6_database_file: the path to the GeoIP IPv6 database file.
128	>	*/
129	>	#       libgeoip_ipv6_database_file = "etc/GeoIPv6.dat";
130	>
131	>	/*
132	>	* rsa_private_key_file: the path to the file containing the RSA key.
133		*
134	<	* Example commands to store a 2048 bit RSA keypair in
105	<	* rsa.key, and the public key in rsa.pub:
134	>	* Example commands to store a 2048 bit RSA key in rsa.key:
135		*
136	<	*      openssl genrsa -out rsa.key 2048
137	<	*      openssl rsa -in rsa.key -pubout -out rsa.pub
138	<	*      chown <ircd-user>.<ircd.group> rsa.key rsa.pub
139	<	*      chmod 0600 rsa.key
140	<	*      chmod 0644 rsa.pub
136	>	* OpenSSL/LibreSSL:
137	>	*    openssl genrsa -out rsa.key 2048
138	>	*
139	>	* GnuTLS:
140	>	*    certtool --generate-privkey --sec-param=medium --outfile rsa.key
141	>	*
142	>	* Once the RSA key is generated, it is highly recommended to lock down
143	>	* its file permissions:
144	>	*
145	>	*    chown <ircd-user>.<ircd.group> rsa.key
146	>	*    chmod 0600 rsa.key
147		*/
148	<	#       rsa_private_key_file = "/usr/local/ircd/etc/rsa.key";
148	>	#       rsa_private_key_file = "etc/rsa.key";
149
150		/*
151		* ssl_certificate_file: the path to the file containing our
#	Line 121 | Line 156 | serverinfo {
156		*
157		* Example command:
158		*
159	<	*      openssl req -new -days 365 -x509 -key rsa.key -out cert.pem
159	>	* OpenSSL/LibreSSL:
160	>	*    openssl req -new -days 365 -x509 -key rsa.key -out cert.pem
161		*
162	<	* See http://www.openssl.org/docs/HOWTO/certificates.txt
162	>	* GnuTLS:
163	>	*    certtool --generate-self-signed --load-privkey rsa.key --outfile cert.pem
164	>	*/
165	>	#       ssl_certificate_file = "etc/cert.pem";
166	>
167	>	/*
168	>	* ssl_dh_param_file: the path to the PEM encoded Diffie-Hellman
169	>	* parameter file. DH parameters are required when using
170	>	* ciphers with EDH (ephemeral Diffie-Hellman) key exchange.
171	>	*
172	>	* A DH parameter file can be created by running:
173		*
174	<	* Please use the following values when generating the cert
174	>	* OpenSSL/LibreSSL:
175	>	*    openssl dhparam -out dhparam.pem 2048
176		*
177	<	*      Organization Name: Network Name
178	<	*      Organization Unit Name: changme.someirc.net
132	<	*      Common Name: irc.someirc.net
133	<	*      E-mail: you@domain.com
177	>	* GnuTLS:
178	>	*    certtool --generate-dh-params --sec-param=medium --outfile dhparam.pem
179		*/
180	<	#       ssl_certificate_file = "/usr/local/ircd/etc/cert.pem";
180	>	#       ssl_dh_param_file = "etc/dhparam.pem";
181
182		/*
183	<	* ssl_dh_param_file:
184	<	*
185	<	* Path to the PEM encoded Diffie-Hellman parameter file.
141	<	* DH parameters are required when using ciphers with EDH
142	<	* (ephemeral Diffie-Hellman) key exchange.
183	>	* ssl_dh_elliptic_curve: defines the curve to use for the
184	>	* Elliptic Curve Diffie-Hellman (ECDH) algorithm.
185	>	* Default is ANSI X9.62 prime256v1/secp256r1 if nothing else is specified.
186		*
187	<	* A DH parameter file can be created by running:
187	>	* A list of curves supported by OpenSSL can be obtained by running:
188		*
189	<	*      openssl dhparam -out dhparam.pem 1024
189	>	*    openssl ecparam -list_curves
190		*
191	<	* Prime size must be at least 1024 bits. Further information
149	<	* regarding specific OpenSSL dhparam command-line options
150	<	* can be found in the OpenSSL manual.
191	>	* This directive currently doesn't do anything with GnuTLS support.
192		*/
193	<	#       ssl_dh_param_file = "/usr/local/ircd/etc/dhparam.pem";
193	>	#       ssl_dh_elliptic_curve = "secp521r1";
194
195		/*
196	<	* ssl_cipher_list:
196	>	* ssl_cipher_list: list of ciphers to support on _this_ server.
197	>	* Can be used to enforce specific ciphers for incoming SSL/TLS
198	>	* connections. If a client (which also includes incoming server
199	>	* connections) is not capable of using any of the ciphers listed
200	>	* here, the connection will simply be rejected.
201		*
202	<	* List of ciphers to support on _this_ server. Can be used to
158	<	* enforce specific ciphers for incoming SSL/TLS connections.
159	<	* If a client (which also includes incoming server connections) is not
160	<	* capable of using any of the ciphers listed here, the connection will
161	<	* simply be rejected.
202	>	* A list of supported ciphers can be obtained by running:
203		*
204	<	* A list of supported ciphers by OpenSSL can be obtained by running:
204	>	* OpenSSL/LibreSSL:
205	>	*    openssl ciphers -tls1 -v
206		*
207	<	*      openssl ciphers -ssl3 -tls1 -v
207	>	* GnuTLS:
208	>	*    gnutls-cli --list
209		*
210		* Multiple ciphers are separated by colons. The order of preference is
211		* from left to right.
212		*/
213	<	#       ssl_cipher_list = "DHE-RSA-AES256-SHA:AES256-SHA";
213	>	#       ssl_cipher_list = "ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES256-SHA:AES256-SHA";
214
215		/*
216	<	* ssl_server_method:
217	<	* ssl_client_method:
216	>	* ssl_message_digest_algorithm: defines which cryptographic hash function
217	>	* to use for generating fingerprint hashes of X.509 certificates.
218	>	* Default is SHA-256 if nothing else is specified.
219	>	*
220	>	* A list of supported message digest algorithms can be obtained by running:
221	>	*
222	>	* OpenSSL/LibreSSL:
223	>	*    openssl list-message-digest-algorithms
224		*
225	<	* SSL/TLS methods we provide for incoming (server method) and
226	<	* outgoing (client method) SSL/TLS connections.
178	<	* This can be either sslv3 for SSLv3, and/or tlsv1 for TLSv1.
225	>	* GnuTLS:
226	>	*    gnutls-cli --list
227		*/
228	<	#       ssl_server_method = tlsv1, sslv3;
181	<	#       ssl_client_method = tlsv1;
228	>	#       ssl_message_digest_algorithm = "sha256";
229		};
230
231		/*
232	<	* admin {}:  contains admin information about the server
232	>	* admin {}:  contains administrative information about the server
233		*/
234		admin {
235		name = "Smurf target";
236		description = "Main Server Administrator";
237	<	email = "<syn@packets.r.us>";
237	>	email = "<admin@server.example.net>";
238		};
239
240		/*
#	Line 205 | Line 252 | class {
252
253		/*
254		* number_per_ip: how many local users are allowed to connect
255	<	* from a single IP address  (optional)
255	>	* from a single IP address (optional)
256		*/
257		number_per_ip = 2;
258
259		/*
260		* max_local: how many local users are allowed to connect
261	<	* from a single ident@host  (optional)
261	>	* from a single ident@host (optional)
262		*/
263		max_local = 2;
264
265		/*
266	<	* max_global: network-wide limit of users per ident@host  (optional)
266	>	* max_global: network-wide limit of users per ident@host (optional)
267		*/
268		max_global = 10;
269
#	Line 226 | Line 273 | class {
273		max_number = 100;
274
275		/*
276	<	* the following lines are optional and allow you to define
276	>	* The following lines are optional and allow you to define
277		* how many users can connect from one /NN subnet.
278		*/
279		cidr_bitlen_ipv4 = 24;
#	Line 241 | Line 288 | class {
288
289		/*
290		* recvq: the amount of data allowed in a client's receive queue before
291	<	* they are dropped for flooding. Defaults to 2560 if the chosen
292	<	* value isn't within the range of 512 to 8000.
291	>	* they are dropped for flooding. Defaults to 2560 if the chosen value
292	>	* isn't within the range of 512 to 8000.
293		*/
294		recvq = 2560 bytes;
295		};
#	Line 255 | Line 302 | class {
302		sendq = 100 kbytes;
303
304		/*
305	<	* min_idle: minimum idle time that is shown in /whois.
305	>	* max_channels: maximum number of channels users in this class can join.
306	>	*/
307	>	max_channels = 60;
308	>
309	>	/*
310	>	* min_idle: minimum idle time that is shown in WHOIS.
311		*/
312		min_idle = 3 hours;
313
314		/*
315	<	* max_idle: maximum idle time that is shown in /whois.
315	>	* max_idle: maximum idle time that is shown in WHOIS.
316		*/
317		max_idle = 8 hours;
318
#	Line 298 | Line 350 | class {
350		motd {
351		/*
352		* mask: multiple mask entries are permitted. Mask can either be
353	<	* a class name or a hostname.
353	>	* a class name or a hostname. CIDR is supported.
354		*/
355		mask = "*.at";
356		mask = "*.de";
357		mask = "*.ch";
358
359		/*
360	<	* file: path to the actual motd file.
360	>	* file: path to the motd file.
361		*/
362	<	file = "/usr/local/ircd/etc/german.motd";
362	>	file = "etc/german.motd";
363		};
364
365		/*
#	Line 315 | Line 367 | motd {
367		*/
368		listen {
369		/*
370	<	* port: the port to listen on. If no host is specified
371	<	* earlier in the listen {} block, it will listen on all available IPs.
370	>	* port: the port to listen on. If no host is specified earlier in the
371	>	* listen {} block, it will listen on all available IP addresses.
372		*
373	<	* Ports are separated by commsa; a range may be specified using ".."
373	>	* Ports are separated by commas; a range may be specified using ".."
374		*/
375	<
376	<	/* port: listen on all available IP addresses, ports 6665 to 6669 */
375	>
376	>	/* port: listen on all available IP addresses, ports 6665 to 6669. */
377		port = 6665 .. 6669;
378
379		/*
380	<	* Listen on 192.168.0.1/6697 with SSL enabled and hidden from STATS P
380	>	* Listen on 192.0.2.2/6697 with SSL enabled and hidden from STATS P
381		* unless you are an administrator.
382		*
383		* NOTE: The "flags" directive always has to come before "port".
#	Line 337 | Line 389 | listen {
389		*  hidden - Port is hidden from /stats P, unless you're an admin
390		*/
391		flags = hidden, ssl;
392	<	host = "192.168.0.1";
392	>	host = "192.0.2.2";
393		port = 6697;
394
395		/*
396	<	* host: set a specific IP address/host to listen on using the
396	>	* host: set a specific IP address to listen on using the
397		* subsequent port definitions. This may be IPv4 or IPv6.
398		*/
399	<	host = "1.2.3.4";
399	>	host = "192.0.2.3";
400		port = 7000, 7001;
401
402	<	host = "3ffe:1234:a:b:c::d";
402	>	host = "2001:DB8::2";
403		port = 7002;
404		};
405
#	Line 357 | Line 409 | listen {
409		auth {
410		/*
411		* user: the user@host allowed to connect. Multiple user
412	<	* lines are permitted within each auth block.
412	>	* lines are permitted within each auth {} block.
413		*/
414	<	user = "*@172.16.0.0/12";
415	<	user = "*test@123D:B567:*";
414	>	user = "*@192.0.2.0/24";
415	>	user = "*test@2001:DB8:*";
416
417	<	/* password: an optional password that is required to use this block */
417	>	/* password: an optional password that is required to use this block. */
418		password = "letmein";
419
420		/*
421	<	* encrypted: controls whether the auth password above has been
422	<	* encrypted.
421	>	* encrypted: indicates whether the auth password above has been
422	>	* encrypted. Default is 'no' if nothing else is specified.
423		*/
424		encrypted = yes;
425
426		/*
427	<	* spoof: fake the user's host to this. This is free-form, just do
427	>	* spoof: fake the user's host to this. This is free-form; just do
428		* everyone a favor and don't abuse it. ('=' prefix on /stats I)
429		*/
430		spoof = "I.still.hate.packets";
431
432	<	/* class: the class the user is placed in */
432	>	/* class: the class the user is placed in. */
433		class = "opers";
434
435		/*
436	<	* need_password - don't allow users who haven't supplied the correct
437	<	*                 password to connect using another auth{} block
438	<	*                 ('&' prefix on /stats I if disabled)
387	<	* need_ident    - require the user to have identd to connect ('+' prefix on /stats I)
436	>	* need_password - don't allow users who haven't supplied the correct  | ('&' prefix on /stats I if disabled)
437	>	*                 password to connect using another auth {} block
438	>	* need_ident    - require the user to have identd to connect          | ('+' prefix on /stats I)
439		* spoof_notice  - enable spoofing notification to admins
440	<	* exceed_limit  - allow a user to exceed class limits ('>' prefix on /stats I)
441	<	* kline_exempt  - exempt this user from k/glines ('^' prefix on /stats I)
442	<	* gline_exempt  - exempt this user from glines ('_' prefix on /stats I)
443	<	* resv_exempt   - exempt this user from resvs ('$' prefix on /stats I)
444	<	* no_tilde      - remove ~ from a user with no ident ('-' prefix on /stats I)
445	<	* can_flood     - allow this user to exceed flood limits ('|' prefix on /stats I)
446	<	* webirc        - enables WEBIRC authentication for web-based clients such as Mibbit
447	<	*                 ('<' prefix on /stats I)
440	>	* exceed_limit  - allow a user to exceed class limits                 | ('>' prefix on /stats I)
441	>	* kline_exempt  - exempt this user from k-lines                       | ('^' prefix on /stats I)
442	>	* xline_exempt  - exempt this user from x-lines                       | ('!' prefix on /stats I)
443	>	* resv_exempt   - exempt this user from resvs                         | ('$' prefix on /stats I)
444	>	* no_tilde      - remove ~ from a user with no ident                  | ('-' prefix on /stats I)
445	>	* can_flood     - allow this user to exceed flood limits              | ('|' prefix on /stats I)
446	>	* webirc        - enables WEBIRC authentication for web-based         | ('<' prefix on /stats I)
447	>	*                 clients such as Mibbit
448		*/
449		flags = need_password, spoof_notice, exceed_limit, kline_exempt,
450	<	gline_exempt, resv_exempt, no_tilde, can_flood;
450	>	xline_exempt, resv_exempt, no_tilde, can_flood;
451		};
452
453		auth {
454		/*
455	<	* redirect: the server and port to redirect a user to. A user does not
456	<	* have to obey the redirection; the ircd just suggests an alternative
457	<	* server for them.
455	>	* redirserv, redirport: the server and port to redirect a user to.
456	>	* A user does not have to obey the redirection; the ircd just
457	>	* suggests an alternative server for them.
458		*/
459	<	redirserv = "this.is.not.a.real.server";
459	>	redirserv = "server2.example.net";
460		redirport = 6667;
410	–
411	–	user = "*.server";
461
462	<	/* class: a class is required even though it is not used */
462	>	user = "*@*.ch";
463	>
464	>	/* class: a class is required even though it is not used. */
465		class = "users";
466		};
467
#	Line 424 | Line 475 | auth {
475		* operator {}:  defines ircd operators
476		*/
477		operator {
478	<	/* name: the name of the oper */
478	>	/* name: the name of the operator */
479		name = "sheep";
480
481		/*
482	<	* user: the user@host required for this operator. Multiple
483	<	* user="" lines are supported.
482	>	* user: the user@host required for this operator. Multiple user
483	>	* lines are permitted within each operator {} block.
484		*/
485	<	user = "*sheep@192.168.0.0/16";
486	<	user = "*@127.0.0.0/8";
485	>	user = "*sheep@192.0.2.0/26";
486	>	user = "*@192.0.2.240/28";
487
488		/*
489	<	* password: the password required to oper. By default this will
490	<	* need to be encrypted by using the provided mkpasswd tool.
491	<	* Several password hash algorithms are available depending
492	<	* on your system's crypt() implementation. For example, a modern
442	<	* glibc already has support for the SHA-256/512 and MD5 encryption
443	<	* algorithms.
489	>	* password: the password required to oper. By default this will need
490	>	* to be encrypted using the provided mkpasswd tool.
491	>	* The availability of various password hashing algorithms may vary
492	>	* depending on the system's crypt(3) implementation.
493		*/
494		password = "$5$x5zof8qe.Yc7/bPp$5zIg1Le2Lsgd4CvOjaD20pr5PmcfD7ha/9b2.TaUyG4";
495
496		/*
497	<	* encrypted: controls whether the oper password above has been
498	<	* encrypted.
497	>	* encrypted: indicates whether the oper password above has been
498	>	* encrypted. Default is 'yes' if nothing else is specified.
499		*/
500		encrypted = yes;
501
502		/*
454	–	* rsa_public_key_file: the public key for this oper when using Challenge.
455	–	* A password should not be defined when this is used; see
456	–	* doc/challenge.txt for more information.
457	–	*/
458	–	#       rsa_public_key_file = "/usr/local/ircd/etc/oper.pub";
459	–
460	–	/*
503		* ssl_certificate_fingerprint: enhances security by additionally checking
504		* the oper's client certificate fingerprint against the specified
505		* fingerprint below.
506		*
507	<	* Hint: your users can use the following command to obtain a SHA-256 hash
507	>	* Hint: your users can use the following commands to obtain a SHA-256 hash
508		* of their ssl certificate:
509		*
510	<	*      openssl x509 -sha256 -noout -fingerprint -in cert.pem | sed -e 's/^.*=//;s/://g'
510	>	* OpenSSL/LibreSSL:
511	>	*    openssl x509 -sha256 -noout -fingerprint -in cert.pem | sed -e 's/^.*=//;s/://g'
512	>	*
513	>	* GnuTLS:
514	>	*    certtool -i < cert.pem | egrep -A 1 'SHA256 fingerprint'
515		*/
516		#       ssl_certificate_fingerprint = "4C62287BA6776A89CD4F8FF10A62FFB35E79319F51AF6C62C674984974FCCB1D";
517
518		/*
519		* ssl_connection_required: client must be connected over SSL/TLS
520	<	* in order to be able to use this oper{} block.
520	>	* in order to be able to use this operator {} block.
521		* Default is 'no' if nothing else is specified.
522		*/
523		ssl_connection_required = no;
524
525	<	/* class: the class the oper joins when they successfully /oper */
525	>	/* class: the class the oper joins when they successfully OPER. */
526		class = "opers";
527
528		/*
529	<	* umodes: the default usermodes opers get when they /oper. If defined,
530	<	* it will override oper_umodes settings in general {}.
531	<	* Available usermodes:
529	>	* whois: allows overriding the default RPL_WHOISOPERATOR numeric
530	>	* string shown in WHOIS.
531	>	* This string is propagated to all servers on the network.
532	>	*/
533	>	#       whois = "is a Smurf Target (IRC Operator)";
534	>
535	>	/*
536	>	* umodes: the default user modes opers get when they successfully OPER.
537	>	* If defined, it will override oper_umodes settings in general {}.
538	>	* Available user modes:
539		*
540		* +b - bots         - See bot and drone flooding notices
541		* +c - cconn        - Client connection/quit notices
#	Line 490 | Line 543 | operator {
543		* +d - debug        - See debugging notices
544		* +e - external     - See remote server connection and split notices
545		* +F - farconnect   - Remote client connection/quit notices
546	<	* +f - full         - See auth{} block full notices
546	>	* +f - full         - See auth {} block full notices
547		* +G - softcallerid - Server Side Ignore for users not on your channels
548		* +g - callerid     - Server Side Ignore (for privmsgs etc)
549	<	* +H - hidden       - Hides operator status to other users
549	>	* +H - hidden       - Hides IRC operator status to other users
550		* +i - invisible    - Not shown in NAMES or WHO unless you share a channel
551		* +j - rej          - See rejected client notices
552		* +k - skill        - See server generated KILL messages
553		* +l - locops       - See LOCOPS messages
554		* +n - nchange      - See client nick changes
555	+	* +p - hidechans    - Hides channel list in WHOIS
556	+	* +q - hideidle     - Hides idle and signon time in WHOIS
557		* +R - nononreg     - Only receive private messages from registered clients
558		* +s - servnotice   - See general server notices
559		* +u - unauth       - See unauthorized client notices
560		* +w - wallop       - See server generated WALLOPS
561		* +y - spy          - See LINKS, STATS, TRACE notices etc.
507	–	* +z - operwall     - See oper generated WALLOPS
562		*/
563	<	umodes = locops, servnotice, operwall, wallop;
563	>	umodes = locops, servnotice, wallop;
564
565		/*
566	<	* privileges: controls the activities and commands an oper is
567	<	* allowed to do on the server. All options default to no.
568	<	* Available options:
569	<	*
570	<	* module         - allows MODULE
571	<	* connect        - allows local CONNECT              | ('P' flag)
572	<	* connect:remote - allows remote CONNECT             | ('Q' flag)
573	<	* squit          - allows local SQUIT                | ('R' flag)
574	<	* squit:remote   - allows remote SQUIT               | ('S' flag)
575	<	* kill           - allows to KILL local clients      | ('N' flag)
576	<	* kill:remote    - allows remote users to be /KILL'd | ('O' flag)
577	<	* remoteban      - allows remote KLINE/UNKLINE       | ('B' flag)
578	<	* dline          - allows DLINE                      |
579	<	* undline        - allows UNDLINE                    |
580	<	* kline          - allows KLINE                      | ('K' flag)
581	<	* unkline        - allows UNKLINE                    | ('U' flag)
582	<	* gline          - allows GLINE                      | ('G' flag)
583	<	* xline          - allows XLINE                      | ('X' flag)
584	<	* locops         - allows LOCOPS                     |
585	<	* globops        - allows GLOBOPS                    |
586	<	* wallops        - allows WALLOPS                    |
587	<	* operwall       - allows OPERWALL                   | ('L' flag)
588	<	* rehash         - allows oper to REHASH config      | ('H' flag)
589	<	* die            - allows DIE                        | ('D' flag)
590	<	* restart        - allows RESTART                    |
591	<	* set            - allows SET                        |
592	<	* admin          - gives administrator privileges    | ('A' flag)
566	>	* flags: controls the activities and commands an oper is
567	>	* allowed to do on the server. All flags default to 'no'.
568	>	* Available flags:
569	>	*
570	>	* admin          - gives administrator privileges        | ('A' flag)
571	>	* close          - allows CLOSE                          | ('B' flag)
572	>	* connect        - allows local CONNECT                  | ('C' flag)
573	>	* connect:remote - allows remote CONNECT                 | ('D' flag)
574	>	* die            - allows DIE                            | ('E' flag)
575	>	* dline          - allows DLINE                          | ('F' flag)
576	>	* globops        - allows GLOBOPS                        | ('G' flag)
577	>	* join:resv      - allows to JOIN resv {} channels       | ('H' flag)
578	>	* kill           - allows to KILL local clients          | ('I' flag)
579	>	* kill:remote    - allows remote users to be /KILL'd     | ('J' flag)
580	>	* kline          - allows KLINE                          | ('K' flag)
581	>	* locops         - allows LOCOPS                         | ('L' flag)
582	>	* module         - allows MODULE                         | ('M' flag)
583	>	* nick:resv      - allows to use NICK on resv {} nicks   | ('N' flag)
584	>	* opme           - allows OPME                           | ('O' flag)
585	>	* rehash         - allows oper to REHASH config          | ('P' flag)
586	>	* rehash:remote  - allows oper to remotely REHASH config | ('Q' flag)
587	>	* remoteban      - allows remote KLINE/UNKLINE           | ('R' flag)
588	>	* restart        - allows RESTART                        | ('S' flag)
589	>	* resv           - allows RESV                           | ('T' flag)
590	>	* set            - allows SET                            | ('U' flag)
591	>	* squit          - allows local SQUIT                    | ('V' flag)
592	>	* squit:remote   - allows remote SQUIT                   | ('W' flag)
593	>	* undline        - allows UNDLINE                        | ('X' flag)
594	>	* unkline        - allows UNKLINE                        | ('Y' flag)
595	>	* unresv         - allows UNRESV                         | ('Z' flag)
596	>	* unxline        - allows UNXLINE                        | ('a' flag)
597	>	* wallops        - allows WALLOPS                        | ('b' flag)
598	>	* xline          - allows XLINE                          | ('c' flag)
599		*/
600	<	flags = kill, kill:remote, connect, connect:remote, kline, unkline,
601	<	xline, globops, restart, die, rehash, admin, operwall, module;
542	<	};
543	<
544	<	/*
545	<	* service {}: specifies a server which may act as a network service
546	<	*
547	<	* NOTE: it is very important that every server on the network
548	<	*       has the same service{} block.
549	<	*/
550	<	service {
551	<	name = "service.someserver";
552	<	name = "stats.someserver";
600	>	flags = admin, connect, connect:remote, die, globops, kill, kill:remote,
601	>	kline, module, rehash, restart, set, unkline, unxline, xline;
602		};
603
604		/*
605		* connect {}: define a server to connect to
606		*/
607		connect {
608	<	/* name: the name of the server */
609	<	name = "irc.uplink.com";
608	>	/* name: the name of the server. */
609	>	name = "uplink.example.net";
610
611		/*
612	<	* host: the host or IP address to connect to. If a hostname is used it
613	<	* must match the reverse DNS of the server.
612	>	* host: the host or IP address to connect to. If a hostname is used,
613	>	* it must match the reverse DNS of the server.
614		*/
615	<	host = "192.168.0.1";
615	>	host = "192.0.2.4";
616
617		/*
618		* vhost: the IP address to bind to when making outgoing connections to
619	<	* servers.
571	<	* serverinfo::vhost and serverinfo::vhost6 will be overridden
619	>	* servers. serverinfo::vhost and serverinfo::vhost6 will be overridden
620		* by this directive.
621		*/
622	<	vhost = "192.168.0.2";
622	>	vhost = "192.0.2.5";
623
624		/*
625	<	* passwords: the passwords to send (OLD C:) and accept (OLD N:).
625	>	* send_password, accept_password: the passwords to send and accept.
626		* The remote server will have these passwords swapped.
627		*/
628		send_password = "password";
629		accept_password = "anotherpassword";
630
631		/*
632	<	* encrypted: controls whether the accept_password above has been
632	>	* encrypted: indicates whether the accept_password above has been
633		* encrypted.
634		*/
635		encrypted = no;
636
637	<	/* port: the port to connect to this server on */
637	>	/* port: the port to connect to this server on. */
638		port = 6666;
639
640		/*
#	Line 601 | Line 649 | connect {
649		*/
650		#       leaf_mask = "*.uk";
651
652	<	/* class: the class this server is in */
652	>	/* class: the class this server is in. */
653		class = "server";
654
655		/*
656	<	* ssl_cipher_list:
657	<	*
658	<	* List of ciphers that the server we are connecting to must support.
611	<	* If the server is not capable of using any of the ciphers listed below,
612	<	* the connection will simply be rejected.
656	>	* ssl_cipher_list: list of ciphers that the server we are connecting to
657	>	* must support. If the server is not capable of using any of the ciphers
658	>	* listed below, the connection will simply be rejected.
659		* Can be used to enforce stronger ciphers, even though this option
660		* is not necessarily required to establish a SSL/TLS connection.
661		*
662		* Multiple ciphers are separated by colons. The order of preference
663		* is from left to right.
664		*/
665	<	#       ssl_cipher_list = "DHE-RSA-AES256-SHA:AES256-SHA";
665	>	#       ssl_cipher_list = "ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES256-SHA:AES256-SHA";
666
667		/*
668		* ssl_certificate_fingerprint: enhances security by additionally checking
#	Line 634 | Line 680 | connect {
680		};
681
682		connect {
683	<	name = "ipv6.some.server";
684	<	host = "3ffd:dead:beef::1";
683	>	name = "ipv6.example.net";
684	>	host = "2001:DB8::3";
685		send_password = "password";
686		accept_password = "password";
687		port = 6666;
#	Line 661 | Line 707 | cluster {
707		*       will not be propagated to clustered servers.
708		*
709		*       Remote servers are not necessarily required to accept
710	<	*       clustered lines, they need a shared{} for *THIS* server
711	<	*       in order to accept them.
710	>	*       clustered lines, they need a shared {} block for *THIS*
711	>	*       server in order to accept them.
712		*/
713	<	name = "*.arpa";
713	>	name = "*.example.net";
714
715		/*
716		* type: list of what to share; options are as follows:
#	Line 696 | Line 742 | shared {
742		* If this is not specified, the user will be allowed to kline from all
743		* servers.
744		*/
745	<	name = "irc2.some.server";
745	>	name = "irc2.example.net";
746
747		/*
748		* user: the user@host mask that is allowed to set klines. If this is
#	Line 713 | Line 759 | shared {
759		*      unkline - allow oper/server to unkline
760		*      xline   - allow oper/server to xline
761		*      unxline - allow oper/server to unxline
762	+	*      rehash  - allow oper/server to rehash
763		*      resv    - allow oper/server to resv
764		*      unresv  - allow oper/server to unresv
765		*      locops  - allow oper/server to locops - only used for servers that cluster
#	Line 723 | Line 770 | shared {
770
771		/*
772		* kill {}:  users that are not allowed to connect
773	<	* Oper issued klines will be added to the specified kline config
773	>	* Oper issued klines will be added to the specified kline database
774		*/
775		kill {
776	<	user = "bad@*.hacked.edu";
776	>	user = "bad@*.example.net";
777		reason = "Obviously hacked account";
778		};
779
780		/*
781		* deny {}:  IP addresses that are not allowed to connect
782		* (before DNS/ident lookup)
783	<	* Oper issued dlines will be added to the specified dline config
783	>	* Oper issued dlines will be added to the specified dline database
784		*/
785		deny {
786	<	ip = "10.0.1.0/24";
786	>	ip = "192.0.2.0/28";
787		reason = "Reconnecting vhosted bots";
788		};
789
#	Line 744 | Line 791 | deny {
791		* exempt {}:  IP addresses that are exempt from deny {} and Dlines
792		*/
793		exempt {
794	<	ip = "192.168.0.0/16";
794	>	ip = "192.0.2.240/28";
795	>
796	>	/* The 'ip' directives can be stacked */
797	>	ip = "10.0.0.0/8";
798	>	ip = "fc00::/7";
799		};
800
801		/*
802		* resv {}:  nicks and channels users may not use/join
803		*/
804		resv { mask = "clone*"; reason = "Clone bots"; };
805	+	resv { mask = "Global"; reason = "Reserved for services"; };
806		resv { mask = "ChanServ"; reason = "Reserved for services"; };
807		resv { mask = "NickServ"; reason = "Reserved for services"; };
808		resv { mask = "OperServ"; reason = "Reserved for services"; };
#	Line 767 | Line 819 | resv {
819		* as channel name masks.
820		*/
821		mask = "#helsinki";
822	<	reason = "Channel is reserved for finnish inhabitants";
822	>	reason = "Channel is reserved for Finnish inhabitants";
823
824		/*
825		* exempt: can be either a ISO 3166 alpha-2 two letter country
#	Line 778 | Line 830 | resv {
830		};
831
832		/*
833	<	* gecos {}:  Used for banning users based on their "realname".
833	>	* gecos {}:  used for banning users based on their "realname".
834		*/
835		gecos {
836		name = "*sex*";
#	Line 791 | Line 843 | gecos {
843		};
844
845		/*
846	<	* channel {}:  The channel block contains options pertaining to channels
846	>	* service {}: specifies a server which may act as a network service
847	>	*
848	>	* NOTE: it is very important that every server on the network
849	>	*       has the same service {} block.
850	>	*/
851	>	service {
852	>	/* name: the actual name of the service. Wildcards are not allowed. */
853	>	name = "service.example.net";
854	>
855	>	/* The 'name' directives can be stacked. */
856	>	name = "stats.example.net";
857	>	};
858	>
859	>	/*
860	>	* pseudo {}: adds pseudo/custom commands also known as service aliases
861	>	*/
862	>	pseudo {
863	>	/* command: the actual command/alias. */
864	>	command = "IDENTIFY";
865	>
866	>	/* prepend: optional text that can be prepended to the user's message. */
867	>	prepend = "IDENTIFY ";
868	>
869	>	/* name: the service name, used for error messages. */
870	>	name = "NickServ";
871	>
872	>	/* target: the actual target where this message should be sent to. */
873	>	target = "NickServ@service.example.net";
874	>	};
875	>
876	>	pseudo {
877	>	command = "CHANSERV";
878	>	name = "ChanServ";
879	>	target = "ChanServ@service.example.net";
880	>	};
881	>
882	>	pseudo {
883	>	command = "CS";
884	>	name = "ChanServ";
885	>	target = "ChanServ@service.example.net";
886	>	};
887	>
888	>	pseudo {
889	>	command = "NICKSERV";
890	>	name = "NickServ";
891	>	target = "NickServ@service.example.net";
892	>	};
893	>
894	>	pseudo {
895	>	command = "NS";
896	>	name = "NickServ";
897	>	target = "NickServ@service.example.net";
898	>	};
899	>
900	>	pseudo {
901	>	command = "MEMOSERV";
902	>	name = "MemoServ";
903	>	target = "MemoServ@service.example.net";
904	>	};
905	>
906	>	pseudo {
907	>	command = "MS";
908	>	name = "MemoServ";
909	>	target = "MemoServ@service.example.net";
910	>	};
911	>
912	>	pseudo {
913	>	command = "OPERSERV";
914	>	name = "OperServ";
915	>	target = "OperServ@service.example.net";
916	>	};
917	>
918	>	pseudo {
919	>	command = "OS";
920	>	name = "OperServ";
921	>	target = "OperServ@service.example.net";
922	>	};
923	>
924	>	pseudo {
925	>	command = "HOSTSERV";
926	>	name = "HostServ";
927	>	target = "HostServ@service.example.net";
928	>	};
929	>
930	>	pseudo {
931	>	command = "HS";
932	>	name = "HostServ";
933	>	target = "HostServ@service.example.net";
934	>	};
935	>
936	>	pseudo {
937	>	command = "BOTSERV";
938	>	name = "BotServ";
939	>	target = "BotServ@service.example.net";
940	>	};
941	>
942	>	pseudo {
943	>	command = "BS";
944	>	name = "BotServ";
945	>	target = "BotServ@service.example.net";
946	>	};
947	>
948	>	/*
949	>	* channel {}:  the channel block contains options pertaining to channels
950		*/
951		channel {
952		/*
#	Line 810 | Line 965 | channel {
965		disable_fake_channels = yes;
966
967		/*
968	<	* knock_delay: The amount of time a user must wait between issuing
969	<	* the knock command.
968	>	* invite_client_count, invite_client_time: how many INVITE commands
969	>	* are permitted per client per invite_client_time.
970		*/
971	<	knock_delay = 5 minutes;
971	>	invite_client_count = 10;
972	>	invite_client_time = 5 minutes;
973
974		/*
975	<	* knock_delay_channel: How often a knock to any specific channel
976	<	* is permitted, regardless of the user sending the knock.
975	>	* invite_delay_channel: how often an INVITE to any specific channel
976	>	* is permitted, regardless of the user sending the INVITE.
977		*/
978	<	knock_delay_channel = 1 minute;
978	>	invite_delay_channel = 5 seconds;
979
980		/*
981	<	* max_chans_per_user: The maximum number of channels a user can
982	<	* join/be on.
981	>	* invite_expire_time: specifies the amount of time an INVITE will be
982	>	* active until it expires. Set it to 0 if you don't want invites to
983	>	* expire. Default is 30 minutes if nothing else is specified.
984		*/
985	<	max_chans_per_user = 25;
985	>	invite_expire_time = 1 hour;
986
987		/*
988	<	* max_chans_per_oper: The maximum number of channels an oper can
989	<	* join/be on.
988	>	* knock_client_count, knock_client_time: how many KNOCK commands
989	>	* are permitted per client per knock_client_time.
990		*/
991	<	max_chans_per_oper = 50;
992	<
836	<	/* max_bans: maximum number of +b/e/I modes in a channel */
837	<	max_bans = 100;
991	>	knock_client_count = 1;
992	>	knock_client_time = 5 minutes;
993
994		/*
995	<	* how many joins in how many seconds constitute a flood. Use 0 to
996	<	* disable. +b opers will be notified (changeable via /set)
995	>	* knock_delay_channel: how often a KNOCK to any specific channel
996	>	* is permitted, regardless of the user sending the KNOCK.
997		*/
998	<	join_flood_count = 16;
844	<	join_flood_time = 8 seconds;
998	>	knock_delay_channel = 1 minute;
999
1000		/*
1001	<	* The ircd will now check splitmode (whether a server is split from
1002	<	* the network) every few seconds; this functionality is known as
849	<	* splitcode and is influenced by the options below.
850	<	*
851	<	* Either split users or split servers can activate splitmode, but
852	<	* both conditions must be met for the ircd to deactivate splitmode.
853	<	*
854	<	* You may force splitmode to be permanent by /quote set splitmode on
1001	>	* max_channels: the maximum number of channels a user can join/be on.
1002	>	* This is a default value which can be overriden with class {} blocks.
1003		*/
1004	+	max_channels = 25;
1005
1006	<	/*
1007	<	* default_split_user_count: when the usercount is lower than this level,
1008	<	* consider ourselves split. This must be set for automatic splitmode.
1009	<	*/
1010	<	default_split_user_count = 0;
1006	>	/* max_invites: the maximum number of channels a user can be invited to. */
1007	>	max_invites = 20;
1008	>
1009	>	/* max_bans: maximum number of +b/e/I modes in a channel. */
1010	>	max_bans = 100;
1011
1012		/*
1013	<	* default_split_server_count: when the servercount is lower than this,
1014	<	* consider ourselves split. This must be set for automatic splitmode.
1013	>	* default_join_flood_count, default_join_flood_time:
1014	>	* how many joins in how many seconds constitute a flood. Use 0 to disable.
1015	>	* +b opers will be notified. These are only default values which can be
1016	>	* changed via "/QUOTE SET JFLOODCOUNT" and "/QUOTE SET JFLOODTIME".
1017		*/
1018	<	default_split_server_count = 0;
1019	<
869	<	/* no_create_on_split: do not allow users to create channels on split. */
870	<	no_create_on_split = yes;
871	<
872	<	/* no_join_on_split: do not allow users to join channels on a split. */
873	<	no_join_on_split = no;
1018	>	default_join_flood_count = 18;
1019	>	default_join_flood_time = 6 seconds;
1020		};
1021
1022		/*
1023	<	* serverhide {}:  The serverhide block contains the options regarding
1024	<	* to server hiding
1023	>	* serverhide {}:  the serverhide block contains the options regarding
1024	>	* to server hiding. For more information regarding server hiding,
1025	>	* please see doc/serverhide.txt
1026		*/
1027		serverhide {
1028		/*
#	Line 891 | Line 1038 | serverhide {
1038		flatten_links = no;
1039
1040		/*
1041	<	* links_delay: how often to update the links file when it is
1041	>	* flatten_links_delay: how often to update the links file when it is
1042		* flattened.
1043		*/
1044	<	links_delay = 5 minutes;
1044	>	flatten_links_delay = 5 minutes;
1045	>
1046	>	/*
1047	>	* flatten_links_file: path to the flatten links cache file.
1048	>	*/
1049	>	flatten_links_file = "var/lib/links.txt";
1050
1051		/*
1052		* hidden: hide this server from a /links output on servers that
#	Line 910 | Line 1062 | serverhide {
1062
1063		/*
1064		* hide_services: define this if you want to hide the location of
1065	<	* services servers that are specified in the service{} block.
1065	>	* services servers that are specified in the service {} block.
1066		*/
1067		hide_services = no;
1068
1069		/*
1070	<	* Use this as the servername users see if hide_servers = yes.
1070	>	* hidden_name: use this as the servername users see if hide_servers = yes.
1071		*/
1072	<	hidden_name = "*.hidden.com";
1072	>	hidden_name = "*.example.net";
1073
1074		/*
1075	<	* hide_server_ips: If this is disabled, opers will be unable to see
1075	>	* hide_server_ips: if this is disabled, opers will be unable to see
1076		* servers' IP addresses and will be shown a masked IP address; admins
1077		* will be shown the real IP address.
1078		*
#	Line 935 | Line 1087 | serverhide {
1087		};
1088
1089		/*
1090	<	* general {}:  The general block contains many of the options that were once
1090	>	* general {}:  the general block contains many of the options that were once
1091		* compiled in options in config.h
1092		*/
1093		general {
#	Line 945 | Line 1097 | general {
1097		*/
1098		cycle_on_host_change = yes;
1099
948	–	/* services_name: servername of nick/channel services */
949	–	services_name = "service.someserver";
950	–
1100		/* max_watch: maximum WATCH entries a client can have. */
1101	<	max_watch = 60;
1101	>	max_watch = 50;
1102	>
1103	>	/* max_accept: maximum allowed /accept's for +g user mode. */
1104	>	max_accept = 50;
1105
1106	<	/* gline_enable: enable glines (network-wide temporary klines). */
1107	<	gline_enable = yes;
1106	>	/* whowas_history_length: maximum length of the WHOWAS nick name history. */
1107	>	whowas_history_length = 15000;
1108
1109		/*
1110	<	* gline_duration: the amount of time a gline will remain on your
1111	<	* server before expiring.
1110	>	* dline_min_cidr: the minimum required length of a CIDR bitmask
1111	>	* for IPv4 based D-lines.
1112		*/
1113	<	gline_duration = 1 day;
1113	>	dline_min_cidr = 16;
1114
1115		/*
1116	<	* gline_request_duration: how long a pending G-line can be around.
1117	<	* 10 minutes should be plenty.
1116	>	* dline_min_cidr6: the minimum required length of a CIDR bitmask
1117	>	* for IPv6 based D-lines.
1118		*/
1119	<	gline_request_duration = 10 minutes;
1119	>	dline_min_cidr6 = 48;
1120
1121		/*
1122	<	* gline_min_cidr: the minimum required length of a CIDR bitmask
1123	<	* for IPv4 based glines.
1122	>	* kline_min_cidr: the minimum required length of a CIDR bitmask
1123	>	* for IPv4 based K-lines.
1124		*/
1125	<	gline_min_cidr = 16;
1125	>	kline_min_cidr = 16;
1126
1127		/*
1128	<	* gline_min_cidr6: the minimum required length of a CIDR bitmask
1129	<	* for IPv6 based glines.
1128	>	* kline_min_cidr6: the minimum required length of a CIDR bitmask
1129	>	* for IPv6 based K-lines.
1130		*/
1131	<	gline_min_cidr6 = 48;
1131	>	kline_min_cidr6 = 48;
1132
1133		/*
1134	<	* Whether to automatically set mode +i on connecting users.
1134	>	* invisible_on_connect: whether to automatically set user mode +i
1135	>	* on connecting users.
1136		*/
1137		invisible_on_connect = yes;
1138
#	Line 989 | Line 1142 | general {
1142		* automatically to the new nick. kill_chase_time_limit is the maximum
1143		* time following a nickname change that this chasing will apply.
1144		*/
1145	<	kill_chase_time_limit = 90 seconds;
993	<
994	<	/*
995	<	* hide_spoof_ips: if disabled, opers will be allowed to see the real
996	<	* IP address of spoofed users in /trace etc. If this is defined they
997	<	* will be shown a masked IP.
998	<	*/
999	<	hide_spoof_ips = yes;
1145	>	kill_chase_time_limit = 30 seconds;
1146
1147		/*
1148	<	* Ignore bogus timestamps from other servers. Yes, this will desync the
1149	<	* network, but it will allow chanops to resync with a valid non TS 0
1148	>	* ignore_bogus_ts: ignore bogus timestamps from other servers.
1149	>	* Yes, this will desync the network, but it will allow chanops
1150	>	* to resync with a valid non TS 0.
1151		*
1152		* This should be enabled network wide, or not at all.
1153		*/
#	Line 1008 | Line 1155 | general {
1155
1156		/*
1157		* disable_auth: completely disable ident lookups; if you enable this,
1158	<	* be careful of what you set need_ident to in your auth {} blocks
1158	>	* be careful of what you set need_ident to in your auth {} blocks.
1159		*/
1160		disable_auth = no;
1161
#	Line 1020 | Line 1167 | general {
1167
1168		/*
1169		* default_floodcount: the default value of floodcount that is configurable
1170	<	* via /quote set floodcount. This is the number of lines a user
1171	<	* may send to any other user/channel in one second.
1170	>	* via /quote set floodcount. This is the number of lines a user may send
1171	>	* to any other user/channel per floodtime. Set to 0 to disable.
1172		*/
1173		default_floodcount = 10;
1174
1175		/*
1176	+	* default_floodtime: the default value of floodtime that is configurable
1177	+	* via /quote set floodtime.
1178	+	*/
1179	+	default_floodtime = 1 second;
1180	+
1181	+	/*
1182		* failed_oper_notice: send a notice to all opers on the server when
1183		* someone tries to OPER and uses the wrong password, host or ident.
1184		*/
#	Line 1039 | Line 1192 | general {
1192
1193		/*
1194		* min_nonwildcard: the minimum number of non-wildcard characters in
1195	<	* k/d/g lines placed via the server. K-lines hand-placed are exempt from
1195	>	* k/d lines placed via the server. K-lines hand-placed are exempt from
1196		* this limit.
1197	<	* Wildcard chars: '.', ':', '*', '?', '@', '!'
1197	>	* Wildcard characters: '.', ':', '*', '?'
1198		*/
1199		min_nonwildcard = 4;
1200
1201		/*
1202		* min_nonwildcard_simple: the minimum number of non-wildcard characters
1203	<	* in gecos bans. Wildcard chars: '*', '?'
1203	>	* in gecos bans. Wildcard characters: '*', '?'
1204		*/
1205		min_nonwildcard_simple = 3;
1206
1054	–	/* max_accept: maximum allowed /accept's for +g usermode. */
1055	–	max_accept = 20;
1056	–
1207		/* anti_nick_flood: enable the nickflood control code. */
1208		anti_nick_flood = yes;
1209
1210	<	/* nick flood: the number of nick changes allowed in the specified period */
1211	<	max_nick_time = 20 seconds;
1210	>	/*
1211	>	* max_nick_changes, max_nick_time: the number of nick changes allowed in
1212	>	* the specified period.
1213	>	*/
1214		max_nick_changes = 5;
1215	+	max_nick_time = 20 seconds;
1216	+
1217	+	/*
1218	+	* away_count, away_time: how many AWAY commands are permitted per
1219	+	* client per away_time.
1220	+	*/
1221	+	away_count = 2;
1222	+	away_time = 10 seconds;
1223
1224		/*
1225		* anti_spam_exit_message_time: the minimum time a user must be connected
1226	<	* before custom quit messages are allowed.
1226	>	* before custom PART/QUIT messages are allowed.
1227		*/
1228		anti_spam_exit_message_time = 5 minutes;
1229
1230		/*
1231	<	* ts delta: the time delta allowed between server clocks before
1232	<	* a warning is given, or before the link is dropped. All servers
1233	<	* should run ntpdate/rdate to keep clocks in sync
1231	>	* ts_warn_delta, ts_max_delta: the time delta allowed between server
1232	>	* clocks before a warning is given, or before the link is dropped.
1233	>	* All servers should run ntpdate/rdate to keep clocks in sync.
1234		*/
1235	<	ts_warn_delta = 30 seconds;
1236	<	ts_max_delta = 5 minutes;
1235	>	ts_warn_delta = 3 seconds;
1236	>	ts_max_delta = 15 seconds;
1237
1238		/*
1239	<	* warn_no_nline: warn opers about servers that try to connect but
1240	<	* for which we don't have a connect {} block. Twits with misconfigured
1241	<	* servers can become really annoying with this enabled.
1239	>	* warn_no_connect_block: warn opers about servers that try to connect
1240	>	* but for which we don't have a connect {} block. Twits with
1241	>	* misconfigured servers can become really annoying with this enabled.
1242		*/
1243	<	warn_no_nline = yes;
1243	>	warn_no_connect_block = yes;
1244
1245		/*
1246		* stats_e_disabled: set this to 'yes' to disable "STATS e" for both
1247		* operators and administrators. Doing so is a good idea in case
1248	<	* there are any exempted (exempt{}) server IPs you don't want to
1249	<	* see leaked.
1248	>	* there are any exempted (exempt {}) server IP addresses you don't
1249	>	* want to see leaked.
1250		*/
1251		stats_e_disabled = no;
1252
1253	<	/* stats_o_oper only: make stats o (opers) oper only */
1253	>	/* stats_m_oper_only: make /stats m/M (messages) oper only. */
1254	>	stats_m_oper_only = yes;
1255	>
1256	>	/* stats_o_oper_only: make stats o (opers) oper only. */
1257		stats_o_oper_only = yes;
1258
1259	<	/* stats_P_oper_only: make stats P (ports) oper only */
1259	>	/* stats_P_oper_only: make stats P (ports) oper only. */
1260		stats_P_oper_only = yes;
1261
1262	<	/* stats_u_oper_only: make stats u (uptime) oper only */
1262	>	/* stats_u_oper_only: make stats u (uptime) oper only. */
1263		stats_u_oper_only = no;
1264
1265		/*
1266	<	* stats i oper only: make stats i (auth {}) oper only. Set to:
1267	<	*     yes    - show users no auth blocks, made oper only.
1268	<	*     masked - show users the first matching auth block
1269	<	*     no     - show users all auth blocks.
1266	>	* stats_i_oper_only: make stats i (auth {}) oper only. Set to:
1267	>	*     yes    - show users no auth {} blocks, made oper only
1268	>	*     masked - show users the first matching auth {} block
1269	>	*     no     - show users all auth {} blocks
1270		*/
1271		stats_i_oper_only = yes;
1272
1273		/*
1274		* stats_k_oper_only: make stats k/K (klines) oper only. Set to:
1275	<	*     yes    - show users no auth blocks, made oper only
1276	<	*     masked - show users the first matching auth block
1277	<	*     no     - show users all auth blocks.
1275	>	*     yes    - show users no klines, made oper only
1276	>	*     masked - show users the first matching kline
1277	>	*     no     - show users all klines
1278		*/
1279		stats_k_oper_only = yes;
1280
#	Line 1123 | Line 1286 | general {
1286
1287		/*
1288		* opers_bypass_callerid: allows operators to bypass +g and message
1289	<	* anyone who has it set (useful if you use services).
1289	>	* anyone who has it set.
1290		*/
1291		opers_bypass_callerid = no;
1292
1293		/*
1294		* pace_wait_simple: minimum time required between use of less
1295		* intensive commands
1296	<	* (ADMIN, HELP, (L)USERS, VERSION, remote WHOIS)
1296	>	* (ADMIN, HELP, LUSERS, VERSION, remote WHOIS)
1297		*/
1298		pace_wait_simple = 1 second;
1299
1300		/*
1301		* pace_wait: minimum time required between use of more intensive commands
1302	<	* (AWAY, INFO, LINKS, MAP, MOTD, STATS, WHO, wildcard WHOIS, WHOWAS)
1302	>	* (INFO, LINKS, MAP, MOTD, STATS, WHO, WHOWAS)
1303		*/
1304		pace_wait = 10 seconds;
1305
#	Line 1147 | Line 1310 | general {
1310		short_motd = no;
1311
1312		/*
1313	<	* ping_cookie: require clients to respond exactly to a ping command,
1313	>	* ping_cookie: require clients to respond exactly to a PING command,
1314		* can help block certain types of drones and FTP PASV mode spoofing.
1315		*/
1316		ping_cookie = no;
#	Line 1156 | Line 1319 | general {
1319		no_oper_flood = yes;
1320
1321		/*
1159	–	* true_no_oper_flood: completely eliminate flood limits for opers
1160	–	* and for clients with can_flood = yes in their auth {} blocks.
1161	–	*/
1162	–	true_no_oper_flood = yes;
1163	–
1164	–	/* oper_pass_resv: allow opers to over-ride RESVs on nicks/channels. */
1165	–	oper_pass_resv = yes;
1166	–
1167	–	/* REMOVE ME.  The following line checks that you have been reading. */
1168	–	havent_read_conf = 1;
1169	–
1170	–	/*
1322		* max_targets: the maximum number of targets in a single
1323		* PRIVMSG/NOTICE. Set to 999 NOT 0 for unlimited.
1324		*/
1325		max_targets = 4;
1326
1327		/*
1328	<	* usermodes configurable: a list of usermodes for the options below
1328	>	* user modes configurable: a list of user modes for the options below
1329		*
1330		* +b - bots         - See bot and drone flooding notices
1331		* +c - cconn        - Client connection/quit notices
#	Line 1182 | Line 1333 | general {
1333		* +d - debug        - See debugging notices
1334		* +e - external     - See remote server connection and split notices
1335		* +F - farconnect   - Remote client connection/quit notices
1336	<	* +f - full         - See auth{} block full notices
1336	>	* +f - full         - See auth {} block full notices
1337		* +G - softcallerid - Server Side Ignore for users not on your channels
1338		* +g - callerid     - Server Side Ignore (for privmsgs etc)
1339	<	* +H - hidden       - Hides operator status to other users
1340	<	* +i - invisible    - Not shown in NAMES or WHO unless you share a
1190	<	*                     a channel
1339	>	* +H - hidden       - Hides IRC operator status to other users
1340	>	* +i - invisible    - Not shown in NAMES or WHO unless you share a channel
1341		* +j - rej          - See rejected client notices
1342		* +k - skill        - See server generated KILL messages
1343		* +l - locops       - See LOCOPS messages
1344		* +n - nchange      - See client nick changes
1345	+	* +p - hidechans    - Hides channel list in WHOIS
1346	+	* +q - hideidle     - Hides idle and signon time in WHOIS
1347		* +R - nononreg     - Only receive private messages from registered clients
1348		* +s - servnotice   - See general server notices
1349		* +u - unauth       - See unauthorized client notices
1350		* +w - wallop       - See server generated WALLOPS
1351		* +y - spy          - See LINKS, STATS, TRACE notices etc.
1200	–	* +z - operwall     - See oper generated WALLOPS
1352		*/
1353
1354	<	/* oper_only_umodes: usermodes only opers may set */
1355	<	oper_only_umodes = bots, cconn, debug, full, hidden, skill,
1356	<	nchange, rej, spy, external, operwall,
1206	<	locops, unauth, farconnect;
1207	<
1208	<	/* oper_umodes: default usermodes opers get when they /oper */
1209	<	oper_umodes = bots, locops, servnotice, operwall, wallop;
1354	>	/* oper_only_umodes: user modes only operators may set. */
1355	>	oper_only_umodes = bots, cconn, debug, external, farconnect, full, hidden,
1356	>	locops, nchange, rej, skill, spy, unauth;
1357
1358	<	/*
1359	<	* use_egd: if your system does not have *random devices yet you
1213	<	* want to use OpenSSL and encrypted links, enable this. Beware -
1214	<	* EGD is *very* CPU intensive when gathering data for its pool.
1215	<	*/
1216	<	#       use_egd = yes;
1358	>	/* oper_umodes: default user modes operators get when they successfully OPER. */
1359	>	oper_umodes = bots, locops, servnotice, wallop;
1360
1361		/*
1362	<	* egdpool_path: path to EGD pool. Not necessary for OpenSSL >= 0.9.7
1363	<	* which automatically finds the path.
1362	>	* throttle_count: the maximum number of connections from the same
1363	>	* IP address allowed in throttle_time duration.
1364		*/
1365	<	#       egdpool_path = "/var/run/egd-pool";
1365	>	throttle_count = 1;
1366
1367		/*
1368		* throttle_time: the minimum amount of time required between
1369	<	* connections from the same IP address. exempt {} blocks are excluded
1370	<	* from this throttling.
1369	>	* connections from the same IP address. exempt {} blocks are
1370	>	* excluded from this throttling.
1371		* Offers protection against flooders who reconnect quickly.
1372		* Set to 0 to disable.
1373		*/
1374	<	throttle_time = 10;
1374	>	throttle_time = 2 seconds;
1375		};
1376
1377		modules {
#	Line 1236 | Line 1379 | modules {
1379		* path: other paths to search for modules specified below
1380		* and in "/module load".
1381		*/
1382	<	path = "/usr/local/ircd/lib/ircd-hybrid/modules";
1383	<	path = "/usr/local/ircd/lib/ircd-hybrid/modules/autoload";
1382	>	path = "lib/ircd-hybrid/modules";
1383	>	#       path = "lib/ircd-hybrid/modules/extra";
1384	>	path = "lib/ircd-hybrid/modules/autoload";
1385
1386		/* module: the name of a module to load on startup/rehash. */
1387		#       module = "some_module.la";
#	Line 1252 | Line 1396 | log {
1396
1397		file {
1398		type = oper;
1399	<	name = "/usr/local/ircd/var/log/oper.log";
1399	>	name = "var/log/oper.log";
1400		size = unlimited;
1401		};
1402
1403		file {
1404		type = user;
1405	<	name = "/usr/local/ircd/var/log/user.log";
1405	>	name = "var/log/user.log";
1406		size = 50 megabytes;
1407		};
1408
1409		file {
1410		type = kill;
1411	<	name = "/usr/local/ircd/var/log/kill.log";
1411	>	name = "var/log/kill.log";
1412		size = 50 megabytes;
1413		};
1414
1415		file {
1416		type = kline;
1417	<	name = "/usr/local/ircd/var/log/kline.log";
1417	>	name = "var/log/kline.log";
1418		size = 50 megabytes;
1419		};
1420
1421		file {
1422		type = dline;
1423	<	name = "/usr/local/ircd/var/log/dline.log";
1423	>	name = "var/log/dline.log";
1424	>	size = 50 megabytes;
1425	>	};
1426	>
1427	>	file {
1428	>	type = xline;
1429	>	name = "var/log/xline.log";
1430		size = 50 megabytes;
1431		};
1432
1433		file {
1434	<	type = gline;
1435	<	name = "/usr/local/ircd/var/log/gline.log";
1434	>	type = resv;
1435	>	name = "var/log/resv.log";
1436		size = 50 megabytes;
1437		};
1438
1439		file {
1440		type = debug;
1441	<	name = "/usr/local/ircd/var/log/debug.log";
1441	>	name = "var/log/debug.log";
1442		size = 50 megabytes;
1443		};
1444		};

Comparing ircd-hybrid/trunk/doc/reference.conf (property svn:keywords):
Revision 2322 by michael, Sun Jun 23 12:01:30 2013 UTC vs.
Revision 7924 by michael, Sat Dec 31 13:57:08 2016 UTC

#	Line 1 | Line 1
1	<	Id Revision
1	>	Id

Diff Legend

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