ViewVC Help

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

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

Comparing:
ircd-hybrid-7.2/etc/example.conf.in (file contents), Revision 951 by michael, Wed Jul 22 10:47:24 2009 UTC vs.
ircd-hybrid/trunk/doc/example.conf (file contents), Revision 1679 by michael, Tue Dec 18 18:02:28 2012 UTC

#	Line 1 | Line 1
1	<	/* doc/example.conf - ircd-hybrid-7 Example configuration file
2	<	* Copyright (C) 2000-2006 Hybrid Development Team
1	>	/* doc/example.conf - ircd-hybrid-8 Example configuration file
2	>	* Copyright (C) 2000-2012 Hybrid Development Team
3		*
4		* Written by ejb, wcampbel, db, leeh and others
5		* Other example configurations can be found in the source dir under
6	<	* etc/.
6	>	* doc/.
7		*
8		* $Id$
9		*/
#	Line 39 | Line 39
39		*/
40
41		/*
42	<	* serverinfo {}:  contains information about the server. (OLD M:)
42	>	* serverinfo {}:  contains information about the server
43		*/
44		serverinfo {
45		/*
46	<	* name: the name of our server.  This cannot be changed at runtime.
46	>	* name: the name of this server.  This cannot be changed at runtime.
47		*/
48		name = "hades.arpa";
49
#	Line 56 | Line 56 | serverinfo {
56		sid = "_CHANGE_ME_";
57
58		/*
59	<	* description: the description of the server.  '[' and ']' may not
60	<	* be used here for compatibility with older servers.
59	>	* description: the description of the server.
60		*/
61	<	description = "hybrid-7 test server";
61	>	description = "ircd-hybrid test server";
62
63		/*
64		* network info: the name and description of the network this server
#	Line 76 | Line 75 | serverinfo {
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.
78	>	* This should be an ipv4 IP only, or "*" for INADDR_ANY.
79		*/
80		#vhost = "192.169.0.1";
81
82		/*
83		* vhost6: the IP to bind to when we connect outward to ipv6 servers.
84	<	* This should be an ipv6 IP only, or "* for INADDR_ANY.
84	>	* This should be an ipv6 IP only, or "*" for INADDR_ANY.
85		*/
86		#vhost6 = "3ffe:80e8:546::2";
87
#	Line 96 | Line 95 | serverinfo {
95		* Example command to store a 2048 bit RSA keypair in
96		* rsa.key, and the public key in rsa.pub:
97		*
98	<	*      openssl genrsa -out rsa.key 2048
98	>	*      openssl genrsa -out rsa.key 2048
99		*      openssl rsa -in rsa.key -pubout -out rsa.pub
100		*      chown <ircd-user>.<ircd.group> rsa.key rsa.pub
101		*      chmod 0600 rsa.key
#	Line 106 | Line 105 | serverinfo {
105
106		/*
107		* ssl_certificate_file: the path to the file containing our
108	<	* ssl certificate
110	<	* for encrypted client connection.
108	>	* ssl certificate for encrypted client connection.
109		*
110		* This assumes your private RSA key is stored in rsa.key. You
111		* MUST have an RSA key in order to generate the certificate
#	Line 124 | Line 122 | serverinfo {
122		*      E-mail: you@domain.com
123		*/
124		#ssl_certificate_file = "/usr/local/ircd/etc/cert.pem";
125	+
126	+	/*
127	+	* ssl_dh_param_file:
128	+	*
129	+	* Path to the PEM encoded Diffie-Hellman parameter file.
130	+	* DH parameters are strictly required when using ciphers
131	+	* with EDH (ephemeral Diffie-Hellman) key exchange.
132	+	*
133	+	* A DH parameter file can be created by running:
134	+	*
135	+	*      openssl dhparam -out dhparam.pem 1024
136	+	*
137	+	* Prime size must be at least 1024 bits. Further information
138	+	* regarding specific OpenSSL dhparam command-line options
139	+	* can be found in the OpenSSL manual.
140	+	*/
141	+	#ssl_dh_param_file = "/usr/local/ircd/etc/dhparam.pem";
142	+
143	+	/*
144	+	* ssl_cipher_list:
145	+	*
146	+	* List of ciphers that are supported by _this_ server. Can be used to
147	+	* enforce specific ciphers for incoming SSL/TLS connections.
148	+	* If a client (which also includes incoming server connections) isn't
149	+	* capable of any cipher listed below, the connection will simply be
150	+	* rejected.
151	+	*
152	+	* A list of supported ciphers can be obtained by running:
153	+	*
154	+	*      openssl ciphers -ssl3 -tls1 -v
155	+	*
156	+	* Multiple ciphers are separated by colons. The order of preference is
157	+	* from left to right.
158	+	*/
159	+	#ssl_cipher_list = "DHE-RSA-AES256-SHA:AES256-SHA";
160	+
161	+	/*
162	+	* ssl_server_method:
163	+	* ssl_client_method:
164	+	*
165	+	* SSL/TLS methods we provide for incoming (server method) and
166	+	* outgoing (client method) SSL/TLS connections.
167	+	* This can be either sslv3 for SSLv3, and/or tlsv1 for TLSv1.
168	+	*/
169	+	#ssl_server_method = tlsv1, sslv3;
170	+	#ssl_client_method = tlsv1;
171		};
172
173		/*
174	<	* admin {}:  contains admin information about the server. (OLD A:)
174	>	* admin {}:  contains admin information about the server
175		*/
176		admin {
177		name = "Smurf target";
#	Line 136 | Line 180 | admin {
180		};
181
182		/*
183	<	* log {}:  contains information about logfiles.
140	<	*/
141	<	log {
142	<	/* Do you want to enable logging to ircd.log? */
143	<	use_logging = yes;
144	<
145	<	/*
146	<	* logfiles: the logfiles to use for user connects, /oper uses,
147	<	* and failed /oper.  These files must exist for logging to be used.
148	<	*/
149	<	fname_userlog = "logs/userlog";
150	<	fname_operlog = "logs/operlog";
151	<	fname_killlog = "logs/kill";
152	<	fname_klinelog = "logs/kline";
153	<	fname_glinelog = "logs/gline";
154	<
155	<	/*
156	<	* log_level: the amount of detail to log in ircd.log.  The
157	<	* higher, the more information is logged.  May be changed
158	<	* once the server is running via /quote SET LOG.  Either:
159	<	* L_CRIT, L_ERROR, L_WARN, L_NOTICE, L_TRACE, L_INFO or L_DEBUG
160	<	*/
161	<	log_level = L_INFO;
162	<	};
163	<
164	<	/*
165	<	* class {}:  contains information about classes for users (OLD Y:)
183	>	* class {}:  contains information about classes for users
184		*/
185		class {
186	<	/* name: the name of the class.  classes are text now */
186	>	/* name: the name of the class */
187		name = "users";
188
189		/*
#	Line 205 | Line 223 | class {
223		number_per_cidr = 16;
224
225		/*
226	<	* sendq: the amount of data allowed in a clients queue before
226	>	* sendq: the amount of data allowed in a clients send queue before
227		* they are dropped.
228		*/
229		sendq = 100 kbytes;
230	+
231	+	/*
232	+	* recvq: maximum amount of data in a clients receive queue before
233	+	* they are dropped for flooding. Defaults to 2560 if the chosen
234	+	* value isn't within the range of 512 to 8000.
235	+	*/
236	+	recvq = 2560 bytes;
237		};
238
239		class {
#	Line 216 | Line 241 | class {
241		ping_time = 90 seconds;
242		number_per_ip = 10;
243		max_number = 100;
244	<	sendq = 100kbytes;
244	>	sendq = 100 kbytes;
245		};
246
247		class {
#	Line 224 | Line 249 | class {
249		ping_time = 90 seconds;
250
251		/*
227	–	* ping_warning: how fast a server must reply to a PING before
228	–	* a warning to opers is generated.
229	–	*/
230	–	ping_warning = 15 seconds;
231	–
232	–	/*
252		* connectfreq: only used in server classes.  Specifies the delay
253		* between autoconnecting to servers.
254		*/
#	Line 243 | Line 262 | class {
262		};
263
264		/*
265	<	* listen {}:  contains information about the ports ircd listens on (OLD P:)
265	>	* listen {}:  contains information about the ports ircd listens on
266		*/
267		listen {
268		/*
#	Line 264 | Line 283 | listen {
283		*
284		* Currently available flags are:
285		*
286	<	*  ssl    - Port is for SSL client connections only
286	>	*  ssl    - Port may only accept TLS/SSL connections
287		*  server - Only server connections are permitted
288	<	*  hidden - Port is hidden from /stats P
288	>	*  hidden - Port is hidden from /stats P, unless you're an admin
289		*/
290		flags = hidden, ssl;
291		host = "192.168.0.1";
#	Line 284 | Line 303 | listen {
303		};
304
305		/*
306	<	* auth {}:  allow users to connect to the ircd (OLD I:)
306	>	* auth {}:  allow users to connect to the ircd
307		*/
308		auth {
309		/*
310	<	* user: the user@host allowed to connect.  Multiple IPv4/IPv6 user
310	>	* user: the user@host allowed to connect. Multiple user
311		* lines are permitted per auth block.
312		*/
313		user = "*@172.16.0.0/12";
#	Line 313 | Line 332 | auth {
332		class = "opers";
333
334		/*
335	<	* need_password: don't allow users who haven't supplied the correct
336	<	*                password to connect using another auth{} block
337	<	*                ('&' prefix on /stats I if disabled)
338	<	* need_ident:    require the user to have identd to connect ('+' prefix on /stats I)
339	<	* spoof_notice:  enable spoofing notification to admins
340	<	* exceed_limit:  allow a user to exceed class limits ('>' prefix on /stats I)
341	<	* kline_exempt:  exempt this user from k/glines ('^' prefix on /stats I)
342	<	* gline_exempt:  exempt this user from glines ('_' prefix on /stats I)
343	<	* resv_exempt:   exempt this user from resvs ('$' prefix on /stats I)
344	<	* no_tilde:      remove ~ from a user with no ident ('-' prefix on /stats I)
345	<	* can_flood:     allow this user to exceed flood limits ('|' prefix on /stats I)
327	<	* can_idle:      exempt this user from idle restrictions ('<' prefix on /stats I)
335	>	* need_password - don't allow users who haven't supplied the correct
336	>	*                 password to connect using another auth{} block
337	>	*                 ('&' prefix on /stats I if disabled)
338	>	* need_ident    - require the user to have identd to connect ('+' prefix on /stats I)
339	>	* spoof_notice  - enable spoofing notification to admins
340	>	* exceed_limit  - allow a user to exceed class limits ('>' prefix on /stats I)
341	>	* kline_exempt  - exempt this user from k/glines ('^' prefix on /stats I)
342	>	* gline_exempt  - exempt this user from glines ('_' prefix on /stats I)
343	>	* resv_exempt   - exempt this user from resvs ('$' prefix on /stats I)
344	>	* no_tilde      - remove ~ from a user with no ident ('-' prefix on /stats I)
345	>	* can_flood     - allow this user to exceed flood limits ('|' prefix on /stats I)
346		*/
347		flags = need_password, spoof_notice, exceed_limit, kline_exempt,
348	<	gline_exempt, resv_exempt, no_tilde, can_flood, can_idle;
348	>	gline_exempt, resv_exempt, no_tilde, can_flood;
349		};
350
351		auth {
#	Line 352 | Line 370 | auth {
370		};
371
372		/*
373	<	* operator {}:  defines ircd operators. (OLD O:)
373	>	* operator {}:  defines ircd operators
374		*
375		* ircd-hybrid no longer supports local operators, privileges are
376		* controlled via flags.
377		*/
378		operator {
379		/* name: the name of the oper */
380	<	/* NOTE: operator "opername"{} is also supported */
363	<	name = "god";
380	>	name = "sheep";
381
382		/*
383	<	* user: the user@host required for this operator.  CIDR is not
384	<	* supported.  Multiple user="" lines are supported.
383	>	* user: the user@host required for this operator. Multiple
384	>	* user="" lines are supported.
385		*/
386	<	user = "*god@*";
387	<	user = "*@127.0.0.1";
386	>	user = "*sheep@192.168.0.0/16";
387	>	user = "*@127.0.0.0/8";
388
389		/*
390		* password: the password required to oper.  By default this will
391	<	* need to be encrypted using 'mkpasswd'.  MD5 is supported.
391	>	* need to be encrypted by using the provided mkpasswd tool.
392	>	* Several password hash algorithms are available depending
393	>	* on your system's crypt() implementation. For example, a modern
394	>	* glibc already has support for SHA-256/512, and MD5 encryption
395	>	* algorithms.
396		*/
397	<	password = "etcnjl8juSU1E";
397	>	password = "$5$x5zof8qe.Yc7/bPp$5zIg1Le2Lsgd4CvOjaD20pr5PmcfD7ha/9b2.TaUyG4";
398
399		/*
400		* encrypted: controls whether the oper password above has been
401	<	* encrypted.  (OLD CRYPT_OPER_PASSWORD now optional per operator)
401	>	* encrypted.
402		*/
403		encrypted = yes;
404
#	Line 401 | Line 422 | operator {
422		* +C - cconn_full   - Client connection/quit notices full
423		* +D - deaf         - Don't receive channel messages
424		* +d - debug        - See debugging notices
425	<	* +f - full         - See I: line full notices
425	>	* +f - full         - See auth{} block full notices
426		* +G - softcallerid - Server Side Ignore for users not on your channels
427		* +g - callerid     - Server Side Ignore (for privmsgs etc)
428	+	* +H - hidden       - Hides operator status to other users
429		* +i - invisible    - Not shown in NAMES or WHO unless you share a
430		*                     a channel
431	+	* +j - rej          - See rejected client notices
432		* +k - skill        - See server generated KILL messages
433		* +l - locops       - See LOCOPS messages
434		* +n - nchange      - See client nick changes
412	–	* +r - rej          - See rejected client notices
435		* +s - servnotice   - See general server notices
436		* +u - unauth       - See unauthorized client notices
437		* +w - wallop       - See server generated WALLOPS
#	Line 421 | Line 443 | operator {
443
444		/*
445		* privileges: controls the activities and commands an oper is
446	<	* allowed to do on the server.  All options default to no.
446	>	* allowed to do on the server. All options default to no.
447		* Available options:
448		*
449	<	* global_kill:  allows remote users to be /KILL'd (OLD 'O' flag)
450	<	* remote:       allows remote SQUIT and CONNECT   (OLD 'R' flag)
451	<	* remoteban:    allows remote KLINE/UNKLINE
452	<	* kline:        allows KILL, KLINE and DLINE      (OLD 'K' flag)
453	<	* unkline:      allows UNKLINE and UNDLINE        (OLD 'U' flag)
454	<	* gline:        allows GLINE                      (OLD 'G' flag)
455	<	* xline:        allows XLINE                      (OLD 'X' flag)
456	<	* operwall:     allows OPERWALL
457	<	* nick_changes: allows oper to see nickchanges    (OLD 'N' flag)
458	<	*               via usermode +n
459	<	* rehash:       allows oper to REHASH config      (OLD 'H' flag)
460	<	* die:          allows DIE and RESTART            (OLD 'D' flag)
461	<	* admin:        gives admin privileges.  admins
462	<	*               may (un)load modules and see the
463	<	*               real IPs of servers.
464	<	* hidden_admin: same as 'admin', but noone can recognize you as
465	<	*               being an admin
466	<	* hidden_oper:  not shown in /stats p (except for other operators)
467	<	*/
446	<	/* You can either use
447	<	* die = yes;
448	<	* rehash = yes;
449	<	*
450	<	* or in a flags statement i.e.
451	<	* flags = die, rehash;
452	<	*
453	<	* You can also negate a flag with ~ i.e.
454	<	* flags = ~remote;
455	<	*
449	>	* module       - allows MODULE
450	>	* global_kill  - allows remote users to be /KILL'd
451	>	* remote       - allows remote SQUIT and CONNECT
452	>	* remoteban    - allows remote KLINE/UNKLINE
453	>	* dline        - allows DLINE
454	>	* undline      - allows UNDLINE
455	>	* kline        - allows KILL and KLINE
456	>	* unkline      - allows UNKLINE
457	>	* gline        - allows GLINE
458	>	* xline        - allows XLINE
459	>	* globops      - allows GLOBOPS
460	>	* operwall     - allows OPERWALL
461	>	* nick_changes - allows oper to see nickchanges via usermode +n
462	>	* rehash       - allows oper to REHASH config
463	>	* die          - allows DIE
464	>	* restart      - allows RESTART
465	>	* set          - allows SET
466	>	* admin        - gives admin privileges. admins for example,
467	>	*                may see the real IP addresses of servers.
468		*/
469	<	flags = global_kill, remote, kline, unkline, xline,
470	<	die, rehash, nick_changes, admin, operwall;
469	>	flags = global_kill, remote, kline, unkline, xline, globops, restart,
470	>	die, rehash, nick_changes, admin, operwall, module;
471	>	};
472	>
473	>	/*
474	>	* service {}: specifies what server may act as a network service
475	>	*
476	>	* NOTE: it is absolutely important that every single server on the network
477	>	*       has the same service{} block.
478	>	*/
479	>	service {
480	>	name = "service.someserver";
481	>	name = "stats.someserver";
482		};
483
484		/*
485	<	* connect {}:  controls servers we connect to (OLD C:, N:, H:, L:)
485	>	* connect {}:  controls servers we connect to
486		*/
487		connect {
488		/* name: the name of the server */
#	Line 487 | Line 510 | connect {
510
511		/*
512		* encrypted: controls whether the accept_password above has been
513	<	* encrypted.  (OLD CRYPT_LINK_PASSWORD now optional per connect)
513	>	* encrypted.
514		*/
515		encrypted = no;
516
#	Line 506 | Line 529 | connect {
529		*/
530		#       leaf_mask = "*.uk";
531
509	–	/* fakename: the servername we pretend to be when we connect */
510	–	#       fakename = "*.arpa";
511	–
532		/* class: the class this server is in */
533		class = "server";
534
535		/*
536	<	* autoconn:    controls whether we autoconnect to this server or not,
537	<	*              dependent on class limits.  By default, this is disabled.
538	<	* compressed:  controls whether traffic is compressed via ziplinks.
539	<	*              By default, this is disabled
540	<	* cryptlink:   enable full encryption for all data passing between our
541	<	*              server and this link and rsa authentication.
542	<	* burst_away:  This will send the /away string that users have set
543	<	*              on the server burst.  Note this can be a lot of data
544	<	*              and slow down your server burst.
545	<	* topicburst:  Send topics to this server during channel burst.  Works
526	<	*              only if the server we are connecting to is capable
527	<	*              of TBURST/TB.
528	<	*/
529	<	#       flags = autoconn, compressed, cryptlink, burst_away, topicburst;
530	<	};
531	<
532	<	connect {
533	<	name = "encrypted.auth.example";
534	<	host = "some.host.somewhere";
535	<	port = 6667;
536	<
537	<	flags = cryptlink;
538	<
539	<	/*
540	<	* rsa_public_key_file: the path to the public keyfile of the server.
541	<	* Used instead of passwords.
536	>	* ssl_cipher_list:
537	>	*
538	>	* List of ciphers that the server we are connecting to must support.
539	>	* If the server isn't capable of any cipher listed below, the
540	>	* connection will simply be rejected.
541	>	* Can be used to enforce stronger ciphers, even though this option
542	>	* is not necessarily required to establish a SSL/TLS connection.
543	>	*
544	>	* Multiple ciphers are separated by colons. The order of preference
545	>	* is from left to right.
546		*/
547	<	rsa_public_key_file = "etc/remote.server.keyfile";
547	>	#ssl_cipher_list = "DHE-RSA-AES256-SHA:AES256-SHA";
548
549		/*
550	<	* cipher preference: set the preferred cipher for this link
551	<	*
552	<	* Available ciphers are:
549	<	*      BF/168 BF/128 CAST/128 IDEA/128 RC5.16/128
550	<	*      RC5.12/128 RC5.8/128 3DES/168 DES/56
551	<	*
552	<	* NOTE:  Some ciphers may not be supported by your OpenSSL.
553	<	*        Check the output from 'configure' for available ciphers.
554	<	*
555	<	* NOTE2: To help you decide what cipher to use, tools/encspeed
556	<	*        will show you approximately how fast each cipher is.
557	<	*        However, blowfish is fast and secure, and is probably
558	<	*        a good default for most situations.
559	<	*
560	<	* NOTE3: Default if none is set is BF/128
561	<	*
562	<	* The cipher *MUST* be the same in both directions.  If you
563	<	* set a cipher preference, your uplink must set the same cipher,
564	<	* else it will not link.
550	>	* autoconn   - controls whether we autoconnect to this server or not,
551	>	*              dependent on class limits. By default, this is disabled.
552	>	* ssl        - Initiates a TLS/SSL connection.
553		*/
554	<	#       cipher_preference = "BF/168";
554	>	#       flags = autoconn, ssl;
555		};
556
557	<	/*
558	<	* NOTE: Don't add an extra 'name=' entry if you use
571	<	* the connect "name"{} feature
572	<	*/
573	<	connect "ipv6.some.server" {
557	>	connect {
558	>	name = "ipv6.some.server";
559		host = "3ffd:dead:beef::1";
560		send_password = "password";
561		accept_password = "password";
#	Line 586 | Line 571 | connect "ipv6.some.server" {
571
572		/*
573		* cluster {}:  servers that share klines/unkline/xline/unxline/resv/unresv/locops
574	<	* automatically (OLD hyb6 SLAVE_SERVERS)
574	>	* automatically
575		*/
576		cluster {
577		/*
#	Line 604 | Line 589 | cluster {
589
590		/*
591		* type: list of what to share, options are as follows:
592	<	*      kline   - share klines
593	<	*      tkline  - share temporary klines
594	<	*      unkline - share unklines
595	<	*      xline   - share xlines
596	<	*      txline  - share temporary xlines
597	<	*      unxline - share unxlines
598	<	*      resv    - share resvs
599	<	*      tresv   - share temporary resvs
600	<	*      unresv  - share unresvs
601	<	*      locops  - share locops
617	<	*      all     - share all of the above (default)
592	>	*      dline   - share dlines
593	>	*      undline - share undlines
594	>	*      kline   - share klines
595	>	*      unkline - share unklines
596	>	*      xline   - share xlines
597	>	*      unxline - share unxlines
598	>	*      resv    - share resvs
599	>	*      unresv  - share unresvs
600	>	*      locops  - share locops
601	>	*      all     - share all of the above (default)
602		*/
603		type = kline, unkline, locops, xline, resv;
604		};
605
606		/*
607	<	* shared {}: users that are allowed to remote kline (OLD U:)
607	>	* shared {}: users that are allowed to remote kline
608		*
609		* NOTE: This can be effectively used for remote klines.
610		*       Please note that there is no password authentication
#	Line 643 | Line 627 | shared {
627
628		/*
629		* type: list of what to share, options are as follows:
630	<	*      kline   - allow oper/server to kline
631	<	*      tkline  - allow temporary klines
632	<	*      unkline - allow oper/server to unkline
633	<	*      xline   - allow oper/server to xline
634	<	*      txline  - allow temporary xlines
635	<	*      unxline - allow oper/server to unxline
636	<	*      resv    - allow oper/server to resv
637	<	*      tresv   - allow temporary resvs
654	<	*      unresv  - allow oper/server to unresv
630	>	*      dline   - allow oper/server to dline
631	>	*      undline - allow oper/server to undline
632	>	*      kline   - allow oper/server to kline
633	>	*      unkline - allow oper/server to unkline
634	>	*      xline   - allow oper/server to xline
635	>	*      unxline - allow oper/server to unxline
636	>	*      resv    - allow oper/server to resv
637	>	*      unresv  - allow oper/server to unresv
638		*      locops  - allow oper/server to locops - only used for servers that cluster
639	<	*      all     - allow oper/server to do all of the above (default)
639	>	*      all     - allow oper/server to do all of the above (default)
640		*/
641		type = kline, unkline, resv;
642		};
643
644		/*
645	<	* kill {}:  users that are not allowed to connect (OLD K:)
645	>	* kill {}:  users that are not allowed to connect
646		* Oper issued klines will be added to the specified kline config
647		*/
648		kill {
#	Line 687 | Line 670 | deny {
670		};
671
672		/*
673	<	* exempt {}: IPs that are exempt from deny {} and Dlines. (OLD d:)
673	>	* exempt {}: IPs that are exempt from deny {} and Dlines
674		*/
675		exempt {
676		ip = "192.168.0.0/16";
677		};
678
679		/*
680	<	* resv {}:  nicks and channels users may not use/join (OLD Q:)
680	>	* resv {}:  nicks and channels users may not use/join
681		*/
682		resv {
683		/* reason: the reason for the proceeding resv's */
684	<	reason = "There are no services on this network";
684	>	reason = "Reserved for services";
685
686		/* resv: the nicks and channels users may not join/use */
687	<	nick = "nickserv";
688	<	nick = "chanserv";
687	>	nick = "Global";
688	>	nick = "DevNull";
689	>	nick = "BotServ";
690	>	nick = "Services";
691	>	nick = "StatServ";
692	>	nick = "HelpServ";
693	>	nick = "HostServ";
694	>	nick = "NickServ";
695	>	nick = "ChanServ";
696	>	nick = "MemoServ";
697	>	nick = "OperServ";
698		channel = "#services";
699
700		/* resv: wildcard masks are also supported in nicks only */
#	Line 725 | Line 717 | gecos {
717		};
718
719		gecos {
728	–	name = "*http*";
729	–	reason = "Spambot";
730	–	};
731	–
732	–	gecos {
720		name = "^\[J[0o]hn Do[3e]\]-[0-9]{2,5}$";
721
722		/*
#	Line 752 | Line 739 | channel {
739		*   3 | mirc color
740		*  15 | plain text
741		*  22 | reverse
742	+	*  29 | italic
743		*  31 | underline
744		* 160 | non-breaking space
745		*/
#	Line 764 | Line 752 | channel {
752		restrict_channels = no;
753
754		/*
767	–	* disable_local_channels: prevent users from joining &channels.
768	–	*/
769	–	disable_local_channels = no;
770	–
771	–	/*
772	–	* use_invex: Enable/disable channel mode +I, a n!u@h list of masks
773	–	* that can join a +i channel without an invite.
774	–	*/
775	–	use_invex = yes;
776	–
777	–	/*
778	–	* use_except: Enable/disable channel mode +e, a n!u@h list of masks
779	–	* that can join a channel through a ban (+b).
780	–	*/
781	–	use_except = yes;
782	–
783	–	/*
784	–	* use_knock: Allows users to request an invite to a channel that
785	–	* is locked somehow (+ikl).  If the channel is +p or you are banned
786	–	* the knock will not be sent.
787	–	*/
788	–	use_knock = yes;
789	–
790	–	/*
755		* knock_delay: The amount of time a user must wait between issuing
756		* the knock command.
757		*/
#	Line 800 | Line 764 | channel {
764		knock_delay_channel = 1 minute;
765
766		/*
767	<	* burst_topicwho: enable sending of who set topic on topicburst
768	<	* default is yes
767	>	* max_chans_per_user: The maximum number of channels a user can
768	>	* join/be on.
769		*/
770	<	burst_topicwho = yes;
770	>	max_chans_per_user = 25;
771
772		/*
773	<	* max_chans_per_user: The maximum number of channels a user can
773	>	* max_chans_per_oper: The maximum number of channels an oper can
774		* join/be on.
775		*/
776	<	max_chans_per_user = 25;
776	>	max_chans_per_oper = 50;
777
778		/* quiet_on_ban: stop banned people talking in channels. */
779		quiet_on_ban = yes;
780
781		/* max_bans: maximum number of +b/e/I modes in a channel */
782	<	max_bans = 25;
782	>	max_bans = 100;
783
784		/*
785		* how many joins in how many seconds constitute a flood, use 0 to
#	Line 845 | Line 809 | channel {
809		*/
810		default_split_server_count = 0;
811
812	<	/* split no create: disallow users creating channels on split. */
812	>	/* no_create_on_split: disallow users creating channels on split. */
813		no_create_on_split = yes;
814
815	<	/* split: no join: disallow users joining channels at all on a split */
815	>	/* no_join_on_split: disallow users joining channels at all on a split. */
816		no_join_on_split = no;
817		};
818
#	Line 876 | Line 840 | serverhide {
840		hidden = no;
841
842		/*
879	–	* disable_hidden: prevent servers hiding themselves from a
880	–	* /links output.
881	–	*/
882	–	disable_hidden = no;
883	–
884	–	/*
843		* hide_servers: hide remote servernames everywhere and instead use
844		* hidden_name and network_desc.
845		*/
#	Line 912 | Line 870 | serverhide {
870		* compiled in options in config.h.  The general block is read at start time.
871		*/
872		general {
873	+	/* services_name: servername of nick/channel services */
874	+	services_name = "service.someserver";
875	+
876		/* max_watch: maximum WATCH entries a client can have. */
877	<	max_watch = 64;
877	>	max_watch = 60;
878	>
879	>	/* gline_enable: enable glines, network wide temp klines */
880	>	gline_enable = yes;
881	>
882	>	/*
883	>	* gline_duration: the amount of time a gline will remain on your
884	>	* server before expiring
885	>	*/
886	>	gline_duration = 1 day;
887	>
888	>	/*
889	>	* gline_request_duration:  how long a pending G-line can be around.
890	>	* 10 minutes should be plenty
891	>	*/
892	>	gline_request_duration = 10 minutes;
893
894		/*
895		* gline_min_cidr: the minimum required length of a CIDR bitmask
#	Line 933 | Line 909 | general {
909		invisible_on_connect = yes;
910
911		/*
936	–	* If you don't explicitly specify burst_away in your connect blocks, then
937	–	* they will default to the burst_away value below.
938	–	*/
939	–	burst_away = no;
940	–
941	–	/*
942	–	* Show "actually using host <ip>" on /whois when possible.
943	–	*/
944	–	use_whois_actually = yes;
945	–
946	–	/*
912		* Max time from the nickname change that still causes KILL
913	<	* automatically to switch for the current nick of that user. (seconds)
913	>	* automatically to switch for the current nick of that user.
914		*/
915	<	kill_chase_time_limit = 90;
915	>	kill_chase_time_limit = 90 seconds;
916
917		/*
918	<	* If hide_spoof_ips is disabled, opers will be allowed to see the real IP of spoofed
919	<	* users in /trace etc.  If this is defined they will be shown a masked IP.
918	>	* If hide_spoof_ips is disabled, opers will be allowed to see the real
919	>	* IP of spoofed users in /trace etc. If this is defined they will be
920	>	* shown a masked IP.
921		*/
922		hide_spoof_ips = yes;
923
#	Line 998 | Line 964 | general {
964		dots_in_ident = 2;
965
966		/*
1001	–	* dot_in_ip6_addr: ircd-hybrid-6.0 and earlier will disallow hosts
1002	–	* without a '.' in them.  This will add one to the end.  Only needed
1003	–	* for older servers.
1004	–	*/
1005	–	dot_in_ip6_addr = no;
1006	–
1007	–	/*
967		* min_nonwildcard: the minimum non wildcard characters in k/d/g lines
968		* placed via the server.  klines hand placed are exempt from limits.
969		* wildcard chars: '.' ':' '*' '?' '@' '!' '#'
#	Line 1042 | Line 1001 | general {
1001		ts_max_delta = 5 minutes;
1002
1003		/*
1045	–	* kline_with_reason: show the user the reason why they are k/d/glined
1046	–	* on exit.  May give away who set k/dline when set via tcm.
1047	–	*/
1048	–	kline_with_reason = yes;
1049	–
1050	–	/*
1051	–	* kline_reason: show this message to users on channel
1052	–	* instead of the oper reason.
1053	–	*/
1054	–	kline_reason = "Connection closed";
1055	–
1056	–	/*
1057	–	* reject_hold_time: wait this amount of time before disconnecting
1058	–	* a rejected client. Use 0 to disable.
1059	–	*/
1060	–	reject_hold_time = 0;
1061	–
1062	–	/*
1004		* warn_no_nline: warn opers about servers that try to connect but
1005		* we don't have a connect {} block for.  Twits with misconfigured
1006		* servers can get really annoying with this enabled.
#	Line 1116 | Line 1057 | general {
1057
1058		/*
1059		* pace_wait: time between more intensive commands
1060	<	* (INFO, LINKS, LIST, MAP, MOTD, STATS, WHO, wildcard WHOIS, WHOWAS)
1060	>	* (AWAY, INFO, LINKS, MAP, MOTD, STATS, WHO, wildcard WHOIS, WHOWAS)
1061		*/
1062		pace_wait = 10 seconds;
1063
#	Line 1144 | Line 1085 | general {
1085		/* oper_pass_resv: allow opers to over-ride RESVs on nicks/channels */
1086		oper_pass_resv = yes;
1087
1147	–	/*
1148	–	* idletime: the maximum amount of time a user may idle before
1149	–	* they are disconnected
1150	–	*/
1151	–	idletime = 0;
1152	–
1088		/* REMOVE ME.  The following line checks you've been reading. */
1089		havent_read_conf = 1;
1090
#	Line 1160 | Line 1095 | general {
1095		max_targets = 4;
1096
1097		/*
1163	–	* client_flood: maximum amount of data in a clients queue before
1164	–	* they are dropped for flooding.
1165	–	*/
1166	–	client_flood = 2560 bytes;
1167	–
1168	–	/*
1098		* message_locale: the default message locale
1099		* Use "standard" for the compiled in defaults.
1100		* To install the translated messages, go into messages/ in the
#	Line 1178 | Line 1107 | general {
1107		*
1108		* +b - bots         - See bot and drone flooding notices
1109		* +c - cconn        - Client connection/quit notices
1110	<	* +C - cconn        - Client connection/quit notices full
1110	>	* +C - cconn_full   - Client connection/quit notices full
1111		* +D - deaf         - Don't receive channel messages
1112		* +d - debug        - See debugging notices
1113	<	* +f - full         - See I: line full notices
1113	>	* +f - full         - See auth{} block full notices
1114		* +G - softcallerid - Server Side Ignore for users not on your channels
1115		* +g - callerid     - Server Side Ignore (for privmsgs etc)
1116	+	* +H - hidden       - Hides operator status to other users
1117		* +i - invisible    - Not shown in NAMES or WHO unless you share a
1118		*                     a channel
1119	+	* +j - rej          - See rejected client notices
1120		* +k - skill        - See server generated KILL messages
1121		* +l - locops       - See LOCOPS messages
1122		* +n - nchange      - See client nick changes
1192	–	* +r - rej          - See rejected client notices
1123		* +s - servnotice   - See general server notices
1124		* +u - unauth       - See unauthorized client notices
1125		* +w - wallop       - See server generated WALLOPS
#	Line 1199 | Line 1129 | general {
1129		*/
1130
1131		/* oper_only_umodes: usermodes only opers may set */
1132	<	oper_only_umodes = bots, cconn, cconn_full, debug, full, skill,
1132	>	oper_only_umodes = bots, cconn, cconn_full, debug, full, hidden, skill,
1133		nchange, rej, spy, external, operwall,
1134		locops, unauth;
1135
#	Line 1207 | Line 1137 | general {
1137		oper_umodes = bots, locops, servnotice, operwall, wallop;
1138
1139		/*
1210	–	* servlink_path: path to 'servlink' program used by ircd to handle
1211	–	* encrypted/compressed server <-> server links.
1212	–	*
1213	–	* only define if servlink is not in same directory as ircd itself.
1214	–	*/
1215	–	#servlink_path = "/usr/local/ircd/bin/servlink";
1216	–
1217	–	/*
1218	–	* default_cipher_preference: default cipher to use for cryptlink when none is
1219	–	* specified in connect block.
1220	–	*/
1221	–	#default_cipher_preference = "BF/168";
1222	–
1223	–	/*
1140		* use_egd: if your system does not have *random devices yet you
1141		* want to use OpenSSL and encrypted links, enable this.  Beware -
1142		* EGD is *very* CPU intensive when gathering data for its pool
#	Line 1233 | Line 1149 | general {
1149		*/
1150		#       egdpool_path = "/var/run/egd-pool";
1151
1236	–
1237	–	/*
1238	–	* compression_level: level of compression for compressed links between
1239	–	* servers.
1240	–	*
1241	–	* values are between: 1 (least compression, fastest)
1242	–	*                and: 9 (most compression, slowest).
1243	–	*/
1244	–	#       compression_level = 6;
1245	–
1152		/*
1153		* throttle_time: the minimum amount of time between connections from
1154		* the same ip.  exempt {} blocks are excluded from this throttling.
#	Line 1252 | Line 1158 | general {
1158		throttle_time = 10;
1159		};
1160
1255	–	glines {
1256	–	/* enable: enable glines, network wide temp klines */
1257	–	enable = yes;
1258	–
1259	–	/*
1260	–	* duration: the amount of time a gline will remain on your
1261	–	* server before expiring
1262	–	*/
1263	–	duration = 1 day;
1264	–
1265	–	/*
1266	–	* logging: which types of rules you want to log when triggered
1267	–	* (choose reject or block)
1268	–	*/
1269	–	logging = reject, block;
1270	–
1271	–	/*
1272	–	* NOTE: gline ACLs can cause a desync of glines throughout the
1273	–	* network, meaning some servers may have a gline triggered, and
1274	–	* others may not. Also, you only need insert rules for glines
1275	–	* that you want to block and/or reject. If you want to accept and
1276	–	* propagate the gline, do NOT put a rule for it.
1277	–	*/
1278	–
1279	–	/* user@host for rule to apply to */
1280	–	user = "god@I.still.hate.packets";
1281	–	/* server for rule to apply to */
1282	–	name = "hades.arpa";
1283	–
1284	–	/*
1285	–	* action: action to take when a matching gline is found. options are:
1286	–	*  reject      - do not apply the gline locally
1287	–	*  block       - do not propagate the gline
1288	–	*/
1289	–	action = reject, block;
1290	–
1291	–	user = "god@*";
1292	–	name = "*";
1293	–	action = block;
1294	–	};
1295	–
1161		modules {
1162		/*
1163		* path: other paths to search for modules specified below
1164	<	* and in /modload.
1164	>	* and in "/module load".
1165		*/
1166	<	path = "@LIBDIR@/modules";
1167	<	path = "@LIBDIR@/modules/autoload";
1166	>	path = "/usr/local/ircd/lib/ircd-hybrid/modules";
1167	>	path = "/usr/local/ircd/lib/ircd-hybrid/modules/autoload";
1168
1169		/* module: the name of a module to load on startup/rehash */
1170	<	#module = "some_module.so";
1170	>	#module = "some_module.la";
1171	>	};
1172	>
1173	>	/*
1174	>	* log {}:  contains information about logfiles.
1175	>	*/
1176	>	log {
1177	>	/* Do you want to enable logging to ircd.log? */
1178	>	use_logging = yes;
1179	>
1180	>	file {
1181	>	type = oper;
1182	>	name = "/home/ircd/var/log/oper.log";
1183	>	size = unlimited;
1184	>	};
1185	>
1186	>	file {
1187	>	type = user;
1188	>	name = "/home/ircd/var/log/user.log";
1189	>	size = 50 megabytes;
1190	>	};
1191	>
1192	>	file {
1193	>	type = kill;
1194	>	name = "/home/ircd/var/log/kill.log";
1195	>	size = 50 megabytes;
1196	>	};
1197	>
1198	>	file {
1199	>	type = kline;
1200	>	name = "/home/ircd/var/log/kline.log";
1201	>	size = 50 megabytes;
1202	>	};
1203	>
1204	>	file {
1205	>	type = dline;
1206	>	name = "/home/ircd/var/log/dline.log";
1207	>	size = 50 megabytes;
1208	>	};
1209	>
1210	>	file {
1211	>	type = gline;
1212	>	name = "/home/ircd/var/log/gline.log";
1213	>	size = 50 megabytes;
1214	>	};
1215	>
1216	>	file {
1217	>	type = debug;
1218	>	name = "/home/ircd/var/log/debug.log";
1219	>	size = 50 megabytes;
1220	>	};
1221		};

Comparing:
ircd-hybrid-7.2/etc/example.conf.in (property svn:keywords), Revision 951 by michael, Wed Jul 22 10:47:24 2009 UTC vs.
ircd-hybrid/trunk/doc/example.conf (property svn:keywords), Revision 1679 by michael, Tue Dec 18 18:02:28 2012 UTC

#	Line 1 | Line 1
1	<	"Author Date Id Revision"
1	>	Id Revision

Diff Legend

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