ViewVC Help
View File | Revision Log | Show Annotations | View Changeset | Root Listing
root/svn/ircd-hybrid/trunk/doc/reference.conf
Revision: 7668
Committed: Wed Jul 20 17:09:49 2016 UTC (10 years ago) by michael
File size: 40953 byte(s)
Log Message:
- Fixed svn properties

File Contents

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

Properties

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