ViewVC Help
View File | Revision Log | Show Annotations | View Changeset | Root Listing
root/svn/ircd-hybrid/trunk/doc/reference.conf
Revision: 5029
Committed: Fri Dec 12 15:28:22 2014 UTC (9 years, 3 months ago) by michael
File size: 39562 byte(s)
Log Message:
- reference.conf: fixed stats_k_oper_only documentation

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

Properties

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