ViewVC Help
View File | Revision Log | Show Annotations | View Changeset | Root Listing
root/svn/ircd-hybrid/trunk/doc/reference.conf
Revision: 1832
Committed: Fri Apr 19 19:16:09 2013 UTC (10 years, 11 months ago) by michael
File size: 34252 byte(s)
Log Message:
- Made all numeric defines use the actual string instead of the numeric value
  which allows to use gcc's printf format attribute
- Remove current message locale implementation

File Contents

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

Properties

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