ViewVC Help
View File | Revision Log | Show Annotations | View Changeset | Root Listing
root/svn/ircd-hybrid/trunk/doc/reference.conf
Revision: 2269
Committed: Tue Jun 18 15:07:26 2013 UTC (10 years, 9 months ago) by michael
File size: 36407 byte(s)
Log Message:
- Added general::stats_u_oper_only configuration option

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

Properties

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