ViewVC Help

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

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

Comparing:
ircd-hybrid-8/etc/example.conf (file contents), Revision 1306 by michael, Sat Mar 24 07:43:04 2012 UTC vs.
ircd-hybrid/trunk/doc/reference.conf (file contents), Revision 2210 by michael, Wed Jun 5 21:15:55 2013 UTC

#	Line 1 | Line 1
1	<	/* doc/example.conf - ircd-hybrid-7 Example configuration file
2	<	* Copyright (C) 2000-2011 Hybrid Development Team
1	>	/* ircd-hybrid reference configuration file
2	>	* Copyright (C) 2000-2013 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/.
5		*
6		* $Id$
7		*/
8
9	<	/* IMPORTANT NOTES:
9	>	/*
10	>	* ########################################################################
11	>	* IMPORTANT NOTES:
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 24 | Line 25
25		*        12 hours 30 minutes 1 second
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
#	Line 32 | Line 33
33		* Sizes and times may be singular or plural.
34		*/
35
36	<	/* EFNET NOTE:
36	<	*
37	<	* This config file is NOT suitable for EFNet.  EFNet admins should use
38	<	* example.efnet.conf
39	<	*/
40	<
36	>
37		/*
38	<	* serverinfo {}:  contains information about the server. (OLD M:)
38	>	* serverinfo {}:  contains information about the server
39		*/
40		serverinfo {
41		/*
#	Line 51 | Line 47 | serverinfo {
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	>	* NOTE: The letters must be capitalized. This cannot be changed at runtime.
51		*/
52	<	sid = "_CHANGE_ME_";
52	>	sid = "0HY";
53
54		/*
55	<	* description: the description of the server.  '[' and ']' may not
60	<	* be used here for compatibility with older servers.
55	>	* description: the description of the server.
56		*/
57	<	description = "hybrid-7 test server";
57	>	description = "ircd-hybrid test server";
58
59		/*
60		* network info: the name and description of the network this server
61	<	* is on.  Shown in the 005 reply and used with serverhiding.
61	>	* is on. Shown in the 005 reply and used with serverhiding.
62		*/
63		network_name = "MyNet";
64		network_desc = "This is My Network";
#	Line 78 | Line 73 | serverinfo {
73		* vhost: the IP to bind to when we connect outward to ipv4 servers.
74		* This should be an ipv4 IP only, or "*" for INADDR_ANY.
75		*/
76	<	#vhost = "192.169.0.1";
76	>	#       vhost = "192.169.0.1";
77
78		/*
79		* vhost6: the IP to bind to when we connect outward to ipv6 servers.
80		* This should be an ipv6 IP only, or "*" for INADDR_ANY.
81		*/
82	<	#vhost6 = "3ffe:80e8:546::2";
82	>	#       vhost6 = "3ffe:80e8:546::2";
83
84	<	/* max_clients: the maximum number of clients allowed to connect */
84	>	/* max_clients: the maximum number of clients allowed to connect. */
85		max_clients = 512;
86
87		/*
88	+	* max_nick_length: only applies to local clients. Must be in the
89	+	* range of 9 to 30. Default is 9 if nothing else is specified.
90	+	*/
91	+	max_nick_length = 9;
92	+
93	+	/*
94	+	* max_topic_length: only applies to topics set by local clients.
95	+	* Must be in the range of 80 to 300. Default is 80 if nothing
96	+	* else is specified.
97	+	*/
98	+	max_topic_length = 160;
99	+
100	+	/*
101		* rsa_private_key_file: the path to the file containing our
102		* rsa key for cryptlink.
103		*
#	Line 102 | Line 110 | serverinfo {
110		*      chmod 0600 rsa.key
111		*      chmod 0644 rsa.pub
112		*/
113	<	#rsa_private_key_file = "/usr/local/ircd/etc/rsa.key";
113	>	#       rsa_private_key_file = "/usr/local/ircd/etc/rsa.key";
114
115		/*
116		* ssl_certificate_file: the path to the file containing our
117		* ssl certificate for encrypted client connection.
118		*
119		* This assumes your private RSA key is stored in rsa.key. You
120	<	* MUST have an RSA key in order to generate the certificate
120	>	* MUST have an RSA key in order to generate the certificate.
121	>	*
122	>	* Example command:
123		*
124		*      openssl req -new -days 365 -x509 -key rsa.key -out cert.pem
125		*
#	Line 122 | Line 132 | serverinfo {
132		*      Common Name: irc.someirc.net
133		*      E-mail: you@domain.com
134		*/
135	<	#ssl_certificate_file = "/usr/local/ircd/etc/cert.pem";
126	<
135	>	#       ssl_certificate_file = "/usr/local/ircd/etc/cert.pem";
136
137	<	#ssl_dh_param_file = "/usr/local/ircd/etc/dhparam.pem";
137	>	/*
138	>	* ssl_dh_param_file:
139	>	*
140	>	* Path to the PEM encoded Diffie-Hellman parameter file.
141	>	* DH parameters are strictly required when using ciphers
142	>	* with EDH (ephemeral Diffie-Hellman) key exchange.
143	>	*
144	>	* A DH parameter file can be created by running:
145	>	*
146	>	*      openssl dhparam -out dhparam.pem 1024
147	>	*
148	>	* Prime size must be at least 1024 bits. Further information
149	>	* regarding specific OpenSSL dhparam command-line options
150	>	* can be found in the OpenSSL manual.
151	>	*/
152	>	#       ssl_dh_param_file = "/usr/local/ircd/etc/dhparam.pem";
153
154		/*
155		* ssl_cipher_list:
156		*
157	<	* List of ciphers that are supported by _this_ server. Can be used to enforce
158	<	* specific ciphers for incoming SSL/TLS connections.
159	<	* If a client (which also includes incoming server connections) isn't capable
160	<	* of any cipher listed below, the connection will be simply rejected.
157	>	* List of ciphers that are supported by _this_ server. Can be used to
158	>	* enforce specific ciphers for incoming SSL/TLS connections.
159	>	* If a client (which also includes incoming server connections) isn't
160	>	* capable of any cipher listed below, the connection will simply be
161	>	* rejected.
162		*
163		* A list of supported ciphers can be obtained by running:
164		*
165		*      openssl ciphers -ssl3 -tls1 -v
166		*
167	<	* Multiple ciphers are separated by colons. The order of preference is from
168	<	* left to right.
167	>	* Multiple ciphers are separated by colons. The order of preference is
168	>	* from left to right.
169		*/
170	<	#ssl_cipher_list = "DHE-RSA-AES256-SHA:AES256-SHA";
170	>	#       ssl_cipher_list = "DHE-RSA-AES256-SHA:AES256-SHA";
171
172		/*
173	<	* ssl_server_protocol:
174	<	* SSL/TLS protocols we provide for incoming secure connections.
173	>	* ssl_server_method:
174	>	* ssl_client_method:
175	>	*
176	>	* SSL/TLS methods we provide for incoming (server method) and
177	>	* outgoing (client method) SSL/TLS connections.
178		* This can be either sslv3 for SSLv3, and/or tlsv1 for TLSv1.
151	–	* SSLv2 is not suppported. This cannot be changed at runtime.
179		*/
180	<	#ssl_server_protocol = sslv3, tlsv1;
180	>	#       ssl_server_method = tlsv1, sslv3;
181	>	#       ssl_client_method = tlsv1;
182		};
183
184		/*
#	Line 166 | Line 194 | admin {
194		* class {}:  contains information about classes for users
195		*/
196		class {
197	<	/* name: the name of the class.  classes are text now */
197	>	/* name: the name of the class. */
198		name = "users";
199
200		/*
#	Line 199 | Line 227 | class {
227
228		/*
229		* the following lines are optional and allow you to define
230	<	* how many users can connect from one /NN subnet
230	>	* how many users can connect from one /NN subnet.
231		*/
232		cidr_bitlen_ipv4 = 24;
233		cidr_bitlen_ipv6 = 120;
234		number_per_cidr = 16;
235
236		/*
237	<	* sendq: the amount of data allowed in a clients queue before
237	>	* sendq: the amount of data allowed in a clients send queue before
238		* they are dropped.
239		*/
240		sendq = 100 kbytes;
241	+
242	+	/*
243	+	* recvq: maximum amount of data in a clients receive queue before
244	+	* they are dropped for flooding. Defaults to 2560 if the chosen
245	+	* value isn't within the range of 512 to 8000.
246	+	*/
247	+	recvq = 2560 bytes;
248		};
249
250		class {
#	Line 217 | Line 252 | class {
252		ping_time = 90 seconds;
253		number_per_ip = 10;
254		max_number = 100;
255	<	sendq = 100kbytes;
255	>	sendq = 100 kbytes;
256	>
257	>	/*
258	>	* min_idle: minimum idle time that is shown in /whois.
259	>	*/
260	>	min_idle = 3 hours;
261	>
262	>	/*
263	>	* max_idle: maximum idle time that is shown in /whois.
264	>	*/
265	>	max_idle = 8 hours;
266	>
267	>	/*
268	>	* flags:
269	>	*
270	>	* random_idle          - idle time is randomly selected within the
271	>	*                        range of min_idle to max_idle
272	>	* hide_idle_from_opers - fake idle time will be shown to operators, too
273	>	*/
274	>	flags = random_idle, hide_idle_from_opers;
275		};
276
277		class {
#	Line 225 | Line 279 | class {
279		ping_time = 90 seconds;
280
281		/*
282	<	* ping_warning: how fast a server must reply to a PING before
229	<	* a warning to opers is generated.
230	<	*/
231	<	ping_warning = 15 seconds;
232	<
233	<	/*
234	<	* connectfreq: only used in server classes.  Specifies the delay
282	>	* connectfreq: only used in server classes. Specifies the delay
283		* between autoconnecting to servers.
284		*/
285		connectfreq = 5 minutes;
286
287	<	/* max number: the amount of servers to autoconnect to */
287	>	/* max number: the amount of servers to autoconnect to. */
288		max_number = 1;
289
290	<	/* sendq: servers need a higher sendq as they send more data */
290	>	/* sendq: servers need a higher sendq as they send more data. */
291		sendq = 2 megabytes;
292		};
293
294		/*
295	+	* motd {}: Allows to show a different MOTD to a client
296	+	* depending on its origin. Applies to local users only.
297	+	*/
298	+	motd {
299	+	/*
300	+	* mask: multiple mask entries are permitted. Mask can either be
301	+	* a class name or a hostname.
302	+	*/
303	+	mask = "*.at";
304	+	mask = "*.de";
305	+	mask = "*.ch";
306	+
307	+	/*
308	+	* file: path to the actual motd file.
309	+	*/
310	+	file = "/usr/local/ircd/etc/german.motd";
311	+	};
312	+
313	+	/*
314		* listen {}:  contains information about the ports ircd listens on
315		*/
316		listen {
317		/*
318	<	* port: the specific port to listen on.  If no host is specified
318	>	* port: the specific port to listen on. If no host is specified
319		* before, it will listen on all available IPs.
320		*
321		* Ports are separated via a comma, a range may be specified using ".."
#	Line 261 | Line 328 | listen {
328		* Listen on 192.168.0.1/6697 with ssl enabled and hidden from STATS P
329		* unless you are an administrator.
330		*
331	<	* NOTE: The "flags" directive has to come before "port".  Always!
331	>	* NOTE: The "flags" directive has to come before "port". Always!
332		*
333		* Currently available flags are:
334		*
335	<	*  ssl    - Port is for SSL client connections only
335	>	*  ssl    - Port may only accept TLS/SSL connections
336		*  server - Only server connections are permitted
337		*  hidden - Port is hidden from /stats P, unless you're an admin
338		*/
#	Line 275 | Line 342 | listen {
342
343		/*
344		* host: set a specific IP/host the ports after the line will listen
345	<	* on.  This may be ipv4 or ipv6.
345	>	* on. This may be ipv4 or ipv6.
346		*/
347		host = "1.2.3.4";
348		port = 7000, 7001;
#	Line 289 | Line 356 | listen {
356		*/
357		auth {
358		/*
359	<	* user: the user@host allowed to connect.  Multiple IPv4/IPv6 user
359	>	* user: the user@host allowed to connect. Multiple user
360		* lines are permitted per auth block.
361		*/
362		user = "*@172.16.0.0/12";
#	Line 305 | Line 372 | auth {
372		encrypted = yes;
373
374		/*
375	<	* spoof: fake the users host to this.  This is free-form,
376	<	* just do everyone a favor and don't abuse it. ('=' prefix on /stats I)
375	>	* spoof: fake the users host to this. This is free-form, just do
376	>	* everyone a favor and don't abuse it. ('=' prefix on /stats I)
377		*/
378		spoof = "I.still.hate.packets";
379
#	Line 325 | Line 392 | auth {
392		* resv_exempt   - exempt this user from resvs ('$' prefix on /stats I)
393		* no_tilde      - remove ~ from a user with no ident ('-' prefix on /stats I)
394		* can_flood     - allow this user to exceed flood limits ('|' prefix on /stats I)
395	+	* webirc        - enables WEBIRC authentication for web-based clients such as Mibbit
396	+	*                 ('<' prefix on /stats I)
397		*/
398		flags = need_password, spoof_notice, exceed_limit, kline_exempt,
399		gline_exempt, resv_exempt, no_tilde, can_flood;
#	Line 332 | Line 401 | auth {
401
402		auth {
403		/*
404	<	* redirect: the server and port to redirect a user to.  A user does
405	<	* not have to obey the redirection, the ircd just suggests an alternative
404	>	* redirect: the server and port to redirect a user to. A user does not
405	>	* have to obey the redirection, the ircd just suggests an alternative
406		* server for them.
407		*/
408		redirserv = "this.is.not.a.real.server";
#	Line 353 | Line 422 | auth {
422
423		/*
424		* operator {}:  defines ircd operators
356	–	*
357	–	* ircd-hybrid no longer supports local operators, privileges are
358	–	* controlled via flags.
425		*/
426		operator {
427		/* name: the name of the oper */
428	<	name = "god";
428	>	name = "sheep";
429
430		/*
431		* user: the user@host required for this operator. Multiple
432	<	* user="" lines are supported.
432	>	* user="" lines are supported.
433		*/
434	<	user = "*god@192.168.0.0/16";
434	>	user = "*sheep@192.168.0.0/16";
435		user = "*@127.0.0.0/8";
436
437		/*
438	<	* password: the password required to oper.  By default this will
438	>	* password: the password required to oper. By default this will
439		* need to be encrypted by using the provided mkpasswd tool.
440		* Several password hash algorithms are available depending
441		* on your system's crypt() implementation. For example, a modern
#	Line 395 | Line 461 | operator {
461		class = "opers";
462
463		/*
464	<	* umodes: default usermodes opers get when they /oper.  If defined,
464	>	* umodes: default usermodes opers get when they /oper. If defined,
465		* it will override oper_umodes settings in general {}.
466		* Available usermodes:
467		*
468		* +b - bots         - See bot and drone flooding notices
469		* +c - cconn        - Client connection/quit notices
404	–	* +C - cconn_full   - Client connection/quit notices full
470		* +D - deaf         - Don't receive channel messages
471		* +d - debug        - See debugging notices
472	<	* +f - full         - See I: line full notices
472	>	* +e - external     - See remote server connection and split notices
473	>	* +F - farconnect   - Remote client connection/quit notices
474	>	* +f - full         - See auth{} block full notices
475		* +G - softcallerid - Server Side Ignore for users not on your channels
476		* +g - callerid     - Server Side Ignore (for privmsgs etc)
477		* +H - hidden       - Hides operator status to other users
#	Line 414 | Line 481 | operator {
481		* +k - skill        - See server generated KILL messages
482		* +l - locops       - See LOCOPS messages
483		* +n - nchange      - See client nick changes
484	+	* +R - nononreg     - Only receive private messages from registered clients
485		* +s - servnotice   - See general server notices
486		* +u - unauth       - See unauthorized client notices
487		* +w - wallop       - See server generated WALLOPS
420	–	* +x - external     - See remote server connection and split notices
488		* +y - spy          - See LINKS, STATS, TRACE notices etc.
489		* +z - operwall     - See oper generated WALLOPS
490		*/
491	<	#       umodes = locops, servnotice, operwall, wallop;
491	>	umodes = locops, servnotice, operwall, wallop;
492
493		/*
494		* privileges: controls the activities and commands an oper is
495		* allowed to do on the server. All options default to no.
496		* Available options:
497		*
498	<	* module       - allows MODLIST, MODRESTART, MODLOAD, MODUNLOAD
499	<	* global_kill  - allows remote users to be /KILL'd
500	<	* remote       - allows remote SQUIT and CONNECT
501	<	* remoteban    - allows remote KLINE/UNKLINE
502	<	* dline        - allows DLINE
503	<	* undline      - allows UNDLINE
504	<	* kline        - allows KILL and KLINE
505	<	* unkline      - allows UNKLINE
506	<	* gline        - allows GLINE
507	<	* xline        - allows XLINE
508	<	* globops      - allows GLOBOPS
509	<	* operwall     - allows OPERWALL
510	<	* nick_changes - allows oper to see nickchanges via usermode +n
511	<	* rehash       - allows oper to REHASH config
512	<	* die          - allows DIE
513	<	* restart      - allows RESTART
514	<	* admin        - gives admin privileges. admins for example,
515	<	*                may see the real IP addresses of servers.
498	>	* module         - allows MODULE
499	>	* connect        - allows local CONNECT              | ('P' flag)
500	>	* connect:remote - allows remote CONNECT             | ('Q' flag)
501	>	* squit          - allows local SQUIT                | ('R' flag)
502	>	* squit:remote   - allows remote SQUIT               | ('S' flag)
503	>	* kill           - allows to KILL local clients      | ('N' flag)
504	>	* kill:remote    - allows remote users to be /KILL'd | ('O' flag)
505	>	* remoteban      - allows remote KLINE/UNKLINE       | ('B' flag)
506	>	* dline          - allows DLINE                      |
507	>	* undline        - allows UNDLINE                    |
508	>	* kline          - allows KLINE                      | ('K' flag)
509	>	* unkline        - allows UNKLINE                    | ('U' flag)
510	>	* gline          - allows GLINE                      | ('G' flag)
511	>	* xline          - allows XLINE                      | ('X' flag)
512	>	* locops         - allows LOCOPS                     |
513	>	* globops        - allows GLOBOPS                    |
514	>	* wallops        - allows WALLOPS                    |
515	>	* operwall       - allows OPERWALL                   | ('L' flag)
516	>	* rehash         - allows oper to REHASH config      | ('H' flag)
517	>	* die            - allows DIE                        | ('D' flag)
518	>	* restart        - allows RESTART                    |
519	>	* set            - allows SET                        |
520	>	* admin          - gives administrator privileges    | ('A' flag)
521		*/
522	<	flags = global_kill, remote, kline, unkline, xline, globops, restart,
523	<	die, rehash, nick_changes, admin, operwall, module;
522	>	flags = kill, kill:remote, connect, connect:remote, kline, unkline,
523	>	xline, globops, restart, die, rehash, admin, operwall, module;
524		};
525
526	+	/*
527	+	* service {}: specifies what server may act as a network service
528	+	*
529	+	* NOTE: it is absolutely important that every single server on the network
530	+	*       has the same service{} block.
531	+	*/
532		service {
533		name = "service.someserver";
534		name = "stats.someserver";
#	Line 464 | Line 542 | connect {
542		name = "irc.uplink.com";
543
544		/*
545	<	* host: the host or IP to connect to.  If a hostname is used it
545	>	* host: the host or IP to connect to. If a hostname is used it
546		* must match the reverse dns of the server.
547		*/
548		host = "192.168.0.1";
#	Line 493 | Line 571 | connect {
571		port = 6666;
572
573		/*
574	<	* hub_mask: the mask of servers that this server may hub.  Multiple
575	<	* entries are permitted
574	>	* hub_mask: the mask of servers that this server may hub. Multiple
575	>	* entries are permitted.
576		*/
577		hub_mask = "*";
578
579		/*
580	<	* leaf_mask: the mask of servers this server may not hub.  Multiple
581	<	* entries are permitted.  Useful for forbidding EU -> US -> EU routes.
580	>	* leaf_mask: the mask of servers this server may not hub. Multiple
581	>	* entries are permitted. Useful for forbidding EU -> US -> EU routes.
582		*/
583		#       leaf_mask = "*.uk";
584
585		/* class: the class this server is in */
586		class = "server";
587
588	<	#ssl_cipher_list = "DHE-RSA-AES256-SHA:AES256-SHA";
588	>	/*
589	>	* ssl_cipher_list:
590	>	*
591	>	* List of ciphers that the server we are connecting to must support.
592	>	* If the server isn't capable of any cipher listed below, the
593	>	* connection will simply be rejected.
594	>	* Can be used to enforce stronger ciphers, even though this option
595	>	* is not necessarily required to establish a SSL/TLS connection.
596	>	*
597	>	* Multiple ciphers are separated by colons. The order of preference
598	>	* is from left to right.
599	>	*/
600	>	#       ssl_cipher_list = "DHE-RSA-AES256-SHA:AES256-SHA";
601
602		/*
603		* autoconn   - controls whether we autoconnect to this server or not,
604		*              dependent on class limits. By default, this is disabled.
515	–	* burst_away - This will send the /away string that users have set
516	–	*              on the server burst.  Note this can be a lot of data
517	–	*              and slow down your server burst.
518	–	* topicburst - Send topics to this server during channel burst.  Works
519	–	*              only if the server we are connecting to is capable
520	–	*              of TBURST/TB.
605		* ssl        - Initiates a TLS/SSL connection.
606		*/
607	<	#       flags = autoconn, burst_away, topicburst;
607	>	#       flags = autoconn, ssl;
608		};
609
610		connect {
#	Line 560 | Line 644 | cluster {
644		* type: list of what to share, options are as follows:
645		*      dline   - share dlines
646		*      undline - share undlines
647	<	*      kline   - share klines
648	<	*      unkline - share unklines
649	<	*      xline   - share xlines
650	<	*      unxline - share unxlines
651	<	*      resv    - share resvs
652	<	*      unresv  - share unresvs
653	<	*      locops  - share locops
654	<	*      all     - share all of the above (default)
647	>	*      kline   - share klines
648	>	*      unkline - share unklines
649	>	*      xline   - share xlines
650	>	*      unxline - share unxlines
651	>	*      resv    - share resvs
652	>	*      unresv  - share unresvs
653	>	*      locops  - share locops
654	>	*      all     - share all of the above (default)
655		*/
656		type = kline, unkline, locops, xline, resv;
657		};
#	Line 577 | Line 661 | cluster {
661		*
662		* NOTE: This can be effectively used for remote klines.
663		*       Please note that there is no password authentication
664	<	*       for users setting remote klines.  You must also be
664	>	*       for users setting remote klines. You must also be
665		*       /oper'd in order to issue a remote kline.
666		*/
667		shared {
668		/*
669	<	* name: the server the user must be on to set klines.  If this is not
669	>	* name: the server the user must be on to set klines. If this is not
670		* specified, the user will be allowed to kline from all servers.
671		*/
672		name = "irc2.some.server";
673
674		/*
675	<	* user: the user@host mask that is allowed to set klines.  If this is
675	>	* user: the user@host mask that is allowed to set klines. If this is
676		* not specified, all users on the server above will be allowed to set
677		* a remote kline.
678		*/
#	Line 598 | Line 682 | shared {
682		* type: list of what to share, options are as follows:
683		*      dline   - allow oper/server to dline
684		*      undline - allow oper/server to undline
685	<	*      kline   - allow oper/server to kline
686	<	*      unkline - allow oper/server to unkline
687	<	*      xline   - allow oper/server to xline
688	<	*      unxline - allow oper/server to unxline
689	<	*      resv    - allow oper/server to resv
690	<	*      unresv  - allow oper/server to unresv
685	>	*      kline   - allow oper/server to kline
686	>	*      unkline - allow oper/server to unkline
687	>	*      xline   - allow oper/server to xline
688	>	*      unxline - allow oper/server to unxline
689	>	*      resv    - allow oper/server to resv
690	>	*      unresv  - allow oper/server to unresv
691		*      locops  - allow oper/server to locops - only used for servers that cluster
692	<	*      all     - allow oper/server to do all of the above (default)
692	>	*      all     - allow oper/server to do all of the above (default)
693		*/
694		type = kline, unkline, resv;
695		};
#	Line 619 | Line 703 | kill {
703		reason = "Obviously hacked account";
704		};
705
622	–	kill {
623	–	user = "^O[[:alpha:]]?[[:digit:]]+(x\.o|\.xo)$@^[[:alnum:]]{4}\.evilnet.tld$";
624	–
625	–	/*
626	–	* NOTE: You have to set type=regex; when using a regular expression
627	–	* based user entry
628	–	*/
629	–	type = regex;
630	–	};
631	–
706		/*
707		* deny {}:  IPs that are not allowed to connect (before DNS/ident lookup)
708		* Oper issued dlines will be added to the specified dline config
#	Line 639 | Line 713 | deny {
713		};
714
715		/*
716	<	* exempt {}: IPs that are exempt from deny {} and Dlines
716	>	* exempt {}:  IPs that are exempt from deny {} and Dlines
717		*/
718		exempt {
719		ip = "192.168.0.0/16";
#	Line 648 | Line 722 | exempt {
722		/*
723		* resv {}:  nicks and channels users may not use/join
724		*/
725	+	resv { mask = "clone*"; reason = "Clone bots"; };
726	+	resv { mask = "ChanServ"; reason = "Reserved for services"; };
727	+	resv { mask = "NickServ"; reason = "Reserved for services"; };
728	+	resv { mask = "OperServ"; reason = "Reserved for services"; };
729	+	resv { mask = "MemoServ"; reason = "Reserved for services"; };
730	+	resv { mask = "BotServ"; reason = "Reserved for services"; };
731	+	resv { mask = "HelpServ"; reason = "Reserved for services"; };
732	+	resv { mask = "HostServ"; reason = "Reserved for services"; };
733	+	resv { mask = "StatServ"; reason = "Reserved for services"; };
734	+	resv { mask = "#*services*"; reason = "Reserved for services"; };
735	+
736		resv {
737	<	/* reason: the reason for the proceeding resv's */
738	<	reason = "Reserved for services";
737	>	/*
738	>	* mask: masks starting with a '#' are automatically considered
739	>	* as channel name mask.
740	>	*/
741	>	mask = "#helsinki";
742	>	reason = "Channel is reserved for finnish inhabitants";
743
744	<	/* resv: the nicks and channels users may not join/use */
745	<	nick = "Global";
746	<	nick = "DevNull";
747	<	nick = "Services";
748	<	nick = "StatServ";
749	<	nick = "HostServ";
661	<	nick = "NickServ";
662	<	nick = "ChanServ";
663	<	nick = "MemoServ";
664	<	nick = "OperServ";
665	<	channel = "#services";
666	<
667	<	/* resv: wildcard masks are also supported in nicks only */
668	<	reason = "Clone bots";
669	<	nick = "clone*";
744	>	/*
745	>	* exempt: can be either a ISO 3166 alpha-2 two letter country
746	>	* code, or a nick!user@host mask. CIDR is supported. Exempt
747	>	* entries can be stacked.
748	>	*/
749	>	exempt = "FI";
750		};
751
752		/*
753	<	* gecos {}:  The X: replacement, used for banning users based on
674	<	* their "realname".
753	>	* gecos {}:  Used for banning users based on their "realname".
754		*/
755		gecos {
756		name = "*sex*";
#	Line 683 | Line 762 | gecos {
762		reason = "Trojan drone";
763		};
764
686	–	gecos {
687	–	name = "*http*";
688	–	reason = "Spambot";
689	–	};
690	–
691	–	gecos {
692	–	name = "^\[J[0o]hn Do[3e]\]-[0-9]{2,5}$";
693	–
694	–	/*
695	–	* NOTE: You have to set type=regex; when using a regular expression
696	–	* based name entry
697	–	*/
698	–	type = regex;
699	–	};
700	–
765		/*
766		* channel {}:  The channel block contains options pertaining to channels
767		*/
#	Line 711 | Line 775 | channel {
775		*   3 | mirc color
776		*  15 | plain text
777		*  22 | reverse
778	+	*  29 | italic
779		*  31 | underline
780		* 160 | non-breaking space
781		*/
782		disable_fake_channels = yes;
783
784		/*
720	–	* restrict_channels: reverse channel RESVs logic, only reserved
721	–	* channels are allowed
722	–	*/
723	–	restrict_channels = no;
724	–
725	–	/*
726	–	* disable_local_channels: prevent users from joining &channels.
727	–	*/
728	–	disable_local_channels = no;
729	–
730	–	/*
731	–	* use_invex: Enable/disable channel mode +I, a n!u@h list of masks
732	–	* that can join a +i channel without an invite.
733	–	*/
734	–	use_invex = yes;
735	–
736	–	/*
737	–	* use_except: Enable/disable channel mode +e, a n!u@h list of masks
738	–	* that can join a channel through a ban (+b).
739	–	*/
740	–	use_except = yes;
741	–
742	–	/*
743	–	* use_knock: Allows users to request an invite to a channel that
744	–	* is locked somehow (+ikl).  If the channel is +p or you are banned
745	–	* the knock will not be sent.
746	–	*/
747	–	use_knock = yes;
748	–
749	–	/*
785		* knock_delay: The amount of time a user must wait between issuing
786		* the knock command.
787		*/
#	Line 759 | Line 794 | channel {
794		knock_delay_channel = 1 minute;
795
796		/*
762	–	* burst_topicwho: enable sending of who set topic on topicburst
763	–	* default is yes
764	–	*/
765	–	burst_topicwho = yes;
766	–
767	–	/*
797		* max_chans_per_user: The maximum number of channels a user can
798		* join/be on.
799		*/
800		max_chans_per_user = 25;
801
802	<	/* quiet_on_ban: stop banned people talking in channels. */
803	<	quiet_on_ban = yes;
802	>	/*
803	>	* max_chans_per_oper: The maximum number of channels an oper can
804	>	* join/be on.
805	>	*/
806	>	max_chans_per_oper = 50;
807
808		/* max_bans: maximum number of +b/e/I modes in a channel */
809	<	max_bans = 25;
809	>	max_bans = 100;
810
811		/*
812		* how many joins in how many seconds constitute a flood, use 0 to
#	Line 794 | Line 826 | channel {
826
827		/*
828		* default_split_user_count: when the usercount is lower than this level,
829	<	* consider ourselves split.  This must be set for automatic splitmode.
829	>	* consider ourselves split. This must be set for automatic splitmode.
830		*/
831		default_split_user_count = 0;
832
833		/*
834		* default_split_server_count: when the servercount is lower than this,
835	<	* consider ourselves split.  This must be set for automatic splitmode.
835	>	* consider ourselves split. This must be set for automatic splitmode.
836		*/
837		default_split_server_count = 0;
838
#	Line 817 | Line 849 | channel {
849		*/
850		serverhide {
851		/*
852	+	* disable_remote_commands: disable users doing commands
853	+	* on remote servers.
854	+	*/
855	+	disable_remote_commands = no;
856	+
857	+	/*
858		* flatten_links: this option will show all servers in /links appear
859	<	* that they are linked to this current server
859	>	* that they are linked to this current server.
860		*/
861		flatten_links = no;
862
#	Line 830 | Line 868 | serverhide {
868
869		/*
870		* hidden: hide this server from a /links output on servers that
871	<	* support it.  This allows hub servers to be hidden etc.
871	>	* support it. This allows hub servers to be hidden etc.
872		*/
873		hidden = no;
874
875		/*
838	–	* disable_hidden: prevent servers hiding themselves from a
839	–	* /links output.
840	–	*/
841	–	disable_hidden = no;
842	–
843	–	/*
876		* hide_servers: hide remote servernames everywhere and instead use
877		* hidden_name and network_desc.
878		*/
879		hide_servers = no;
880
881		/*
882	+	* hide_services: define this if you want to hide the location of
883	+	* services servers that are specified in the service{} block.
884	+	*/
885	+	hide_services = no;
886	+
887	+	/*
888		* Use this as the servername users see if hide_servers = yes.
889		*/
890		hidden_name = "*.hidden.com";
#	Line 861 | Line 899 | serverhide {
899		* logfiles.
900		*
901		* We recommend you leave this disabled, and just take care with who you
902	<	* give admin=yes; to.
902	>	* give administrator privileges to.
903		*/
904		hide_server_ips = no;
905		};
906
907		/*
908		* general {}:  The general block contains many of the options that were once
909	<	* compiled in options in config.h.  The general block is read at start time.
909	>	* compiled in options in config.h
910		*/
911		general {
912		/* services_name: servername of nick/channel services */
#	Line 877 | Line 915 | general {
915		/* max_watch: maximum WATCH entries a client can have. */
916		max_watch = 60;
917
918	+	/* gline_enable: enable glines, network wide temp klines. */
919	+	gline_enable = yes;
920	+
921	+	/*
922	+	* gline_duration: the amount of time a gline will remain on your
923	+	* server before expiring.
924	+	*/
925	+	gline_duration = 1 day;
926	+
927	+	/*
928	+	* gline_request_duration: how long a pending G-line can be around.
929	+	* 10 minutes should be plenty.
930	+	*/
931	+	gline_request_duration = 10 minutes;
932	+
933		/*
934		* gline_min_cidr: the minimum required length of a CIDR bitmask
935	<	* for IPv4 based glines
935	>	* for IPv4 based glines.
936		*/
937		gline_min_cidr = 16;
938
939		/*
940		* gline_min_cidr6: the minimum required length of a CIDR bitmask
941	<	* for IPv6 based glines
941	>	* for IPv6 based glines.
942		*/
943		gline_min_cidr6 = 48;
944
#	Line 895 | Line 948 | general {
948		invisible_on_connect = yes;
949
950		/*
951	<	* Show "actually using host <ip>" on /whois when possible.
952	<	*/
953	<	use_whois_actually = yes;
901	<
902	<	/*
903	<	* Max time from the nickname change that still causes KILL
904	<	* automatically to switch for the current nick of that user.
951	>	* kill_chase_time_limit: maximum time from the nickname change that
952	>	* still causes KILL automatically to switch for the current nick of
953	>	* that user.
954		*/
955		kill_chase_time_limit = 90 seconds;
956
957		/*
958	<	* If hide_spoof_ips is disabled, opers will be allowed to see the real
958	>	* hide_spoof_ips: if disabled, opers will be allowed to see the real
959		* IP of spoofed users in /trace etc. If this is defined they will be
960		* shown a masked IP.
961		*/
962		hide_spoof_ips = yes;
963
964		/*
965	<	* Ignore bogus timestamps from other servers.  Yes, this will desync
966	<	* the network, but it will allow chanops to resync with a valid non TS 0
965	>	* Ignore bogus timestamps from other servers. Yes, this will desync the
966	>	* network, but it will allow chanops to resync with a valid non TS 0
967		*
968		* This should be enabled network wide, or not at all.
969		*/
#	Line 926 | Line 975 | general {
975		*/
976		disable_auth = no;
977
929	–	/* disable_remote_commands: disable users doing commands on remote servers */
930	–	disable_remote_commands = no;
931	–
978		/*
979		* tkline_expire_notices: enables or disables temporary kline/xline
980		* expire notices.
#	Line 937 | Line 983 | general {
983
984		/*
985		* default_floodcount: the default value of floodcount that is configurable
986	<	* via /quote set floodcount.  This is the amount of lines a user
986	>	* via /quote set floodcount. This is the amount of lines a user
987		* may send to any other user/channel in one second.
988		*/
989		default_floodcount = 10;
#	Line 956 | Line 1002 | general {
1002
1003		/*
1004		* min_nonwildcard: the minimum non wildcard characters in k/d/g lines
1005	<	* placed via the server.  klines hand placed are exempt from limits.
1006	<	* wildcard chars: '.' ':' '*' '?' '@' '!' '#'
1005	>	* placed via the server. K-lines hand placed are exempt from limits.
1006	>	* Wildcard chars: '.', ':', '*', '?', '@', '!'
1007		*/
1008		min_nonwildcard = 4;
1009
1010		/*
1011		* min_nonwildcard_simple: the minimum non wildcard characters in
1012	<	* gecos bans.  wildcard chars: '*' '?' '#'
1012	>	* gecos bans. Wildcard chars: '*', '?'
1013		*/
1014		min_nonwildcard_simple = 3;
1015
1016	<	/* max_accept: maximum allowed /accept's for +g usermode */
1016	>	/* max_accept: maximum allowed /accept's for +g usermode. */
1017		max_accept = 20;
1018
1019	<	/* anti_nick_flood: enable the nickflood control code */
1019	>	/* anti_nick_flood: enable the nickflood control code. */
1020		anti_nick_flood = yes;
1021
1022		/* nick flood: the nick changes allowed in the specified period */
#	Line 985 | Line 1031 | general {
1031
1032		/*
1033		* ts delta: the time delta allowed between server clocks before
1034	<	* a warning is given, or before the link is dropped.  all servers
1034	>	* a warning is given, or before the link is dropped. All servers
1035		* should run ntpdate/rdate to keep clocks in sync
1036		*/
1037		ts_warn_delta = 30 seconds;
1038		ts_max_delta = 5 minutes;
1039
1040		/*
995	–	* kline_with_reason: show the user the reason why they are k/d/glined
996	–	* on exit.  May give away who set k/dline when set via tcm.
997	–	*/
998	–	kline_with_reason = yes;
999	–
1000	–	/*
1001	–	* kline_reason: show this message to users on channel
1002	–	* instead of the oper reason.
1003	–	*/
1004	–	kline_reason = "Connection closed";
1005	–
1006	–	/*
1007	–	* reject_hold_time: wait this amount of time before disconnecting
1008	–	* a rejected client. Use 0 to disable.
1009	–	*/
1010	–	reject_hold_time = 0;
1011	–
1012	–	/*
1041		* warn_no_nline: warn opers about servers that try to connect but
1042	<	* we don't have a connect {} block for.  Twits with misconfigured
1042	>	* we don't have a connect {} block for. Twits with misconfigured
1043		* servers can get really annoying with this enabled.
1044		*/
1045		warn_no_nline = yes;
1046
1047		/*
1048		* stats_e_disabled: set this to 'yes' to disable "STATS e" for both
1049	<	* operators and administrators.  Doing so is a good idea in case
1049	>	* operators and administrators. Doing so is a good idea in case
1050		* there are any exempted (exempt{}) server IPs you don't want to
1051		* see leaked.
1052		*/
#	Line 1031 | Line 1059 | general {
1059		stats_P_oper_only = yes;
1060
1061		/*
1062	<	* stats i oper only: make stats i (auth {}) oper only. set to:
1063	<	*     yes:    show users no auth blocks, made oper only.
1064	<	*     masked: show users first matching auth block
1065	<	*     no:     show users all auth blocks.
1062	>	* stats i oper only: make stats i (auth {}) oper only. Set to:
1063	>	*     yes    - show users no auth blocks, made oper only.
1064	>	*     masked - show users first matching auth block
1065	>	*     no     - show users all auth blocks.
1066		*/
1067		stats_i_oper_only = yes;
1068
1069		/*
1070	<	* stats_k_oper_only: make stats k/K (klines) oper only.  set to:
1071	<	*     yes:    show users no auth blocks, made oper only
1072	<	*     masked: show users first matching auth block
1073	<	*     no:     show users all auth blocks.
1070	>	* stats_k_oper_only: make stats k/K (klines) oper only. Set to:
1071	>	*     yes    - show users no auth blocks, made oper only
1072	>	*     masked - show users first matching auth block
1073	>	*     no     - show users all auth blocks.
1074		*/
1075		stats_k_oper_only = yes;
1076
#	Line 1066 | Line 1094 | general {
1094
1095		/*
1096		* pace_wait: time between more intensive commands
1097	<	* (INFO, LINKS, LIST, MAP, MOTD, STATS, WHO, wildcard WHOIS, WHOWAS)
1097	>	* (AWAY, INFO, LINKS, MAP, MOTD, STATS, WHO, wildcard WHOIS, WHOWAS)
1098		*/
1099		pace_wait = 10 seconds;
1100
#	Line 1087 | Line 1115 | general {
1115
1116		/*
1117		* true_no_oper_flood: completely eliminate flood limits for opers
1118	<	* and for clients with can_flood = yes in their auth {} blocks
1118	>	* and for clients with can_flood = yes in their auth {} blocks.
1119		*/
1120		true_no_oper_flood = yes;
1121
1122	<	/* oper_pass_resv: allow opers to over-ride RESVs on nicks/channels */
1122	>	/* oper_pass_resv: allow opers to over-ride RESVs on nicks/channels. */
1123		oper_pass_resv = yes;
1124
1125		/* REMOVE ME.  The following line checks you've been reading. */
#	Line 1099 | Line 1127 | general {
1127
1128		/*
1129		* max_targets: the maximum amount of targets in a single
1130	<	* PRIVMSG/NOTICE.  Set to 999 NOT 0 for unlimited.
1130	>	* PRIVMSG/NOTICE. Set to 999 NOT 0 for unlimited.
1131		*/
1132		max_targets = 4;
1133
1134		/*
1107	–	* client_flood: maximum amount of data in a clients queue before
1108	–	* they are dropped for flooding.
1109	–	*/
1110	–	client_flood = 2560 bytes;
1111	–
1112	–	/*
1113	–	* message_locale: the default message locale
1114	–	* Use "standard" for the compiled in defaults.
1115	–	* To install the translated messages, go into messages/ in the
1116	–	* source directory and run `make install'.
1117	–	*/
1118	–	message_locale = "standard";
1119	–
1120	–	/*
1135		* usermodes configurable: a list of usermodes for the options below
1136		*
1137		* +b - bots         - See bot and drone flooding notices
1138		* +c - cconn        - Client connection/quit notices
1125	–	* +C - cconn_full   - Client connection/quit notices full
1139		* +D - deaf         - Don't receive channel messages
1140		* +d - debug        - See debugging notices
1141	<	* +f - full         - See I: line full notices
1141	>	* +e - external     - See remote server connection and split notices
1142	>	* +F - farconnect   - Remote client connection/quit notices
1143	>	* +f - full         - See auth{} block full notices
1144		* +G - softcallerid - Server Side Ignore for users not on your channels
1145		* +g - callerid     - Server Side Ignore (for privmsgs etc)
1146		* +H - hidden       - Hides operator status to other users
#	Line 1135 | Line 1150 | general {
1150		* +k - skill        - See server generated KILL messages
1151		* +l - locops       - See LOCOPS messages
1152		* +n - nchange      - See client nick changes
1153	+	* +R - nononreg     - Only receive private messages from registered clients
1154		* +s - servnotice   - See general server notices
1155		* +u - unauth       - See unauthorized client notices
1156		* +w - wallop       - See server generated WALLOPS
1141	–	* +x - external     - See remote server connection and split notices
1157		* +y - spy          - See LINKS, STATS, TRACE notices etc.
1158		* +z - operwall     - See oper generated WALLOPS
1159		*/
1160
1161		/* oper_only_umodes: usermodes only opers may set */
1162	<	oper_only_umodes = bots, cconn, cconn_full, debug, full, hidden, skill,
1162	>	oper_only_umodes = bots, cconn, debug, full, hidden, skill,
1163		nchange, rej, spy, external, operwall,
1164	<	locops, unauth;
1164	>	locops, unauth, farconnect;
1165
1166		/* oper_umodes: default usermodes opers get when they /oper */
1167		oper_umodes = bots, locops, servnotice, operwall, wallop;
1168
1169		/*
1170		* use_egd: if your system does not have *random devices yet you
1171	<	* want to use OpenSSL and encrypted links, enable this.  Beware -
1172	<	* EGD is *very* CPU intensive when gathering data for its pool
1171	>	* want to use OpenSSL and encrypted links, enable this. Beware -
1172	>	* EGD is *very* CPU intensive when gathering data for its pool.
1173		*/
1174		#       use_egd = yes;
1175
#	Line 1166 | Line 1181 | general {
1181
1182		/*
1183		* throttle_time: the minimum amount of time between connections from
1184	<	* the same ip.  exempt {} blocks are excluded from this throttling.
1185	<	* Offers protection against flooders who reconnect quickly.
1184	>	* the same ip. exempt {} blocks are excluded from this throttling.
1185	>	* Offers protection against flooders who reconnect quickly.
1186		* Set to 0 to disable.
1187		*/
1188		throttle_time = 10;
1189		};
1190
1176	–	glines {
1177	–	/* enable: enable glines, network wide temp klines */
1178	–	enable = yes;
1179	–
1180	–	/*
1181	–	* duration: the amount of time a gline will remain on your
1182	–	* server before expiring
1183	–	*/
1184	–	duration = 1 day;
1185	–
1186	–	/*
1187	–	* log: which types of rules you want to log when triggered
1188	–	* (choose reject or block)
1189	–	*/
1190	–	log = reject, block;
1191	–
1192	–	/*
1193	–	* NOTE: gline ACLs can cause a desync of glines throughout the
1194	–	* network, meaning some servers may have a gline triggered, and
1195	–	* others may not. Also, you only need insert rules for glines
1196	–	* that you want to block and/or reject. If you want to accept and
1197	–	* propagate the gline, do NOT put a rule for it.
1198	–	*/
1199	–
1200	–	/* user@host for rule to apply to */
1201	–	user = "god@I.still.hate.packets";
1202	–	/* server for rule to apply to */
1203	–	name = "hades.arpa";
1204	–
1205	–	/*
1206	–	* action: action to take when a matching gline is found. options are:
1207	–	*  reject      - do not apply the gline locally
1208	–	*  block       - do not propagate the gline
1209	–	*/
1210	–	action = reject, block;
1211	–
1212	–	user = "god@*";
1213	–	name = "*";
1214	–	action = block;
1215	–	};
1216	–
1191		modules {
1192		/*
1193		* path: other paths to search for modules specified below
1194	<	* and in /modload.
1194	>	* and in "/module load".
1195		*/
1196		path = "/usr/local/ircd/lib/ircd-hybrid/modules";
1197		path = "/usr/local/ircd/lib/ircd-hybrid/modules/autoload";
1198
1199	<	/* module: the name of a module to load on startup/rehash */
1200	<	#module = "some_module.la";
1199	>	/* module: the name of a module to load on startup/rehash. */
1200	>	#       module = "some_module.la";
1201		};
1202
1203		/*
#	Line 1232 | Line 1206 | modules {
1206		log {
1207		/* Do you want to enable logging to ircd.log? */
1208		use_logging = yes;
1235	–	timestamp = yes;
1209
1210		file {
1211		type = oper;
1212	<	name = "/home/ircd/var/log/oper.log";
1212	>	name = "/usr/local/ircd/var/log/oper.log";
1213		size = unlimited;
1214		};
1215
1216		file {
1217		type = user;
1218	<	name = "/home/ircd/var/log/user.log";
1218	>	name = "/usr/local/ircd/var/log/user.log";
1219		size = 50 megabytes;
1220		};
1221
1222		file {
1223		type = kill;
1224	<	name = "/home/ircd/var/log/kill.log";
1224	>	name = "/usr/local/ircd/var/log/kill.log";
1225		size = 50 megabytes;
1226		};
1227
1228		file {
1229		type = kline;
1230	<	name = "/home/ircd/var/log/kline.log";
1230	>	name = "/usr/local/ircd/var/log/kline.log";
1231		size = 50 megabytes;
1232		};
1233
1234		file {
1235		type = dline;
1236	<	name = "/home/ircd/var/log/dline.log";
1236	>	name = "/usr/local/ircd/var/log/dline.log";
1237		size = 50 megabytes;
1238		};
1239
1240		file {
1241		type = gline;
1242	<	name = "/home/ircd/var/log/gline.log";
1242	>	name = "/usr/local/ircd/var/log/gline.log";
1243		size = 50 megabytes;
1244		};
1245
1246		file {
1247		type = debug;
1248	<	name = "/home/ircd/var/log/debug.log";
1248	>	name = "/usr/local/ircd/var/log/debug.log";
1249		size = 50 megabytes;
1250	<	};
1250	>	};
1251		};

Diff Legend

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