ViewVC Help

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

root/svn/ircd-hybrid/branches/8.2.x/doc/reference.conf

Comparing:
ircd-hybrid-7.3/etc/example.conf (file contents), Revision 1070 by michael, Tue Feb 16 23:40:20 2010 UTC vs.
ircd-hybrid/branches/8.2.x/doc/reference.conf (file contents), Revision 3867 by michael, Thu Jun 5 22:11:02 2014 UTC

#	Line 1 | Line 1
1	<	/* doc/example.conf - ircd-hybrid-7 Example configuration file
2	<	* Copyright (C) 2000-2010 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	<	* etc/.
4	>	* Copyright (c) 2000-2014 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,
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. (OLD M:)
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";
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	<	sid = "_CHANGE_ME_";
53	>	sid = "0HY";
54
55		/*
56	<	* description: the description of the server.  '[' and ']' may not
60	<	* be used here for compatibility with older servers.
56	>	* description: the description of the server.
57		*/
58	<	description = "hybrid-7 test server";
58	>	description = "ircd-hybrid test server";
59
60		/*
61		* network info: the name and description of the network this server
62	<	* is on.  Shown in the 005 reply and used with serverhiding.
62	>	* is on. Shown in the 005 reply and used with serverhiding.
63		*/
64		network_name = "MyNet";
65		network_desc = "This is My Network";
#	Line 78 | Line 74 | serverinfo {
74		* vhost: the IP to bind to when we connect outward to ipv4 servers.
75		* This should be an ipv4 IP only, or "*" for INADDR_ANY.
76		*/
77	<	#vhost = "192.169.0.1";
77	>	#       vhost = "192.169.0.1";
78
79		/*
80	<	* vhost6: the IP to bind to when we connect outward to ipv6 servers.
81	<	* This should be an ipv6 IP only, or "*" for INADDR_ANY.
80	>	* vhost6: the address to bind to when we make outgoing connections
81	>	* to IPv6 servers. This should be an IPv6 address, or "*" for INADDR_ANY.
82		*/
83	<	#vhost6 = "3ffe:80e8:546::2";
83	>	#       vhost6 = "3ffe:80e8:546::2";
84
85	<	/* max_clients: the maximum number of clients allowed to connect */
85	>	/* max_clients: the maximum number of clients allowed to connect. */
86		max_clients = 512;
87
88		/*
89	<	* rsa_private_key_file: the path to the file containing our
90	<	* rsa key for cryptlink.
89	>	* max_nick_length: only applies to local clients. Must be in the
90	>	* range of 9 to 30. Default is 9 if nothing else is specified.
91	>	*/
92	>	max_nick_length = 9;
93	>
94	>	/*
95	>	* max_topic_length: only applies to topics set by local clients.
96	>	* Must be in the range of 80 to 300. Default is 80 if nothing
97	>	* else is specified.
98	>	*/
99	>	max_topic_length = 160;
100	>
101	>	/*
102	>	* rsa_private_key_file: the path to the file containing the
103	>	* RSA key.
104	>	*
105	>	* Example commands to store a 2048 bit RSA key in rsa.key:
106		*
107	<	* Example command to store a 2048 bit RSA keypair in
108	<	* rsa.key, and the public key in rsa.pub:
98	<	*
99	<	*      openssl genrsa -out rsa.key 2048
100	<	*      openssl rsa -in rsa.key -pubout -out rsa.pub
101	<	*      chown <ircd-user>.<ircd.group> rsa.key rsa.pub
107	>	*      openssl genrsa -out rsa.key 2048
108	>	*      chown <ircd-user>.<ircd.group> rsa.key
109		*      chmod 0600 rsa.key
103	–	*      chmod 0644 rsa.pub
110		*/
111	<	#rsa_private_key_file = "/usr/local/ircd/etc/rsa.key";
111	>	#       rsa_private_key_file = "/usr/local/ircd/etc/rsa.key";
112
113		/*
114		* ssl_certificate_file: the path to the file containing our
115	<	* ssl certificate for encrypted client connection.
115	>	* SSL certificate for encrypted client connection.
116		*
117		* This assumes your private RSA key is stored in rsa.key. You
118	<	* MUST have an RSA key in order to generate the certificate
118	>	* MUST have an RSA key in order to generate the certificate.
119	>	*
120	>	* Example command:
121		*
122		*      openssl req -new -days 365 -x509 -key rsa.key -out cert.pem
123		*
#	Line 122 | Line 130 | serverinfo {
130		*      Common Name: irc.someirc.net
131		*      E-mail: you@domain.com
132		*/
133	<	#ssl_certificate_file = "/usr/local/ircd/etc/cert.pem";
133	>	#       ssl_certificate_file = "/usr/local/ircd/etc/cert.pem";
134	>
135	>	/*
136	>	* ssl_dh_param_file:
137	>	*
138	>	* Path to the PEM encoded Diffie-Hellman parameter file.
139	>	* DH parameters are required when using ciphers with EDH
140	>	* (ephemeral Diffie-Hellman) key exchange.
141	>	*
142	>	* A DH parameter file can be created by running:
143	>	*
144	>	*      openssl dhparam -out dhparam.pem 2048
145	>	*
146	>	* Prime size must be at least 1024 bits. Further information
147	>	* regarding specific OpenSSL dhparam command-line options
148	>	* can be found in the OpenSSL manual.
149	>	*/
150	>	#       ssl_dh_param_file = "/usr/local/ircd/etc/dhparam.pem";
151
152		/*
153	<	* ssl_server_protocol:
154	<	* SSL/TLS protocols we provide for incoming secure connections.
153	>	* ssl_cipher_list:
154	>	*
155	>	* List of ciphers to support on _this_ server. Can be used to
156	>	* enforce specific ciphers for incoming SSL/TLS connections.
157	>	* If a client (which also includes incoming server connections) is not
158	>	* capable of using any of the ciphers listed here, the connection will
159	>	* simply be rejected.
160	>	*
161	>	* A list of supported ciphers by OpenSSL can be obtained by running:
162	>	*
163	>	*      openssl ciphers -ssl3 -tls1 -v
164	>	*
165	>	* Multiple ciphers are separated by colons. The order of preference is
166	>	* from left to right.
167	>	*/
168	>	#       ssl_cipher_list = "ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES256-SHA:AES256-SHA";
169	>
170	>	/*
171	>	* ssl_server_method:
172	>	* ssl_client_method:
173	>	*
174	>	* SSL/TLS methods we provide for incoming (server method) and
175	>	* outgoing (client method) SSL/TLS connections.
176		* This can be either sslv3 for SSLv3, and/or tlsv1 for TLSv1.
131	–	* SSLv2 is not suppported. This cannot be changed at runtime.
177		*/
178	<	#ssl_server_protocol = sslv3, tlsv1;
178	>	#       ssl_server_method = tlsv1, sslv3;
179	>	#       ssl_client_method = tlsv1;
180		};
181
182		/*
183	<	* admin {}:  contains admin information about the server. (OLD A:)
183	>	* admin {}:  contains admin information about the server
184		*/
185		admin {
186		name = "Smurf target";
#	Line 143 | Line 189 | admin {
189		};
190
191		/*
192	<	* log {}:  contains information about logfiles.
147	<	*/
148	<	log {
149	<	/* Do you want to enable logging to ircd.log? */
150	<	use_logging = yes;
151	<
152	<	/*
153	<	* logfiles: the logfiles to use for user connects, /oper uses,
154	<	* and failed /oper.  These files must exist for logging to be used.
155	<	*/
156	<	fname_userlog = "logs/userlog";
157	<	fname_operlog = "logs/operlog";
158	<	fname_killlog = "logs/kill";
159	<	fname_klinelog = "logs/kline";
160	<	fname_glinelog = "logs/gline";
161	<
162	<	/*
163	<	* log_level: the amount of detail to log in ircd.log.  The
164	<	* higher, the more information is logged.  May be changed
165	<	* once the server is running via /quote SET LOG.  Either:
166	<	* L_CRIT, L_ERROR, L_WARN, L_NOTICE, L_TRACE, L_INFO or L_DEBUG
167	<	*/
168	<	log_level = L_INFO;
169	<	};
170	<
171	<	/*
172	<	* class {}:  contains information about classes for users (OLD Y:)
192	>	* class {}:  contains information about classes for users
193		*/
194		class {
195	<	/* name: the name of the class.  classes are text now */
195	>	/* name: the name of the class. */
196		name = "users";
197
198		/*
#	Line 183 | Line 203 | class {
203
204		/*
205		* number_per_ip: how many local users are allowed to connect
206	<	* from one IP  (optional)
206	>	* from a single IP address  (optional)
207		*/
208		number_per_ip = 2;
209
210		/*
211		* max_local: how many local users are allowed to connect
212	<	* from one ident@host  (optional)
212	>	* from a single ident@host  (optional)
213		*/
214		max_local = 2;
215
#	Line 205 | Line 225 | class {
225
226		/*
227		* the following lines are optional and allow you to define
228	<	* how many users can connect from one /NN subnet
228	>	* how many users can connect from one /NN subnet.
229		*/
230		cidr_bitlen_ipv4 = 24;
231		cidr_bitlen_ipv6 = 120;
232		number_per_cidr = 16;
233
234		/*
235	<	* sendq: the amount of data allowed in a clients queue before
235	>	* sendq: the amount of data allowed in a client's send queue before
236		* they are dropped.
237		*/
238		sendq = 100 kbytes;
239	+
240	+	/*
241	+	* recvq: the amount of data allowed in a client's receive queue before
242	+	* they are dropped for flooding. Defaults to 2560 if the chosen
243	+	* value isn't within the range of 512 to 8000.
244	+	*/
245	+	recvq = 2560 bytes;
246		};
247
248		class {
#	Line 223 | Line 250 | class {
250		ping_time = 90 seconds;
251		number_per_ip = 10;
252		max_number = 100;
253	<	sendq = 100kbytes;
253	>	sendq = 100 kbytes;
254	>
255	>	/*
256	>	* min_idle: minimum idle time that is shown in /whois.
257	>	*/
258	>	min_idle = 3 hours;
259	>
260	>	/*
261	>	* max_idle: maximum idle time that is shown in /whois.
262	>	*/
263	>	max_idle = 8 hours;
264	>
265	>	/*
266	>	* flags:
267	>	*
268	>	* random_idle          - a fake idle time is set randomly between
269	>	*                        min_idle and max_idle
270	>	* hide_idle_from_opers - the fake idle time will also be shown to operators
271	>	*/
272	>	flags = random_idle, hide_idle_from_opers;
273		};
274
275		class {
#	Line 231 | Line 277 | class {
277		ping_time = 90 seconds;
278
279		/*
280	<	* ping_warning: how fast a server must reply to a PING before
235	<	* a warning to opers is generated.
236	<	*/
237	<	ping_warning = 15 seconds;
238	<
239	<	/*
240	<	* connectfreq: only used in server classes.  Specifies the delay
280	>	* connectfreq: only used in server classes. Specifies the delay
281		* between autoconnecting to servers.
282		*/
283		connectfreq = 5 minutes;
284
285	<	/* max number: the amount of servers to autoconnect to */
285	>	/* max number: the number of servers to autoconnect to. */
286		max_number = 1;
287
288	<	/* sendq: servers need a higher sendq as they send more data */
288	>	/* sendq: servers need a higher sendq as they send more data. */
289		sendq = 2 megabytes;
290		};
291
292		/*
293	<	* listen {}:  contains information about the ports ircd listens on (OLD P:)
293	>	* motd {}: Allows the display of a different MOTD to a client
294	>	* depending on its origin. Applies to local users only.
295	>	*/
296	>	motd {
297	>	/*
298	>	* mask: multiple mask entries are permitted. Mask can either be
299	>	* a class name or a hostname. CIDR is supported.
300	>	*/
301	>	mask = "*.at";
302	>	mask = "*.de";
303	>	mask = "*.ch";
304	>
305	>	/*
306	>	* file: path to the actual motd file.
307	>	*/
308	>	file = "/usr/local/ircd/etc/german.motd";
309	>	};
310	>
311	>	/*
312	>	* listen {}:  contains information about the ports ircd listens on
313		*/
314		listen {
315		/*
316	<	* port: the specific port to listen on.  If no host is specified
317	<	* before, it will listen on all available IPs.
316	>	* port: the port to listen on. If no host is specified earlier
317	>	* in the listen {} block, it will listen on all available IPs.
318		*
319	<	* Ports are separated via a comma, a range may be specified using ".."
319	>	* Ports are separated by commas; a range may be specified using ".."
320		*/
321	<
322	<	/* port: listen on all available IPs, ports 6665 to 6669 */
321	>
322	>	/* port: listen on all available IP addresses, ports 6665 to 6669 */
323		port = 6665 .. 6669;
324
325		/*
326	<	* Listen on 192.168.0.1/6697 with ssl enabled and hidden from STATS P
326	>	* Listen on 192.168.0.1/6697 with SSL enabled and hidden from STATS P
327		* unless you are an administrator.
328		*
329	<	* NOTE: The "flags" directive has to come before "port".  Always!
329	>	* NOTE: The "flags" directive always has to come before "port".
330		*
331		* Currently available flags are:
332		*
333	<	*  ssl    - Port is for SSL client connections only
333	>	*  ssl    - Port may only accept TLS/SSL connections
334		*  server - Only server connections are permitted
335	<	*  hidden - Port is hidden from /stats P
335	>	*  hidden - Port is hidden from /stats P, unless you're an admin
336		*/
337		flags = hidden, ssl;
338		host = "192.168.0.1";
339		port = 6697;
340
341		/*
342	<	* host: set a specific IP/host the ports after the line will listen
343	<	* on.  This may be ipv4 or ipv6.
342	>	* host: set a specific IP address/host to listen on using the
343	>	* subsequent port definitions. This may be IPv4 or IPv6.
344		*/
345		host = "1.2.3.4";
346		port = 7000, 7001;
#	Line 291 | Line 350 | listen {
350		};
351
352		/*
353	<	* auth {}:  allow users to connect to the ircd (OLD I:)
353	>	* auth {}:  allow users to connect to the ircd
354		*/
355		auth {
356		/*
357	<	* user: the user@host allowed to connect.  Multiple IPv4/IPv6 user
358	<	* lines are permitted per auth block.
357	>	* user: the user@host allowed to connect. Multiple user
358	>	* lines are permitted within each auth block.
359		*/
360		user = "*@172.16.0.0/12";
361		user = "*test@123D:B567:*";
#	Line 311 | Line 370 | auth {
370		encrypted = yes;
371
372		/*
373	<	* spoof: fake the users host to this.  This is free-form,
374	<	* just do everyone a favor and don't abuse it. ('=' prefix on /stats I)
373	>	* spoof: fake the user's host to this. This is free-form, just do
374	>	* everyone a favor and don't abuse it. ('=' prefix on /stats I)
375		*/
376		spoof = "I.still.hate.packets";
377
#	Line 320 | Line 379 | auth {
379		class = "opers";
380
381		/*
382	<	* need_password: don't allow users who haven't supplied the correct
383	<	*                password to connect using another auth{} block
384	<	*                ('&' prefix on /stats I if disabled)
385	<	* need_ident:    require the user to have identd to connect ('+' prefix on /stats I)
386	<	* spoof_notice:  enable spoofing notification to admins
387	<	* exceed_limit:  allow a user to exceed class limits ('>' prefix on /stats I)
388	<	* kline_exempt:  exempt this user from k/glines ('^' prefix on /stats I)
389	<	* gline_exempt:  exempt this user from glines ('_' prefix on /stats I)
390	<	* resv_exempt:   exempt this user from resvs ('$' prefix on /stats I)
391	<	* no_tilde:      remove ~ from a user with no ident ('-' prefix on /stats I)
392	<	* can_flood:     allow this user to exceed flood limits ('|' prefix on /stats I)
393	<	* can_idle:      exempt this user from idle restrictions ('<' prefix on /stats I)
382	>	* need_password - don't allow users who haven't supplied the correct
383	>	*                 password to connect using another auth{} block
384	>	*                 ('&' prefix on /stats I if disabled)
385	>	* need_ident    - require the user to have identd to connect ('+' prefix on /stats I)
386	>	* spoof_notice  - enable spoofing notification to admins
387	>	* exceed_limit  - allow a user to exceed class limits ('>' prefix on /stats I)
388	>	* kline_exempt  - exempt this user from k/glines ('^' prefix on /stats I)
389	>	* gline_exempt  - exempt this user from glines ('_' prefix on /stats I)
390	>	* resv_exempt   - exempt this user from resvs ('$' prefix on /stats I)
391	>	* no_tilde      - remove ~ from a user with no ident ('-' prefix on /stats I)
392	>	* can_flood     - allow this user to exceed flood limits ('|' prefix on /stats I)
393	>	* webirc        - enables WEBIRC authentication for web-based clients such as Mibbit
394	>	*                 ('<' prefix on /stats I)
395		*/
396		flags = need_password, spoof_notice, exceed_limit, kline_exempt,
397	<	gline_exempt, resv_exempt, no_tilde, can_flood, can_idle;
397	>	gline_exempt, resv_exempt, no_tilde, can_flood;
398		};
399
400		auth {
401		/*
402	<	* redirect: the server and port to redirect a user to.  A user does
403	<	* not have to obey the redirection, the ircd just suggests an alternative
402	>	* redirect: the server and port to redirect a user to. A user does not
403	>	* have to obey the redirection; the ircd just suggests an alternative
404		* server for them.
405		*/
406		redirserv = "this.is.not.a.real.server";
407		redirport = 6667;
408	<
408	>
409		user = "*.server";
410
411		/* class: a class is required even though it is not used */
#	Line 359 | Line 419 | auth {
419		};
420
421		/*
422	<	* operator {}:  defines ircd operators. (OLD O:)
363	<	*
364	<	* ircd-hybrid no longer supports local operators, privileges are
365	<	* controlled via flags.
422	>	* operator {}:  defines ircd operators
423		*/
424		operator {
425		/* name: the name of the oper */
426	<	/* NOTE: operator "opername"{} is also supported */
370	<	name = "god";
426	>	name = "sheep";
427
428		/*
429	<	* user: the user@host required for this operator.  CIDR is not
430	<	* supported.  Multiple user="" lines are supported.
429	>	* user: the user@host required for this operator. Multiple user
430	>	* lines are permitted within each operator block.
431		*/
432	<	user = "*god@*";
433	<	user = "*@127.0.0.1";
432	>	user = "*sheep@192.168.0.0/16";
433	>	user = "*@127.0.0.0/8";
434
435		/*
436	<	* password: the password required to oper.  By default this will
436	>	* password: the password required to oper. By default this will
437		* need to be encrypted by using the provided mkpasswd tool.
438		* Several password hash algorithms are available depending
439		* on your system's crypt() implementation. For example, a modern
440	<	* glibc already has support for SHA-256/512, and MD5 encryption
440	>	* glibc already has support for the SHA-256/512 and MD5 encryption
441		* algorithms.
442		*/
443		password = "$5$x5zof8qe.Yc7/bPp$5zIg1Le2Lsgd4CvOjaD20pr5PmcfD7ha/9b2.TaUyG4";
#	Line 394 | Line 450 | operator {
450
451		/*
452		* rsa_public_key_file: the public key for this oper when using Challenge.
453	<	* A password should not be defined when this is used, see
453	>	* A password should not be defined when this is used; see
454		* doc/challenge.txt for more information.
455		*/
456		#       rsa_public_key_file = "/usr/local/ircd/etc/oper.pub";
457
458	+	/*
459	+	* ssl_certificate_fingerprint: enhances security by additionally checking
460	+	* the oper's client certificate fingerprint against the specified
461	+	* fingerprint below.
462	+	*
463	+	* Hint: your users can use the following command to obtain a SHA-256 hash
464	+	* of their ssl certificate:
465	+	*
466	+	*      openssl x509 -sha256 -noout -fingerprint -in cert.pem | sed -e 's/^.*=//;s/://g'
467	+	*/
468	+	#       ssl_certificate_fingerprint = "4C62287BA6776A89CD4F8FF10A62FFB35E79319F51AF6C62C674984974FCCB1D";
469	+
470	+	/*
471	+	* ssl_connection_required: client must be connected over SSL/TLS
472	+	* in order to be able to use this oper{} block.
473	+	* Default is 'no' if nothing else is specified.
474	+	*/
475	+	ssl_connection_required = no;
476	+
477		/* class: the class the oper joins when they successfully /oper */
478		class = "opers";
479
480		/*
481	<	* umodes: default usermodes opers get when they /oper.  If defined,
481	>	* umodes: the default usermodes opers get when they /oper. If defined,
482		* it will override oper_umodes settings in general {}.
483		* Available usermodes:
484		*
485		* +b - bots         - See bot and drone flooding notices
486		* +c - cconn        - Client connection/quit notices
412	–	* +C - cconn_full   - Client connection/quit notices full
487		* +D - deaf         - Don't receive channel messages
488		* +d - debug        - See debugging notices
489	<	* +f - full         - See I: line full notices
489	>	* +e - external     - See remote server connection and split notices
490	>	* +F - farconnect   - Remote client connection/quit notices
491	>	* +f - full         - See auth{} block full notices
492		* +G - softcallerid - Server Side Ignore for users not on your channels
493		* +g - callerid     - Server Side Ignore (for privmsgs etc)
494	<	* +i - invisible    - Not shown in NAMES or WHO unless you share a
495	<	*                     a channel
494	>	* +H - hidden       - Hides operator status to other users
495	>	* +i - invisible    - Not shown in NAMES or WHO unless you share a channel
496	>	* +j - rej          - See rejected client notices
497		* +k - skill        - See server generated KILL messages
498		* +l - locops       - See LOCOPS messages
499		* +n - nchange      - See client nick changes
500	<	* +r - rej          - See rejected client notices
500	>	* +p - hidechans    - Hides channel list in WHOIS
501	>	* +q - hideidle     - Hides idle and signon time in WHOIS
502	>	* +R - nononreg     - Only receive private messages from registered clients
503		* +s - servnotice   - See general server notices
504		* +u - unauth       - See unauthorized client notices
505		* +w - wallop       - See server generated WALLOPS
427	–	* +x - external     - See remote server connection and split notices
506		* +y - spy          - See LINKS, STATS, TRACE notices etc.
429	–	* +z - operwall     - See oper generated WALLOPS
507		*/
508	<	#       umodes = locops, servnotice, operwall, wallop;
508	>	umodes = locops, servnotice, wallop;
509
510		/*
511	<	* privileges: controls the activities and commands an oper is
512	<	* allowed to do on the server.  All options default to no.
511	>	* privileges: controls the activities and commands an oper is
512	>	* allowed to do on the server. All options default to no.
513		* Available options:
514		*
515	<	* global_kill:  allows remote users to be /KILL'd (OLD 'O' flag)
516	<	* remote:       allows remote SQUIT and CONNECT   (OLD 'R' flag)
517	<	* remoteban:    allows remote KLINE/UNKLINE
518	<	* kline:        allows KILL, KLINE and DLINE      (OLD 'K' flag)
519	<	* unkline:      allows UNKLINE and UNDLINE        (OLD 'U' flag)
520	<	* gline:        allows GLINE                      (OLD 'G' flag)
521	<	* xline:        allows XLINE                      (OLD 'X' flag)
522	<	* operwall:     allows OPERWALL
523	<	* nick_changes: allows oper to see nickchanges    (OLD 'N' flag)
524	<	*               via usermode +n
525	<	* rehash:       allows oper to REHASH config      (OLD 'H' flag)
526	<	* die:          allows DIE and RESTART            (OLD 'D' flag)
527	<	* admin:        gives admin privileges.  admins
528	<	*               may (un)load modules and see the
529	<	*               real IPs of servers.
530	<	* hidden_admin: same as 'admin', but noone can recognize you as
531	<	*               being an admin
532	<	* hidden_oper:  not shown in /stats p (except for other operators)
533	<	*/
534	<	/* You can either use
535	<	* die = yes;
536	<	* rehash = yes;
537	<	*
461	<	* or in a flags statement i.e.
462	<	* flags = die, rehash;
463	<	*
464	<	* You can also negate a flag with ~ i.e.
465	<	* flags = ~remote;
466	<	*
515	>	* module         - allows MODULE
516	>	* connect        - allows local CONNECT              | ('P' flag)
517	>	* connect:remote - allows remote CONNECT             | ('Q' flag)
518	>	* squit          - allows local SQUIT                | ('R' flag)
519	>	* squit:remote   - allows remote SQUIT               | ('S' flag)
520	>	* kill           - allows to KILL local clients      | ('N' flag)
521	>	* kill:remote    - allows remote users to be /KILL'd | ('O' flag)
522	>	* remoteban      - allows remote KLINE/UNKLINE       | ('B' flag)
523	>	* dline          - allows DLINE                      |
524	>	* undline        - allows UNDLINE                    |
525	>	* kline          - allows KLINE                      | ('K' flag)
526	>	* unkline        - allows UNKLINE                    | ('U' flag)
527	>	* gline          - allows GLINE                      | ('G' flag)
528	>	* xline          - allows XLINE                      | ('X' flag)
529	>	* unxline        - allows UNXLINE                    |
530	>	* locops         - allows LOCOPS                     |
531	>	* globops        - allows GLOBOPS                    |
532	>	* wallops        - allows WALLOPS                    |
533	>	* rehash         - allows oper to REHASH config      | ('H' flag)
534	>	* die            - allows DIE                        | ('D' flag)
535	>	* restart        - allows RESTART                    |
536	>	* set            - allows SET                        |
537	>	* admin          - gives administrator privileges    | ('A' flag)
538		*/
539	<	flags = global_kill, remote, kline, unkline, xline,
540	<	die, rehash, nick_changes, admin, operwall;
539	>	flags = kill, kill:remote, connect, connect:remote, kline, unkline,
540	>	xline, globops, restart, die, rehash, admin, module;
541		};
542
543		/*
544	<	* connect {}:  controls servers we connect to (OLD C:, N:, H:, L:)
544	>	* service {}: specifies a server which may act as a network service
545	>	*
546	>	* NOTE: it is very important that every server on the network
547	>	*       has the same service{} block.
548	>	*/
549	>	service {
550	>	name = "service.someserver";
551	>	name = "stats.someserver";
552	>	};
553	>
554	>	/*
555	>	* connect {}: define a server to connect to
556		*/
557		connect {
558		/* name: the name of the server */
559		name = "irc.uplink.com";
560
561		/*
562	<	* host: the host or IP to connect to.  If a hostname is used it
563	<	* must match the reverse dns of the server.
562	>	* host: the host or IP address to connect to. If a hostname is used it
563	>	* must match the reverse DNS of the server.
564		*/
565		host = "192.168.0.1";
566
567		/*
568	<	* vhost: the IP to bind to when we connect outward to servers.
568	>	* vhost: the IP address to bind to when making outgoing connections to
569	>	* servers.
570		* serverinfo::vhost and serverinfo::vhost6 will be overridden
571		* by this directive.
572		*/
573		vhost = "192.168.0.2";
574
575		/*
576	<	* passwords: the passwords we send (OLD C:) and accept (OLD N:).
577	<	* The remote server will have these passwords reversed.
576	>	* passwords: the passwords to send (OLD C:) and accept (OLD N:).
577	>	* The remote server will have these passwords swapped.
578		*/
579		send_password = "password";
580		accept_password = "anotherpassword";
#	Line 506 | Line 589 | connect {
589		port = 6666;
590
591		/*
592	<	* hub_mask: the mask of servers that this server may hub.  Multiple
593	<	* entries are permitted
592	>	* hub_mask: the mask of servers that this server may hub. Multiple
593	>	* entries are permitted.
594		*/
595		hub_mask = "*";
596
597		/*
598	<	* leaf_mask: the mask of servers this server may not hub.  Multiple
599	<	* entries are permitted.  Useful for forbidding EU -> US -> EU routes.
598	>	* leaf_mask: the mask of servers this server may not hub. Multiple
599	>	* entries are permitted. Useful for forbidding EU -> US -> EU routes.
600		*/
601		#       leaf_mask = "*.uk";
602
520	–	/* fakename: the servername we pretend to be when we connect */
521	–	#       fakename = "*.arpa";
522	–
603		/* class: the class this server is in */
604		class = "server";
605
606		/*
607	<	* autoconn:    controls whether we autoconnect to this server or not,
608	<	*              dependent on class limits.  By default, this is disabled.
609	<	* compressed:  controls whether traffic is compressed via ziplinks.
610	<	*              By default, this is disabled
611	<	* cryptlink:   enable full encryption for all data passing between our
612	<	*              server and this link and rsa authentication.
613	<	* burst_away:  This will send the /away string that users have set
614	<	*              on the server burst.  Note this can be a lot of data
615	<	*              and slow down your server burst.
616	<	* topicburst:  Send topics to this server during channel burst.  Works
537	<	*              only if the server we are connecting to is capable
538	<	*              of TBURST/TB.
607	>	* ssl_cipher_list:
608	>	*
609	>	* List of ciphers that the server we are connecting to must support.
610	>	* If the server is not capable of using any of the ciphers listed below,
611	>	* the connection will simply be rejected.
612	>	* Can be used to enforce stronger ciphers, even though this option
613	>	* is not necessarily required to establish a SSL/TLS connection.
614	>	*
615	>	* Multiple ciphers are separated by colons. The order of preference
616	>	* is from left to right.
617		*/
618	<	#       flags = autoconn, compressed, cryptlink, burst_away, topicburst;
541	<	};
542	<
543	<	connect {
544	<	name = "encrypted.auth.example";
545	<	host = "some.host.somewhere";
546	<	port = 6667;
547	<
548	<	flags = cryptlink;
618	>	#       ssl_cipher_list = "ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES256-SHA:AES256-SHA";
619
620		/*
621	<	* rsa_public_key_file: the path to the public keyfile of the server.
622	<	* Used instead of passwords.
621	>	* ssl_certificate_fingerprint: enhances security by additionally checking
622	>	* the server's client certificate fingerprint against the specified
623	>	* fingerprint below.
624		*/
625	<	rsa_public_key_file = "etc/remote.server.keyfile";
625	>	#       ssl_certificate_fingerprint = "4C62287BA6776A89CD4F8FF10A62FFB35E79319F51AF6C62C674984974FCCB1D";
626
627		/*
628	<	* cipher preference: set the preferred cipher for this link
629	<	*
630	<	* Available ciphers are:
560	<	*      BF/168 BF/128 CAST/128 IDEA/128 RC5.16/128
561	<	*      RC5.12/128 RC5.8/128 3DES/168 DES/56
562	<	*
563	<	* NOTE:  Some ciphers may not be supported by your OpenSSL.
564	<	*        Check the output from 'configure' for available ciphers.
565	<	*
566	<	* NOTE2: To help you decide what cipher to use, tools/encspeed
567	<	*        will show you approximately how fast each cipher is.
568	<	*        However, blowfish is fast and secure, and is probably
569	<	*        a good default for most situations.
570	<	*
571	<	* NOTE3: Default if none is set is BF/128
572	<	*
573	<	* The cipher *MUST* be the same in both directions.  If you
574	<	* set a cipher preference, your uplink must set the same cipher,
575	<	* else it will not link.
628	>	* autoconn   - controls whether we autoconnect to this server or not,
629	>	*              dependent on class limits. By default, this is disabled.
630	>	* ssl        - Initiates a TLS/SSL connection.
631		*/
632	<	#       cipher_preference = "BF/168";
632	>	#       flags = autoconn, ssl;
633		};
634
635	<	/*
636	<	* NOTE: Don't add an extra 'name=' entry if you use
582	<	* the connect "name"{} feature
583	<	*/
584	<	connect "ipv6.some.server" {
635	>	connect {
636	>	name = "ipv6.some.server";
637		host = "3ffd:dead:beef::1";
638		send_password = "password";
639		accept_password = "password";
#	Line 597 | Line 649 | connect "ipv6.some.server" {
649
650		/*
651		* cluster {}:  servers that share klines/unkline/xline/unxline/resv/unresv/locops
652	<	* automatically (OLD hyb6 SLAVE_SERVERS)
652	>	* automatically
653		*/
654		cluster {
655		/*
656	<	* name: the server to share with, this can take wildcards
656	>	* name: the server to share with; this can take wildcards
657		*
658	<	* NOTE: only local actions will be clustered, meaning if
658	>	* NOTE: only local actions will be clustered, meaning that if
659		*       the server receives a shared kline/unkline/etc, it
660		*       will not be propagated to clustered servers.
661		*
#	Line 614 | Line 666 | cluster {
666		name = "*.arpa";
667
668		/*
669	<	* type: list of what to share, options are as follows:
670	<	*      kline   - share klines
671	<	*      tkline  - share temporary klines
672	<	*      unkline - share unklines
673	<	*      xline   - share xlines
674	<	*      txline  - share temporary xlines
675	<	*      unxline - share unxlines
676	<	*      resv    - share resvs
677	<	*      tresv   - share temporary resvs
678	<	*      unresv  - share unresvs
679	<	*      locops  - share locops
628	<	*      all     - share all of the above (default)
669	>	* type: list of what to share; options are as follows:
670	>	*      dline   - share dlines
671	>	*      undline - share undlines
672	>	*      kline   - share klines
673	>	*      unkline - share unklines
674	>	*      xline   - share xlines
675	>	*      unxline - share unxlines
676	>	*      resv    - share resvs
677	>	*      unresv  - share unresvs
678	>	*      locops  - share locops
679	>	*      all     - share all of the above (default)
680		*/
681		type = kline, unkline, locops, xline, resv;
682		};
683
684		/*
685	<	* shared {}: users that are allowed to remote kline (OLD U:)
685	>	* shared {}: users that are allowed to remote kline
686		*
687	<	* NOTE: This can be effectively used for remote klines.
687	>	* NOTE: This can effectively be used for remote klines.
688		*       Please note that there is no password authentication
689	<	*       for users setting remote klines.  You must also be
689	>	*       for users setting remote klines. You must also be
690		*       /oper'd in order to issue a remote kline.
691		*/
692		shared {
693		/*
694	<	* name: the server the user must be on to set klines.  If this is not
695	<	* specified, the user will be allowed to kline from all servers.
694	>	* name: the server the user must be connected to in order to set klines.
695	>	* If this is not specified, the user will be allowed to kline from all
696	>	* servers.
697		*/
698		name = "irc2.some.server";
699
700		/*
701	<	* user: the user@host mask that is allowed to set klines.  If this is
701	>	* user: the user@host mask that is allowed to set klines. If this is
702		* not specified, all users on the server above will be allowed to set
703		* a remote kline.
704		*/
#	Line 654 | Line 706 | shared {
706
707		/*
708		* type: list of what to share, options are as follows:
709	<	*      kline   - allow oper/server to kline
710	<	*      tkline  - allow temporary klines
711	<	*      unkline - allow oper/server to unkline
712	<	*      xline   - allow oper/server to xline
713	<	*      txline  - allow temporary xlines
714	<	*      unxline - allow oper/server to unxline
715	<	*      resv    - allow oper/server to resv
716	<	*      tresv   - allow temporary resvs
665	<	*      unresv  - allow oper/server to unresv
709	>	*      dline   - allow oper/server to dline
710	>	*      undline - allow oper/server to undline
711	>	*      kline   - allow oper/server to kline
712	>	*      unkline - allow oper/server to unkline
713	>	*      xline   - allow oper/server to xline
714	>	*      unxline - allow oper/server to unxline
715	>	*      resv    - allow oper/server to resv
716	>	*      unresv  - allow oper/server to unresv
717		*      locops  - allow oper/server to locops - only used for servers that cluster
718	<	*      all     - allow oper/server to do all of the above (default)
718	>	*      all     - allow oper/server to do all of the above (default)
719		*/
720		type = kline, unkline, resv;
721		};
722
723		/*
724	<	* kill {}:  users that are not allowed to connect (OLD K:)
724	>	* kill {}:  users that are not allowed to connect
725		* Oper issued klines will be added to the specified kline config
726		*/
727		kill {
#	Line 678 | Line 729 | kill {
729		reason = "Obviously hacked account";
730		};
731
681	–	kill {
682	–	user = "^O[[:alpha:]]?[[:digit:]]+(x\.o|\.xo)$@^[[:alnum:]]{4}\.evilnet.tld$";
683	–
684	–	/*
685	–	* NOTE: You have to set type=regex; when using a regular expression
686	–	* based user entry
687	–	*/
688	–	type = regex;
689	–	};
690	–
732		/*
733	<	* deny {}:  IPs that are not allowed to connect (before DNS/ident lookup)
733	>	* deny {}:  IP addresses that are not allowed to connect
734	>	* (before DNS/ident lookup)
735		* Oper issued dlines will be added to the specified dline config
736		*/
737		deny {
#	Line 698 | Line 740 | deny {
740		};
741
742		/*
743	<	* exempt {}: IPs that are exempt from deny {} and Dlines. (OLD d:)
743	>	* exempt {}:  IP addresses that are exempt from deny {} and Dlines
744		*/
745		exempt {
746		ip = "192.168.0.0/16";
747		};
748
749		/*
750	<	* resv {}:  nicks and channels users may not use/join (OLD Q:)
750	>	* resv {}:  nicks and channels users may not use/join
751		*/
752	<	resv {
753	<	/* reason: the reason for the proceeding resv's */
754	<	reason = "There are no services on this network";
752	>	resv { mask = "clone*"; reason = "Clone bots"; };
753	>	resv { mask = "Global"; reason = "Reserved for services"; };
754	>	resv { mask = "ChanServ"; reason = "Reserved for services"; };
755	>	resv { mask = "NickServ"; reason = "Reserved for services"; };
756	>	resv { mask = "OperServ"; reason = "Reserved for services"; };
757	>	resv { mask = "MemoServ"; reason = "Reserved for services"; };
758	>	resv { mask = "BotServ"; reason = "Reserved for services"; };
759	>	resv { mask = "HelpServ"; reason = "Reserved for services"; };
760	>	resv { mask = "HostServ"; reason = "Reserved for services"; };
761	>	resv { mask = "StatServ"; reason = "Reserved for services"; };
762	>	resv { mask = "#*services*"; reason = "Reserved for services"; };
763
764	<	/* resv: the nicks and channels users may not join/use */
765	<	nick = "nickserv";
766	<	nick = "chanserv";
767	<	channel = "#services";
764	>	resv {
765	>	/*
766	>	* mask: masks starting with a '#' are automatically considered
767	>	* as channel name masks.
768	>	*/
769	>	mask = "#helsinki";
770	>	reason = "Channel is reserved for Finnish inhabitants";
771
772	<	/* resv: wildcard masks are also supported in nicks only */
773	<	reason = "Clone bots";
774	<	nick = "clone*";
772	>	/*
773	>	* exempt: can be either a ISO 3166 alpha-2 two letter country
774	>	* code, or a nick!user@host mask. CIDR is supported. Exempt
775	>	* entries can be stacked.
776	>	*/
777	>	exempt = "FI";
778		};
779
780		/*
781	<	* gecos {}:  The X: replacement, used for banning users based on
726	<	* their "realname".
781	>	* gecos {}:  Used for banning users based on their "realname".
782		*/
783		gecos {
784		name = "*sex*";
#	Line 735 | Line 790 | gecos {
790		reason = "Trojan drone";
791		};
792
738	–	gecos {
739	–	name = "*http*";
740	–	reason = "Spambot";
741	–	};
742	–
743	–	gecos {
744	–	name = "^\[J[0o]hn Do[3e]\]-[0-9]{2,5}$";
745	–
746	–	/*
747	–	* NOTE: You have to set type=regex; when using a regular expression
748	–	* based name entry
749	–	*/
750	–	type = regex;
751	–	};
752	–
793		/*
794		* channel {}:  The channel block contains options pertaining to channels
795		*/
796		channel {
797		/*
798		* disable_fake_channels: this option, if set to 'yes', will
799	<	* disallow clients to create or join channels that have one
799	>	* disallow clients from creating or joining channels that have one
800		* of the following ASCII characters in their name:
801		*
802		*   2 | bold
803		*   3 | mirc color
804		*  15 | plain text
805		*  22 | reverse
806	+	*  29 | italic
807		*  31 | underline
808		* 160 | non-breaking space
809		*/
810		disable_fake_channels = yes;
811
812		/*
813	<	* restrict_channels: reverse channel RESVs logic, only reserved
814	<	* channels are allowed
813	>	* invite_client_count, invite_client_time: how many INVITE commands
814	>	* are permitted per client per invite_client_time.
815		*/
816	<	restrict_channels = no;
816	>	invite_client_count = 10;
817	>	invite_client_time = 5 minutes;
818
819		/*
820	<	* disable_local_channels: prevent users from joining &channels.
820	>	* knock_client_count, knock_client_time: how many KNOCK commands
821	>	* are permitted per client per knock_client_time.
822		*/
823	<	disable_local_channels = no;
823	>	knock_client_count = 1;
824	>	knock_client_time = 5 minutes;
825
826		/*
827	<	* use_invex: Enable/disable channel mode +I, a n!u@h list of masks
828	<	* that can join a +i channel without an invite.
785	<	*/
786	<	use_invex = yes;
787	<
788	<	/*
789	<	* use_except: Enable/disable channel mode +e, a n!u@h list of masks
790	<	* that can join a channel through a ban (+b).
791	<	*/
792	<	use_except = yes;
793	<
794	<	/*
795	<	* use_knock: Allows users to request an invite to a channel that
796	<	* is locked somehow (+ikl).  If the channel is +p or you are banned
797	<	* the knock will not be sent.
798	<	*/
799	<	use_knock = yes;
800	<
801	<	/*
802	<	* knock_delay: The amount of time a user must wait between issuing
803	<	* the knock command.
804	<	*/
805	<	knock_delay = 5 minutes;
806	<
807	<	/*
808	<	* knock_delay_channel: How often a knock to any specific channel
809	<	* is permitted, regardless of the user sending the knock.
827	>	* knock_delay_channel: How often a KNOCK to any specific channel
828	>	* is permitted, regardless of the user sending the KNOCK.
829		*/
830		knock_delay_channel = 1 minute;
831
832		/*
814	–	* burst_topicwho: enable sending of who set topic on topicburst
815	–	* default is yes
816	–	*/
817	–	burst_topicwho = yes;
818	–
819	–	/*
833		* max_chans_per_user: The maximum number of channels a user can
834		* join/be on.
835		*/
836		max_chans_per_user = 25;
837
838	<	/* quiet_on_ban: stop banned people talking in channels. */
839	<	quiet_on_ban = yes;
838	>	/*
839	>	* max_chans_per_oper: The maximum number of channels an oper can
840	>	* join/be on.
841	>	*/
842	>	max_chans_per_oper = 50;
843
844		/* max_bans: maximum number of +b/e/I modes in a channel */
845	<	max_bans = 25;
845	>	max_bans = 100;
846
847		/*
848	<	* how many joins in how many seconds constitute a flood, use 0 to
848	>	* how many joins in how many seconds constitute a flood. Use 0 to
849		* disable. +b opers will be notified (changeable via /set)
850		*/
851		join_flood_count = 16;
852		join_flood_time = 8 seconds;
853
854		/*
855	<	* splitcode: The ircd will now check splitmode every few seconds.
855	>	* The ircd will now check splitmode (whether a server is split from
856	>	* the network) every few seconds; this functionality is known as
857	>	* splitcode and is influenced by the options below.
858		*
859		* Either split users or split servers can activate splitmode, but
860		* both conditions must be met for the ircd to deactivate splitmode.
861	<	*
861	>	*
862		* You may force splitmode to be permanent by /quote set splitmode on
863		*/
864
865		/*
866		* default_split_user_count: when the usercount is lower than this level,
867	<	* consider ourselves split.  This must be set for automatic splitmode.
867	>	* consider ourselves split. This must be set for automatic splitmode.
868		*/
869		default_split_user_count = 0;
870
871		/*
872		* default_split_server_count: when the servercount is lower than this,
873	<	* consider ourselves split.  This must be set for automatic splitmode.
873	>	* consider ourselves split. This must be set for automatic splitmode.
874		*/
875		default_split_server_count = 0;
876
877	<	/* no_create_on_split: disallow users creating channels on split. */
877	>	/* no_create_on_split: do not allow users to create channels on split. */
878		no_create_on_split = yes;
879
880	<	/* no_join_on_split: disallow users joining channels at all on a split. */
880	>	/* no_join_on_split: do not allow users to join channels on a split. */
881		no_join_on_split = no;
882		};
883
884		/*
885		* serverhide {}:  The serverhide block contains the options regarding
886	<	* serverhiding
886	>	* to server hiding
887		*/
888		serverhide {
889		/*
890	+	* disable_remote_commands: disable users issuing commands
891	+	* on remote servers.
892	+	*/
893	+	disable_remote_commands = no;
894	+
895	+	/*
896		* flatten_links: this option will show all servers in /links appear
897	<	* that they are linked to this current server
897	>	* as though they are linked to this current server.
898		*/
899		flatten_links = no;
900
#	Line 882 | Line 906 | serverhide {
906
907		/*
908		* hidden: hide this server from a /links output on servers that
909	<	* support it.  This allows hub servers to be hidden etc.
909	>	* support it. This allows hub servers to be hidden etc.
910		*/
911		hidden = no;
912
913		/*
890	–	* disable_hidden: prevent servers hiding themselves from a
891	–	* /links output.
892	–	*/
893	–	disable_hidden = no;
894	–
895	–	/*
914		* hide_servers: hide remote servernames everywhere and instead use
915		* hidden_name and network_desc.
916		*/
917		hide_servers = no;
918
919		/*
920	+	* hide_services: define this if you want to hide the location of
921	+	* services servers that are specified in the service{} block.
922	+	*/
923	+	hide_services = no;
924	+
925	+	/*
926		* Use this as the servername users see if hide_servers = yes.
927		*/
928		hidden_name = "*.hidden.com";
929
930		/*
931		* hide_server_ips: If this is disabled, opers will be unable to see
932	<	* servers ips and will be shown a masked ip, admins will be shown the
933	<	* real ip.
932	>	* servers' IP addresses and will be shown a masked IP address; admins
933	>	* will be shown the real IP address.
934		*
935	<	* If this is enabled, nobody can see a servers ip. *This is a kludge*,
936	<	* it has the side effect of hiding the ips everywhere, including
937	<	* logfiles.
935	>	* If this is enabled, nobody can see a server's IP address.
936	>	* *This is a kludge*: it has the side effect of hiding the IP addresses
937	>	* everywhere, including logfiles.
938		*
939		* We recommend you leave this disabled, and just take care with who you
940	<	* give admin=yes; to.
940	>	* give administrator privileges to.
941		*/
942		hide_server_ips = no;
943		};
944
945		/*
946		* general {}:  The general block contains many of the options that were once
947	<	* compiled in options in config.h.  The general block is read at start time.
947	>	* compiled in options in config.h
948		*/
949		general {
950	+	/*
951	+	* cycle_on_host_change: sends a fake QUIT/JOIN combination
952	+	* when services change the hostname of a specific client.
953	+	*/
954	+	cycle_on_host_change = yes;
955	+
956	+	/* services_name: servername of nick/channel services */
957	+	services_name = "service.someserver";
958	+
959		/* max_watch: maximum WATCH entries a client can have. */
960	<	max_watch = 60;
960	>	max_watch = 50;
961	>
962	>	/* gline_enable: enable glines (network-wide temporary klines). */
963	>	gline_enable = yes;
964
965		/*
966	<	* gline_min_cidr: the minimum required length of a CIDR bitmask
967	<	* for IPv4 based glines
966	>	* gline_duration: the amount of time a gline will remain on your
967	>	* server before expiring.
968		*/
969	<	gline_min_cidr = 16;
969	>	gline_duration = 1 day;
970
971		/*
972	<	* gline_min_cidr6: the minimum required length of a CIDR bitmask
973	<	* for IPv6 based glines
972	>	* gline_request_duration: how long a pending G-line can be around.
973	>	* 10 minutes should be plenty.
974		*/
975	<	gline_min_cidr6 = 48;
975	>	gline_request_duration = 10 minutes;
976
977		/*
978	<	* Whether to automatically set mode +i on connecting users.
978	>	* gline_min_cidr: the minimum required length of a CIDR bitmask
979	>	* for IPv4 based glines.
980		*/
981	<	invisible_on_connect = yes;
981	>	gline_min_cidr = 16;
982
983		/*
984	<	* If you don't explicitly specify burst_away in your connect blocks, then
985	<	* they will default to the burst_away value below.
984	>	* gline_min_cidr6: the minimum required length of a CIDR bitmask
985	>	* for IPv6 based glines.
986		*/
987	<	burst_away = no;
987	>	gline_min_cidr6 = 48;
988
989		/*
990	<	* Show "actually using host <ip>" on /whois when possible.
990	>	* invisible_on_connect: whether to automatically set mode +i on
991	>	* connecting users.
992		*/
993	<	use_whois_actually = yes;
993	>	invisible_on_connect = yes;
994
995		/*
996	<	* Max time from the nickname change that still causes KILL
997	<	* automatically to switch for the current nick of that user. (seconds)
996	>	* kill_chase_time_limit: KILL chasing is a feature whereby a KILL
997	>	* issued for a user who has recently changed nickname will be applied
998	>	* automatically to the new nick. kill_chase_time_limit is the maximum
999	>	* time following a nickname change that this chasing will apply.
1000		*/
1001	<	kill_chase_time_limit = 90;
1001	>	kill_chase_time_limit = 30 seconds;
1002
1003		/*
1004	<	* If hide_spoof_ips is disabled, opers will be allowed to see the real IP of spoofed
1005	<	* users in /trace etc.  If this is defined they will be shown a masked IP.
1004	>	* hide_spoof_ips: if disabled, opers will be allowed to see the real
1005	>	* IP address of spoofed users in /trace etc. If this is defined they
1006	>	* will be shown a masked IP.
1007		*/
1008		hide_spoof_ips = yes;
1009
1010		/*
1011	<	* Ignore bogus timestamps from other servers.  Yes, this will desync
1012	<	* the network, but it will allow chanops to resync with a valid non TS 0
1011	>	* Ignore bogus timestamps from other servers. Yes, this will desync the
1012	>	* network, but it will allow chanops to resync with a valid non TS 0
1013		*
1014		* This should be enabled network wide, or not at all.
1015		*/
#	Line 980 | Line 1021 | general {
1021		*/
1022		disable_auth = no;
1023
983	–	/* disable_remote_commands: disable users doing commands on remote servers */
984	–	disable_remote_commands = no;
985	–
1024		/*
1025		* tkline_expire_notices: enables or disables temporary kline/xline
1026		* expire notices.
#	Line 991 | Line 1029 | general {
1029
1030		/*
1031		* default_floodcount: the default value of floodcount that is configurable
1032	<	* via /quote set floodcount.  This is the amount of lines a user
1032	>	* via /quote set floodcount. This is the number of lines a user
1033		* may send to any other user/channel in one second.
1034		*/
1035		default_floodcount = 10;
1036
1037		/*
1038	<	* failed_oper_notice: send a notice to all opers on the server when
1038	>	* failed_oper_notice: send a notice to all opers on the server when
1039		* someone tries to OPER and uses the wrong password, host or ident.
1040		*/
1041		failed_oper_notice = yes;
1042
1043		/*
1044	<	* dots_in_ident: the amount of '.' characters permitted in an ident
1044	>	* dots_in_ident: the number of '.' characters permitted in an ident
1045		* reply before the user is rejected.
1046		*/
1047		dots_in_ident = 2;
1048
1049		/*
1050	<	* dot_in_ip6_addr: ircd-hybrid-6.0 and earlier will disallow hosts
1051	<	* without a '.' in them.  This will add one to the end.  Only needed
1052	<	* for older servers.
1053	<	*/
1016	<	dot_in_ip6_addr = no;
1017	<
1018	<	/*
1019	<	* min_nonwildcard: the minimum non wildcard characters in k/d/g lines
1020	<	* placed via the server.  klines hand placed are exempt from limits.
1021	<	* wildcard chars: '.' ':' '*' '?' '@' '!' '#'
1050	>	* min_nonwildcard: the minimum number of non-wildcard characters in
1051	>	* k/d/g lines placed via the server. K-lines hand-placed are exempt from
1052	>	* this limit.
1053	>	* Wildcard chars: '.', ':', '*', '?', '@', '!'
1054		*/
1055		min_nonwildcard = 4;
1056
1057		/*
1058	<	* min_nonwildcard_simple: the minimum non wildcard characters in
1059	<	* gecos bans.  wildcard chars: '*' '?' '#'
1058	>	* min_nonwildcard_simple: the minimum number of non-wildcard characters
1059	>	* in gecos bans. Wildcard chars: '*', '?'
1060		*/
1061		min_nonwildcard_simple = 3;
1062
1063	<	/* max_accept: maximum allowed /accept's for +g usermode */
1064	<	max_accept = 20;
1063	>	/* max_accept: maximum allowed /accept's for +g usermode. */
1064	>	max_accept = 50;
1065
1066	<	/* anti_nick_flood: enable the nickflood control code */
1066	>	/* anti_nick_flood: enable the nickflood control code. */
1067		anti_nick_flood = yes;
1068
1069	<	/* nick flood: the nick changes allowed in the specified period */
1069	>	/* nick flood: the number of nick changes allowed in the specified period */
1070		max_nick_time = 20 seconds;
1071		max_nick_changes = 5;
1072
#	Line 1046 | Line 1078 | general {
1078
1079		/*
1080		* ts delta: the time delta allowed between server clocks before
1081	<	* a warning is given, or before the link is dropped.  all servers
1081	>	* a warning is given, or before the link is dropped. All servers
1082		* should run ntpdate/rdate to keep clocks in sync
1083		*/
1084	<	ts_warn_delta = 30 seconds;
1085	<	ts_max_delta = 5 minutes;
1054	<
1055	<	/*
1056	<	* kline_with_reason: show the user the reason why they are k/d/glined
1057	<	* on exit.  May give away who set k/dline when set via tcm.
1058	<	*/
1059	<	kline_with_reason = yes;
1060	<
1061	<	/*
1062	<	* kline_reason: show this message to users on channel
1063	<	* instead of the oper reason.
1064	<	*/
1065	<	kline_reason = "Connection closed";
1084	>	ts_warn_delta = 10 seconds;
1085	>	ts_max_delta = 2 minutes;
1086
1087		/*
1088	<	* reject_hold_time: wait this amount of time before disconnecting
1089	<	* a rejected client. Use 0 to disable.
1088	>	* warn_no_connect_block: warn opers about servers that try to connect
1089	>	* but for which we don't have a connect {} block. Twits with
1090	>	* misconfigured servers can become really annoying with this enabled.
1091		*/
1092	<	reject_hold_time = 0;
1072	<
1073	<	/*
1074	<	* warn_no_nline: warn opers about servers that try to connect but
1075	<	* we don't have a connect {} block for.  Twits with misconfigured
1076	<	* servers can get really annoying with this enabled.
1077	<	*/
1078	<	warn_no_nline = yes;
1092	>	warn_no_connect_block = yes;
1093
1094		/*
1095		* stats_e_disabled: set this to 'yes' to disable "STATS e" for both
1096	<	* operators and administrators.  Doing so is a good idea in case
1096	>	* operators and administrators. Doing so is a good idea in case
1097		* there are any exempted (exempt{}) server IPs you don't want to
1098		* see leaked.
1099		*/
#	Line 1091 | Line 1105 | general {
1105		/* stats_P_oper_only: make stats P (ports) oper only */
1106		stats_P_oper_only = yes;
1107
1108	+	/* stats_u_oper_only: make stats u (uptime) oper only */
1109	+	stats_u_oper_only = no;
1110	+
1111		/*
1112	<	* stats i oper only: make stats i (auth {}) oper only. set to:
1113	<	*     yes:    show users no auth blocks, made oper only.
1114	<	*     masked: show users first matching auth block
1115	<	*     no:     show users all auth blocks.
1112	>	* stats_i_oper_only: make stats i (auth {}) oper only. Set to:
1113	>	*     yes    - show users no auth blocks, made oper only.
1114	>	*     masked - show users the first matching auth block
1115	>	*     no     - show users all auth blocks.
1116		*/
1117		stats_i_oper_only = yes;
1118
1119		/*
1120	<	* stats_k_oper_only: make stats k/K (klines) oper only.  set to:
1121	<	*     yes:    show users no auth blocks, made oper only
1122	<	*     masked: show users first matching auth block
1123	<	*     no:     show users all auth blocks.
1120	>	* stats_k_oper_only: make stats k/K (klines) oper only. Set to:
1121	>	*     yes    - show users no auth blocks, made oper only
1122	>	*     masked - show users the first matching auth block
1123	>	*     no     - show users all auth blocks.
1124		*/
1125		stats_k_oper_only = yes;
1126
#	Line 1120 | Line 1137 | general {
1137		opers_bypass_callerid = no;
1138
1139		/*
1140	<	* pace_wait_simple: time between use of less intensive commands
1141	<	* (ADMIN, HELP, (L)USERS, VERSION, remote WHOIS)
1140	>	* pace_wait_simple: minimum time required between use of less
1141	>	* intensive commands
1142	>	* (ADMIN, HELP, LUSERS, VERSION, remote WHOIS)
1143		*/
1144		pace_wait_simple = 1 second;
1145
1146		/*
1147	<	* pace_wait: time between more intensive commands
1148	<	* (INFO, LINKS, LIST, MAP, MOTD, STATS, WHO, wildcard WHOIS, WHOWAS)
1147	>	* pace_wait: minimum time required between use of more intensive commands
1148	>	* (AWAY, INFO, LINKS, MAP, MOTD, STATS, WHO, WHOWAS)
1149		*/
1150		pace_wait = 10 seconds;
1151
1152		/*
1153	<	* short_motd: send clients a notice telling them to read the motd
1154	<	* instead of forcing a motd to clients who may simply ignore it.
1153	>	* short_motd: send clients a notice telling them to read the MOTD
1154	>	* instead of forcing an MOTD to clients who may simply ignore it.
1155		*/
1156		short_motd = no;
1157
#	Line 1148 | Line 1166 | general {
1166
1167		/*
1168		* true_no_oper_flood: completely eliminate flood limits for opers
1169	<	* and for clients with can_flood = yes in their auth {} blocks
1169	>	* and for clients with can_flood = yes in their auth {} blocks.
1170		*/
1171		true_no_oper_flood = yes;
1172
1173	<	/* oper_pass_resv: allow opers to over-ride RESVs on nicks/channels */
1173	>	/* oper_pass_resv: allow opers to over-ride RESVs on nicks/channels. */
1174		oper_pass_resv = yes;
1175
1176	<	/*
1159	<	* idletime: the maximum amount of time a user may idle before
1160	<	* they are disconnected
1161	<	*/
1162	<	idletime = 0;
1163	<
1164	<	/* REMOVE ME.  The following line checks you've been reading. */
1176	>	/* REMOVE ME. The following line checks that you have been reading. */
1177		havent_read_conf = 1;
1178
1179		/*
1180	<	* max_targets: the maximum amount of targets in a single
1181	<	* PRIVMSG/NOTICE.  Set to 999 NOT 0 for unlimited.
1180	>	* max_targets: the maximum number of targets in a single
1181	>	* PRIVMSG/NOTICE. Set to 999 NOT 0 for unlimited.
1182		*/
1183		max_targets = 4;
1184
1185		/*
1174	–	* client_flood: maximum amount of data in a clients queue before
1175	–	* they are dropped for flooding.
1176	–	*/
1177	–	client_flood = 2560 bytes;
1178	–
1179	–	/*
1180	–	* message_locale: the default message locale
1181	–	* Use "standard" for the compiled in defaults.
1182	–	* To install the translated messages, go into messages/ in the
1183	–	* source directory and run `make install'.
1184	–	*/
1185	–	message_locale = "standard";
1186	–
1187	–	/*
1186		* usermodes configurable: a list of usermodes for the options below
1187		*
1188		* +b - bots         - See bot and drone flooding notices
1189		* +c - cconn        - Client connection/quit notices
1192	–	* +C - cconn_full   - Client connection/quit notices full
1190		* +D - deaf         - Don't receive channel messages
1191		* +d - debug        - See debugging notices
1192	<	* +f - full         - See I: line full notices
1192	>	* +e - external     - See remote server connection and split notices
1193	>	* +F - farconnect   - Remote client connection/quit notices
1194	>	* +f - full         - See auth{} block full notices
1195		* +G - softcallerid - Server Side Ignore for users not on your channels
1196		* +g - callerid     - Server Side Ignore (for privmsgs etc)
1197	<	* +i - invisible    - Not shown in NAMES or WHO unless you share a
1198	<	*                     a channel
1197	>	* +H - hidden       - Hides operator status to other users
1198	>	* +i - invisible    - Not shown in NAMES or WHO unless you share a channel
1199	>	* +j - rej          - See rejected client notices
1200		* +k - skill        - See server generated KILL messages
1201		* +l - locops       - See LOCOPS messages
1202		* +n - nchange      - See client nick changes
1203	<	* +r - rej          - See rejected client notices
1203	>	* +p - hidechans    - Hides channel list in WHOIS
1204	>	* +q - hideidle     - Hides idle and signon time in WHOIS
1205	>	* +R - nononreg     - Only receive private messages from registered clients
1206		* +s - servnotice   - See general server notices
1207		* +u - unauth       - See unauthorized client notices
1208		* +w - wallop       - See server generated WALLOPS
1207	–	* +x - external     - See remote server connection and split notices
1209		* +y - spy          - See LINKS, STATS, TRACE notices etc.
1209	–	* +z - operwall     - See oper generated WALLOPS
1210		*/
1211
1212		/* oper_only_umodes: usermodes only opers may set */
1213	<	oper_only_umodes = bots, cconn, cconn_full, debug, full, skill,
1214	<	nchange, rej, spy, external, operwall,
1215	<	locops, unauth;
1213	>	oper_only_umodes = bots, cconn, debug, full, hidden, skill,
1214	>	nchange, rej, spy, external,
1215	>	locops, unauth, farconnect;
1216
1217		/* oper_umodes: default usermodes opers get when they /oper */
1218	<	oper_umodes = bots, locops, servnotice, operwall, wallop;
1219	<
1220	<	/*
1221	<	* servlink_path: path to 'servlink' program used by ircd to handle
1222	<	* encrypted/compressed server <-> server links.
1223	<	*
1224	<	* only define if servlink is not in same directory as ircd itself.
1225	<	*/
1226	<	#servlink_path = "/usr/local/ircd/bin/servlink";
1227	<
1228	<	/*
1229	<	* default_cipher_preference: default cipher to use for cryptlink when none is
1230	<	* specified in connect block.
1231	<	*/
1232	<	#default_cipher_preference = "BF/168";
1218	>	oper_umodes = bots, locops, servnotice, wallop;
1219
1220		/*
1221		* use_egd: if your system does not have *random devices yet you
1222	<	* want to use OpenSSL and encrypted links, enable this.  Beware -
1223	<	* EGD is *very* CPU intensive when gathering data for its pool
1222	>	* want to use OpenSSL and encrypted links, enable this. Beware -
1223	>	* EGD is *very* CPU intensive when gathering data for its pool.
1224		*/
1225		#       use_egd = yes;
1226
#	Line 1244 | Line 1230 | general {
1230		*/
1231		#       egdpool_path = "/var/run/egd-pool";
1232
1247	–
1233		/*
1234	<	* compression_level: level of compression for compressed links between
1235	<	* servers.
1236	<	*
1237	<	* values are between: 1 (least compression, fastest)
1253	<	*                and: 9 (most compression, slowest).
1254	<	*/
1255	<	#       compression_level = 6;
1256	<
1257	<	/*
1258	<	* throttle_time: the minimum amount of time between connections from
1259	<	* the same ip.  exempt {} blocks are excluded from this throttling.
1260	<	* Offers protection against flooders who reconnect quickly.
1234	>	* throttle_time: the minimum amount of time required between
1235	>	* connections from the same IP address. exempt {} blocks are excluded
1236	>	* from this throttling.
1237	>	* Offers protection against flooders who reconnect quickly.
1238		* Set to 0 to disable.
1239		*/
1240	<	throttle_time = 10;
1264	<	};
1265	<
1266	<	glines {
1267	<	/* enable: enable glines, network wide temp klines */
1268	<	enable = yes;
1269	<
1270	<	/*
1271	<	* duration: the amount of time a gline will remain on your
1272	<	* server before expiring
1273	<	*/
1274	<	duration = 1 day;
1275	<
1276	<	/*
1277	<	* logging: which types of rules you want to log when triggered
1278	<	* (choose reject or block)
1279	<	*/
1280	<	logging = reject, block;
1281	<
1282	<	/*
1283	<	* NOTE: gline ACLs can cause a desync of glines throughout the
1284	<	* network, meaning some servers may have a gline triggered, and
1285	<	* others may not. Also, you only need insert rules for glines
1286	<	* that you want to block and/or reject. If you want to accept and
1287	<	* propagate the gline, do NOT put a rule for it.
1288	<	*/
1289	<
1290	<	/* user@host for rule to apply to */
1291	<	user = "god@I.still.hate.packets";
1292	<	/* server for rule to apply to */
1293	<	name = "hades.arpa";
1294	<
1295	<	/*
1296	<	* action: action to take when a matching gline is found. options are:
1297	<	*  reject      - do not apply the gline locally
1298	<	*  block       - do not propagate the gline
1299	<	*/
1300	<	action = reject, block;
1301	<
1302	<	user = "god@*";
1303	<	name = "*";
1304	<	action = block;
1240	>	throttle_time = 10 seconds;
1241		};
1242
1243		modules {
1244		/*
1245		* path: other paths to search for modules specified below
1246	<	* and in /modload.
1246	>	* and in "/module load".
1247		*/
1248		path = "/usr/local/ircd/lib/ircd-hybrid/modules";
1249		path = "/usr/local/ircd/lib/ircd-hybrid/modules/autoload";
1250
1251	<	/* module: the name of a module to load on startup/rehash */
1252	<	#module = "some_module.la";
1251	>	/* module: the name of a module to load on startup/rehash. */
1252	>	#       module = "some_module.la";
1253	>	};
1254	>
1255	>	/*
1256	>	* log {}:  contains information about logfiles.
1257	>	*/
1258	>	log {
1259	>	/* Do you want to enable logging to ircd.log? */
1260	>	use_logging = yes;
1261	>
1262	>	file {
1263	>	type = oper;
1264	>	name = "/usr/local/ircd/var/log/oper.log";
1265	>	size = unlimited;
1266	>	};
1267	>
1268	>	file {
1269	>	type = user;
1270	>	name = "/usr/local/ircd/var/log/user.log";
1271	>	size = 50 megabytes;
1272	>	};
1273	>
1274	>	file {
1275	>	type = kill;
1276	>	name = "/usr/local/ircd/var/log/kill.log";
1277	>	size = 50 megabytes;
1278	>	};
1279	>
1280	>	file {
1281	>	type = kline;
1282	>	name = "/usr/local/ircd/var/log/kline.log";
1283	>	size = 50 megabytes;
1284	>	};
1285	>
1286	>	file {
1287	>	type = dline;
1288	>	name = "/usr/local/ircd/var/log/dline.log";
1289	>	size = 50 megabytes;
1290	>	};
1291	>
1292	>	file {
1293	>	type = gline;
1294	>	name = "/usr/local/ircd/var/log/gline.log";
1295	>	size = 50 megabytes;
1296	>	};
1297	>
1298	>	file {
1299	>	type = xline;
1300	>	name = "/usr/local/ircd/var/log/xline.log";
1301	>	size = 50 megabytes;
1302	>	};
1303	>
1304	>	file {
1305	>	type = resv;
1306	>	name = "/usr/local/ircd/var/log/resv.log";
1307	>	size = 50 megabytes;
1308	>	};
1309	>
1310	>	file {
1311	>	type = debug;
1312	>	name = "/usr/local/ircd/var/log/debug.log";
1313	>	size = 50 megabytes;
1314	>	};
1315		};

Diff Legend

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