ViewVC Help
View File | Revision Log | Show Annotations | View Changeset | Root Listing
root/svn/ircd-hybrid/trunk/doc/reference.conf
Revision: 4173
Committed: Sat Jul 5 15:59:30 2014 UTC (9 years, 8 months ago) by michael
File size: 38156 byte(s)
Log Message:
- Update reference.conf

File Contents

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

Properties

Name Value
svn:eol-style native
svn:keywords Id Revision