/* doc/example.conf - ircd-hybrid-7 Example configuration file
 * Copyright (C) 2000-2006 Hybrid Development Team
 *
 * Written by ejb, wcampbel, db, leeh and others
 * Other example configurations can be found in the source dir under
 * etc/.
 *
 * $Id: example.conf 853 2007-02-22 06:01:30Z db $
 */

/* IMPORTANT NOTES:
 *
 * auth {} blocks MUST be specified in order of precedence.  The first one
 * that matches a user will be used.  So place spoofs first, then specials,
 * then general access.
 *
 * Shell style (#), C++ style (//) and C style comments are supported.
 *
 * Files may be included by either:
 *        .include "filename"
 *        .include <filename>
 *
 * Times/durations are written as:
 *        12 hours 30 minutes 1 second
 *        
 * Valid units of time:
 *        month, week, day, hour, minute, second
 *
 * Valid units of size:
 *        megabyte/mbyte/mb, kilobyte/kbyte/kb, byte
 *
 * Sizes and times may be singular or plural.  
 */ 

/* EFNET NOTE:
 *
 * This config file is NOT suitable for EFNet.  EFNet admins should use
 * example.efnet.conf
 */
 
/*
 * serverinfo {}:  contains information about the server. (OLD M:)
 */
serverinfo {
	/*
	 * name: the name of our server.  This cannot be changed at runtime.
	 */
	name = "hades.arpa";

	/*
	 * sid: a server's unique ID.  This is three characters long and must
	 * be in the form [0-9][A-Z0-9][A-Z0-9].  The first character must be
	 * a digit, followed by 2 alpha-numerical letters.
	 * NOTE: The letters must be capitalized.  This cannot be changed at runtime.
	 */
	sid = "_CHANGE_ME_";

	/*
	 * description: the description of the server.  '[' and ']' may not
	 * be used here for compatibility with older servers.
	 */
	description = "hybrid-7 test server";

	/*
	 * network info: the name and description of the network this server
	 * is on.  Shown in the 005 reply and used with serverhiding.
	 */
	network_name = "MyNet";
	network_desc = "This is My Network";

	/*
	 * hub: allow this server to act as a hub and have multiple servers
	 * connected to it.  This may not be changed if there are active
	 * LazyLink servers.
	 */
	hub = no;

	/*
	 * vhost: the IP to bind to when we connect outward to ipv4 servers.
	 * This should be an ipv4 IP only, or "* for INADDR_ANY.
	 */
	#vhost = "192.169.0.1";

	/*
	 * vhost6: the IP to bind to when we connect outward to ipv6 servers.
	 * This should be an ipv6 IP only, or "* for INADDR_ANY.
	 */
	#vhost6 = "3ffe:80e8:546::2";

	/* max_clients: the maximum number of clients allowed to connect */
	max_clients = 512;

	/*
	 * rsa key: the path to the file containing our rsa key for cryptlink.
	 *
	 * Example command to store a 2048 bit RSA keypair in
	 * rsa.key, and the public key in rsa.pub:
	 * 
	 * 	openssl genrsa -out rsa.key 2048
	 *	openssl rsa -in rsa.key -pubout -out rsa.pub
	 *	chown <ircd-user>.<ircd.group> rsa.key rsa.pub
	 *	chmod 0600 rsa.key
	 *	chmod 0644 rsa.pub
	 */
	#rsa_private_key_file = "/usr/local/ircd/etc/rsa.key";

	/*
	 * ssl certificate: the path to the file containing our ssl certificate
	 * for encrypted client connection.
	 *
	 * This assumes your private RSA key is stored in rsa.key. You
	 * MUST have an RSA key in order to generate the certificate
	 *
	 *	openssl req -new -days 365 -x509 -key rsa.key -out cert.pem
	 *
	 * See http://www.openssl.org/docs/HOWTO/certificates.txt
	 *
	 * Please use the following values when generating the cert
	 *
	 *	Organization Name: Network Name
	 *	Organization Unit Name: changme.someirc.net
	 *	Common Name: irc.someirc.net
	 *	E-mail: you@domain.com
	 */
	#ssl_certificate_file = "/usr/local/ircd/etc/cert.pem";
};

/*
 * admin {}:  contains admin information about the server. (OLD A:)
 */
admin {
	name = "Smurf target";
	description = "Main Server Administrator";
	email = "<syn@packets.r.us>";
};

/*
 * log {}:  contains information about logfiles.
 */
log {
	/* Do you want to enable logging to ircd.log? */
	use_logging = yes;

	/*
	 * logfiles: the logfiles to use for user connects, /oper uses,
	 * and failed /oper.  These files must exist for logging to be used.
	 */
	fname_userlog = "logs/userlog";
	fname_operlog = "logs/operlog";
	fname_killlog = "logs/kill";
	fname_klinelog = "logs/kline";
	fname_glinelog = "logs/gline";

	/*
	 * log_level: the amount of detail to log in ircd.log.  The
	 * higher, the more information is logged.  May be changed
	 * once the server is running via /quote SET LOG.  Either:
	 * L_CRIT, L_ERROR, L_WARN, L_NOTICE, L_TRACE, L_INFO or L_DEBUG
	 */
	log_level = L_INFO;
};

/*
 * class {}:  contains information about classes for users (OLD Y:)
 */
class {
	/* name: the name of the class.  classes are text now */
	name = "users";

	/*
	 * ping_time: how often a client must reply to a PING from the
	 * server before they are dropped.
	 */
	ping_time = 90 seconds;

	/*
	 * number_per_ip: how many local users are allowed to connect
	 * from one IP  (optional)
	 */
	number_per_ip = 2;

	/*
	 * max_local: how many local users are allowed to connect
	 * from one ident@host  (optional)
	 */
	max_local = 2;

	/*
	 * max_global: network-wide limit of users per ident@host  (optional)
	 */
	max_global = 10;

	/*
	 * max_number: the maximum number of users allowed in this class (optional)
	 */
	max_number = 100;

	/*
	 * the following lines are optional and allow you to define
	 * how many users can connect from one /NN subnet
	 */
	cidr_bitlen_ipv4 = 24;
	cidr_bitlen_ipv6 = 120;
	number_per_cidr = 16;

	/*
	 * sendq: the amount of data allowed in a clients queue before
	 * they are dropped.
	 */
	sendq = 100 kbytes;
};

class {
	name = "opers";
	ping_time = 90 seconds;
	number_per_ip = 10;
	max_number = 100;
	sendq = 100kbytes;
};

class {
	name = "server";
	ping_time = 90 seconds;

	/*
	 * ping_warning: how fast a server must reply to a PING before
	 * a warning to opers is generated.
	 */
	ping_warning = 15 seconds;

	/*
	 * connectfreq: only used in server classes.  Specifies the delay
	 * between autoconnecting to servers.
	 */
	connectfreq = 5 minutes;

	/* max number: the amount of servers to autoconnect to */
	max_number = 1;

	/* sendq: servers need a higher sendq as they send more data */
	sendq = 2 megabytes;
};

/*
 * listen {}:  contains information about the ports ircd listens on (OLD P:)
 */
listen {
	/*
	 * port: the specific port to listen on.  If no host is specified
	 * before, it will listen on all available IPs.
	 *
	 * Ports are separated via a comma, a range may be specified using ".."
	 */
	
	/* port: listen on all available IPs, ports 6665 to 6669 */
	port = 6665 .. 6669;

	/*
	 * Listen on 192.168.0.1/6697 with ssl enabled and hidden from STATS P
	 * unless you are an administrator.
	 *
	 * NOTE: The "flags" directive has to come before "port".  Always!
	 */
	flags = hidden, ssl;
	host = "192.168.0.1";
	port = 6697;

	/*
	 * host: set a specific IP/host the ports after the line will listen 
	 * on.  This may be ipv4 or ipv6.
	 */
	host = "1.2.3.4";
	port = 7000, 7001;

	host = "3ffe:1234:a:b:c::d";
	port = 7002;
};

/*
 * auth {}:  allow users to connect to the ircd (OLD I:)
 */
auth {
	/*
	 * user: the user@host allowed to connect.  Multiple IPv4/IPv6 user 
	 * lines are permitted per auth block.
	 */
	user = "*@172.16.0.0/12";
	user = "*test@123D:B567:*";

	/* password: an optional password that is required to use this block */
	password = "letmein";

	/*
	 * encrypted: controls whether the auth password above has been
	 * encrypted.
	 */
	encrypted = yes;

	/*
	 * spoof: fake the users host to this.  This is free-form,
	 * just do everyone a favor and don't abuse it. ('=' prefix on /stats I)
	 */
	spoof = "I.still.hate.packets";

	/* class: the class the user is placed in */
	class = "opers";

	/*
	 * need_password: don't allow users who haven't supplied the correct
	 *                password to connect using another auth{} block
	 *                ('&' prefix on /stats I if disabled)
	 * need_ident:    require the user to have identd to connect ('+' prefix on /stats I)
	 * spoof_notice:  enable spoofing notification to admins
	 * exceed_limit:  allow a user to exceed class limits ('>' prefix on /stats I)
	 * kline_exempt:  exempt this user from k/glines ('^' prefix on /stats I)
	 * gline_exempt:  exempt this user from glines ('_' prefix on /stats I)
	 * resv_exempt:   exempt this user from resvs ('$' prefix on /stats I)
	 * no_tilde:      remove ~ from a user with no ident ('-' prefix on /stats I)
	 * can_flood:     allow this user to exceed flood limits ('|' prefix on /stats I)
	 * can_idle:      exempt this user from idle restrictions ('<' prefix on /stats I)
	 */
	flags = need_password, spoof_notice, exceed_limit, kline_exempt,
		gline_exempt, resv_exempt, no_tilde, can_flood, can_idle;
};

auth {
	/*
	 * redirect: the server and port to redirect a user to.  A user does
	 * not have to obey the redirection, the ircd just suggests an alternative
	 * server for them.
	 */
	redirserv = "this.is.not.a.real.server";
	redirport = 6667;
	
	user = "*.server";

	/* class: a class is required even though it is not used */
	class = "users";
};

auth {
	user = "*@*";
	class = "users";
	flags = need_ident;
};

/*
 * operator {}:  defines ircd operators. (OLD O:)
 *
 * ircd-hybrid no longer supports local operators, privileges are
 * controlled via flags.
 */
operator {
	/* name: the name of the oper */
	/* NOTE: operator "opername"{} is also supported */
	name = "god";

	/*
	 * user: the user@host required for this operator.  CIDR is not
	 * supported.  Multiple user="" lines are supported.
	 */
	user = "*god@*";
	user = "*@127.0.0.1";

	/*
	 * password: the password required to oper.  By default this will
	 * need to be encrypted using 'mkpasswd'.  MD5 is supported.
	 */
	password = "etcnjl8juSU1E";

	/*
	 * encrypted: controls whether the oper password above has been
	 * encrypted.  (OLD CRYPT_OPER_PASSWORD now optional per operator)
	 */
	encrypted = yes;

	/*
	 * rsa_public_key_file: the public key for this oper when using Challenge.
	 * A password should not be defined when this is used, see 
	 * doc/challenge.txt for more information.
	 */
#	rsa_public_key_file = "/usr/local/ircd/etc/oper.pub";

	/* class: the class the oper joins when they successfully /oper */
	class = "opers";

	/*
	 * umodes: default usermodes opers get when they /oper.  If defined,
	 * it will override oper_umodes settings in general {}.
	 * Available usermodes:
	 *
	 * +b - bots         - See bot and drone flooding notices
	 * +c - cconn        - Client connection/quit notices
	 * +D - deaf         - Don't receive channel messages
	 * +d - debug        - See debugging notices
	 * +f - full         - See I: line full notices
	 * +G - softcallerid - Server Side Ignore for users not on your channels
	 * +g - callerid     - Server Side Ignore (for privmsgs etc)
	 * +i - invisible    - Not shown in NAMES or WHO unless you share a
	 *                     a channel
	 * +k - skill        - See server generated KILL messages
	 * +l - locops       - See LOCOPS messages
	 * +n - nchange      - See client nick changes
	 * +r - rej          - See rejected client notices
	 * +s - servnotice   - See general server notices
	 * +u - unauth       - See unauthorized client notices
	 * +w - wallop       - See server generated WALLOPS
	 * +x - external     - See remote server connection and split notices
	 * +y - spy          - See LINKS, STATS, TRACE notices etc.
	 * +z - operwall     - See oper generated WALLOPS
	 */
#	umodes = locops, servnotice, operwall, wallop;

	/*
	 * privileges: controls the activities and commands an oper is 
	 * allowed to do on the server.  All options default to no.
	 * Available options:
	 *
	 * global_kill:  allows remote users to be /KILL'd (OLD 'O' flag)
	 * remote:       allows remote SQUIT and CONNECT   (OLD 'R' flag)
	 * remoteban:    allows remote KLINE/UNKLINE
	 * kline:        allows KILL, KLINE and DLINE      (OLD 'K' flag)
	 * unkline:      allows UNKLINE and UNDLINE        (OLD 'U' flag)
	 * gline:        allows GLINE                      (OLD 'G' flag)
	 * xline:         allows XLINE                     (OLD 'X' flag)
	 * operwall:     allows OPERWALL
	 * nick_changes: allows oper to see nickchanges    (OLD 'N' flag)
	 *               via usermode +n
	 * rehash:       allows oper to REHASH config      (OLD 'H' flag)
	 * die:          allows DIE and RESTART            (OLD 'D' flag)
	 * admin:        gives admin privileges.  admins
	 *               may (un)load modules and see the
	 *               real IPs of servers.
	 * hidden_admin: same as 'admin', but noone can recognize you as
	 *               being an admin
	 * hidden_oper:  not shown in /stats p (except for other operators)
	 */
	/* You can either use
	 * die = yes;
	 * rehash = yes;
	 *
	 * or in a flags statement i.e.
	 * flags = die, rehash;
	 *
	 * You can also negate a flag with ~ i.e.
	 * flags = ~remote;
	 *
	 */
	flags = global_kill, remote, kline, unkline, xline,
		die, rehash, nick_changes, admin, operwall;
};

/*
 * connect {}:  controls servers we connect to (OLD C:, N:, H:, L:)
 */
connect {
	/* name: the name of the server */
	name = "irc.uplink.com";

	/*
	 * host: the host or IP to connect to.  If a hostname is used it
	 * must match the reverse dns of the server.
	 */
	host = "192.168.0.1";

	/*
	 * vhost: the IP to bind to when we connect outward to servers.
	 * serverinfo::vhost and serverinfo::vhost6 will be overridden
	 * by this directive.
	 */
	vhost = "192.168.0.2";

	/*
	 * passwords: the passwords we send (OLD C:) and accept (OLD N:).
	 * The remote server will have these passwords reversed.
	 */
	send_password = "password";
	accept_password = "anotherpassword";

	/*
	 * encrypted: controls whether the accept_password above has been
	 * encrypted.  (OLD CRYPT_LINK_PASSWORD now optional per connect)
	 */
	encrypted = no;

	/* port: the port to connect to this server on */
	port = 6666;

	/*
	 * hub_mask: the mask of servers that this server may hub.  Multiple
	 * entries are permitted
	 */
	hub_mask = "*";

	/*
	 * leaf_mask: the mask of servers this server may not hub.  Multiple
	 * entries are permitted.  Useful for forbidding EU -> US -> EU routes.
	 */
#	leaf_mask = "*.uk";

	/* fakename: the servername we pretend to be when we connect */
#	fakename = "*.arpa";

	/* class: the class this server is in */
	class = "server";

	/*
	 * autoconn:    controls whether we autoconnect to this server or not,
	 *              dependent on class limits.  By default, this is disabled.
	 * compressed:  controls whether traffic is compressed via ziplinks.
	 *              By default, this is disabled
	 * lazylink:    controls whether this server is a LazyLink.  LazyLink 
	 *              servers may NOT hub.  See doc/LazyLinks.txt
	 * cryptlink:   enable full encryption for all data passing between our
	 *              server and this link and rsa authentication.
	 * burst_away:  This will send the /away string that users have set
	 *              on the server burst.  Note this can be a lot of data
	 *              and slow down your server burst.
	 * topicburst:  Send topics to this server during channel burst.  Works
	 *              only if the server we are connecting to is capable
	 *              of TBURST/TB.
	 */
#	flags = autoconn, lazylink, compressed, cryptlink, burst_away, topicburst;
};

connect {
	name = "encrypted.auth.example";
	host = "some.host.somewhere";
	port = 6667;

	flags = cryptlink;

	/*
	 * rsa_public_key_file: the path to the public keyfile of the server.
	 * Used instead of passwords.
	 */
	rsa_public_key_file = "etc/remote.server.keyfile";

	/*
	 * cipher preference: set the preferred cipher for this link
	 *
	 * Available ciphers are:
	 *      BF/168 BF/128 CAST/128 IDEA/128 RC5.16/128 
	 *      RC5.12/128 RC5.8/128 3DES/168 DES/56
	 *
	 * NOTE:  Some ciphers may not be supported by your OpenSSL.
	 *        Check the output from 'configure' for available ciphers.
	 * 
	 * NOTE2: To help you decide what cipher to use, tools/encspeed
	 *        will show you approximately how fast each cipher is.
	 *        However, blowfish is fast and secure, and is probably
	 *        a good default for most situations.
	 *
	 * NOTE3: Default if none is set is BF/128
	 *
	 * The cipher *MUST* be the same in both directions.  If you
	 * set a cipher preference, your uplink must set the same cipher,
	 * else it will not link.
	 */
#	cipher_preference = "BF/168";
};

/*
 * NOTE: Don't add an extra 'name=' entry if you use
 * the connect "name"{} feature
 */
connect "ipv6.some.server" {
	host = "3ffd:dead:beef::1";
	send_password = "password";
	accept_password = "password";
	port = 6666;

	/*
	 * aftype: controls whether the connection uses "ipv4" or "ipv6".
	 * Default is ipv4.
	 */
	aftype = ipv6;
	class = "server";
};

/*
 * cluster {}:  servers that share klines/unkline/xline/unxline/resv/unresv/locops
 * automatically (OLD hyb6 SLAVE_SERVERS)
 */
cluster {
	/*
	 * name: the server to share with, this can take wildcards
	 *
	 * NOTE: only local actions will be clustered, meaning if
	 *       the server receives a shared kline/unkline/etc, it
	 *       will not be propagated to clustered servers.
	 *
	 *       Remote servers are not necessarily required to accept
	 *       clustered lines, they need a shared{} for *THIS* server
	 *       in order to accept them.
	 */
	name = "*.arpa";

	/*
	 * type: list of what to share, options are as follows:
	 *	kline	- share klines
	 *	tkline	- share temporary klines
	 * 	unkline	- share unklines
	 * 	xline	- share xlines
	 * 	txline	- share temporary xlines
	 * 	unxline	- share unxlines
	 * 	resv	- share resvs
	 * 	tresv	- share temporary resvs
	 *	unresv	- share unresvs
	 *	locops	- share locops
	 *	all	- share all of the above (default)
	 */
	type = kline, unkline, locops, xline, resv;
};

/*
 * shared {}: users that are allowed to remote kline (OLD U:)
 *
 * NOTE: This can be effectively used for remote klines.
 *       Please note that there is no password authentication
 *       for users setting remote klines.  You must also be
 *       /oper'd in order to issue a remote kline.
 */
shared {
	/*
	 * name: the server the user must be on to set klines.  If this is not
	 * specified, the user will be allowed to kline from all servers.
	 */
	name = "irc2.some.server";

	/*
	 * user: the user@host mask that is allowed to set klines.  If this is
	 * not specified, all users on the server above will be allowed to set
	 * a remote kline.
	 */
	user = "oper@my.host.is.spoofed";

	/*
	 * type: list of what to share, options are as follows:
	 *	kline	- allow oper/server to kline
	 *	tkline	- allow temporary klines
	 *	unkline	- allow oper/server to unkline
	 *	xline	- allow oper/server to xline
	 * 	txline	- allow temporary xlines
	 *	unxline	- allow oper/server to unxline
	 *	resv	- allow oper/server to resv
	 * 	tresv	- allow temporary resvs
	 *	unresv	- allow oper/server to unresv
	 *      locops  - allow oper/server to locops - only used for servers that cluster
	 *	all	- allow oper/server to do all of the above (default)
	 */
	type = kline, unkline, resv;
};

/*
 * kill {}:  users that are not allowed to connect (OLD K:)
 * Oper issued klines will be added to the specified kline config
 */
kill {
	user = "bad@*.hacked.edu";
	reason = "Obviously hacked account";
};

kill {
	user = "^O[[:alpha:]]?[[:digit:]]+(x\.o|\.xo)$@^[[:alnum:]]{4}\.evilnet.org$";
	type = regex;
};

/*
 * deny {}:  IPs that are not allowed to connect (before DNS/ident lookup)
 * Oper issued dlines will be added to the specified dline config
 */
deny {
	ip = "10.0.1.0/24";
	reason = "Reconnecting vhosted bots";
};

/*
 * exempt {}: IPs that are exempt from deny {} and Dlines. (OLD d:)
 */
exempt {
	ip = "192.168.0.0/16";
};

/*
 * resv {}:  nicks and channels users may not use/join (OLD Q:)
 */
resv {
	/* reason: the reason for the proceeding resv's */
	reason = "There are no services on this network";

	/* resv: the nicks and channels users may not join/use */
	nick = "nickserv";
	nick = "chanserv";
	channel = "#services";

	/* resv: wildcard masks are also supported in nicks only */
	reason = "Clone bots";
	nick = "clone*";
};

/*
 * gecos {}:  The X: replacement, used for banning users based on
 * their "realname".
 */
gecos {
	name = "*sex*";
	reason = "Possible spambot";
};

gecos {
	name = "sub7server";
	reason = "Trojan drone";
};

gecos {
	name = "*http*";
	reason = "Spambot";
};

gecos {
	name = "^\[J[0o]hn Do[3e]\]-[0-9]{2,5}$";
	type = regex;
};

/*
 * channel {}:  The channel block contains options pertaining to channels
 */
channel {
	/*
	 * disable_fake_channels: this option, if set to 'yes', will
	 * disallow clients to create or join channels that have one
	 * of the following ASCII characters in their name:
	 *
	 *   2 | bold
	 *   3 | mirc color
         *  15 | plain text
	 *  22 | reverse
	 *  31 | underline
	 * 160 | non-breaking space
	 */
	disable_fake_channels = yes;

	/*
	 * restrict_channels: reverse channel RESVs logic, only reserved
	 * channels are allowed
	 */
	restrict_channels = no;

	/*
	 * disable_local_channels: prevent users from joining &channels.
	 */
	disable_local_channels = no;

	/*
	 * use_invex: Enable/disable channel mode +I, a n!u@h list of masks
	 * that can join a +i channel without an invite.
	 */
	use_invex = yes;

	/*
	 * use_except: Enable/disable channel mode +e, a n!u@h list of masks
	 * that can join a channel through a ban (+b).
	 */
	use_except = yes;

	/*
	 * use_knock: Allows users to request an invite to a channel that
	 * is locked somehow (+ikl).  If the channel is +p or you are banned
	 * the knock will not be sent.
	 */
	use_knock = yes;

	/*
	 * knock_delay: The amount of time a user must wait between issuing
	 * the knock command.
	 */
	knock_delay = 1 minutes;

	/*
	 * knock_delay_channel: How often a knock to any specific channel
	 * is permitted, regardless of the user sending the knock.
	 */
	knock_delay_channel = 1 minute;

	/*
	 * burst_topicwho: enable sending of who set topic on topicburst
	 * default is yes
	 */
	burst_topicwho = yes;

	/*
	 * max_chans_per_user: The maximum number of channels a user can
	 * join/be on.
	 */
	max_chans_per_user = 25;

	/* quiet_on_ban: stop banned people talking in channels. */
	quiet_on_ban = yes;

	/* max_bans: maximum number of +b/e/I modes in a channel */
	max_bans = 25;

	/*
	 * how many joins in how many seconds constitute a flood, use 0 to
	 * disable. +b opers will be notified (changeable via /set)
	 */
	join_flood_count = 16;
	join_flood_time = 8 seconds;

	/*
	 * splitcode: The ircd will now check splitmode every few seconds.
	 *
	 * Either split users or split servers can activate splitmode, but
	 * both conditions must be met for the ircd to deactivate splitmode.
	 * 
	 * You may force splitmode to be permanent by /quote set splitmode on
	 */

	/*
	 * default_split_user_count: when the usercount is lower than this level,
	 * consider ourselves split.  This must be set for automatic splitmode.
	 */
	default_split_user_count = 0;

	/*
	 * default_split_server_count: when the servercount is lower than this,
	 * consider ourselves split.  This must be set for automatic splitmode.
	 */
	default_split_server_count = 0;

	/* split no create: disallow users creating channels on split. */
	no_create_on_split = yes;

	/* split: no join: disallow users joining channels at all on a split */
	no_join_on_split = no;
};

/*
 * serverhide {}:  The serverhide block contains the options regarding
 * serverhiding
 */
serverhide {
	/*
	 * flatten_links: this option will show all servers in /links appear
	 * that they are linked to this current server
	 */
	flatten_links = no;

	/*
	 * links_delay: how often to update the links file when it is
	 * flattened.
	 */
	links_delay = 5 minutes;

	/*
	 * hidden: hide this server from a /links output on servers that
	 * support it.  This allows hub servers to be hidden etc.
	 */
	hidden = no;

	/*
	 * disable_hidden: prevent servers hiding themselves from a
	 * /links output.
	 */
	disable_hidden = no;

	/*
	 * hide_servers: hide remote servernames everywhere and instead use
	 * hidden_name and network_desc.
	 */
	hide_servers = no;

	/*
	 * Use this as the servername users see if hide_servers = yes.
	 */
	hidden_name = "*.hidden.com";

	/*
	 * hide_server_ips: If this is disabled, opers will be unable to see servers
	 * ips and will be shown a masked ip, admins will be shown the real ip.
	 *
	 * If this is enabled, nobody can see a servers ip.  *This is a kludge*, it
	 * has the side effect of hiding the ips everywhere, including logfiles.
	 *
	 * We recommend you leave this disabled, and just take care with who you
	 * give admin=yes; to.
	 */
	hide_server_ips = no;
};

/*
 * general {}:  The general block contains many of the options that were once
 * compiled in options in config.h.  The general block is read at start time.
 */
general {
	/*
	 * gline_min_cidr: the minimum required length of a CIDR bitmask
	 * for IPv4 based glines
	 */
	gline_min_cidr = 16;

	/*
	 * gline_min_cidr6: the minimum required length of a CIDR bitmask
	 * for IPv6 based glines
	 */
	gline_min_cidr6 = 48;

	/*
	 * Whether to automatically set mode +i on connecting users.
	 */
	invisible_on_connect = yes;

	/*
	 * If you don't explicitly specify burst_away in your connect blocks, then
	 * they will default to the burst_away value below.
	 */
	burst_away = no;

	/*
	 * Show "actually using host <ip>" on /whois when possible.
	 */
	use_whois_actually = yes;

	/*
	 * Max time from the nickname change that still causes KILL
	 * automatically to switch for the current nick of that user. (seconds)
	 */
	kill_chase_time_limit = 90;

	/*
	 * If hide_spoof_ips is disabled, opers will be allowed to see the real IP of spoofed
	 * users in /trace etc.  If this is defined they will be shown a masked IP.
	 */
	hide_spoof_ips = yes;

	/*
	 * Ignore bogus timestamps from other servers.  Yes, this will desync
	 * the network, but it will allow chanops to resync with a valid non TS 0
	 *
	 * This should be enabled network wide, or not at all.
	 */
	ignore_bogus_ts = no;

	/*
	 * disable_auth: completely disable ident lookups; if you enable this,
	 * be careful of what you set need_ident to in your auth {} blocks
	 */
	disable_auth = no;

	/* disable_remote_commands: disable users doing commands on remote servers */
	disable_remote_commands = no;

	/*
	 * tkline_expire_notices: enables or disables temporary kline/xline
	 * expire notices.
	 */
	tkline_expire_notices = no;

	/*
	 * default_floodcount: the default value of floodcount that is configurable
	 * via /quote set floodcount.  This is the amount of lines a user
	 * may send to any other user/channel in one second.
	 */
	default_floodcount = 10;

	/*
	 * failed_oper_notice: send a notice to all opers on the server when 
	 * someone tries to OPER and uses the wrong password, host or ident.
	 */
	failed_oper_notice = yes;

	/*
	 * dots_in_ident: the amount of '.' characters permitted in an ident
	 * reply before the user is rejected.
	 */
	dots_in_ident = 2;

	/*
	 * dot_in_ip6_addr: ircd-hybrid-6.0 and earlier will disallow hosts 
	 * without a '.' in them.  This will add one to the end.  Only needed
	 * for older servers.
	 */
	dot_in_ip6_addr = no;

	/*
	 * min_nonwildcard: the minimum non wildcard characters in k/d/g lines
	 * placed via the server.  klines hand placed are exempt from limits.
	 * wildcard chars: '.' ':' '*' '?' '@' '!' '#'
	 */
	min_nonwildcard = 4;

	/*
	 * min_nonwildcard_simple: the minimum non wildcard characters in 
	 * gecos bans.  wildcard chars: '*' '?' '#'
	 */
	min_nonwildcard_simple = 3;

	/* max_accept: maximum allowed /accept's for +g usermode */
	max_accept = 20;

	/* anti_nick_flood: enable the nickflood control code */
	anti_nick_flood = yes;

	/* nick flood: the nick changes allowed in the specified period */
	max_nick_time = 20 seconds;
	max_nick_changes = 5;

	/*
	 * anti_spam_exit_message_time: the minimum time a user must be connected
	 * before custom quit messages are allowed.
	 */
	anti_spam_exit_message_time = 5 minutes;

	/*
	 * ts delta: the time delta allowed between server clocks before
	 * a warning is given, or before the link is dropped.  all servers
	 * should run ntpdate/rdate to keep clocks in sync
	 */
	ts_warn_delta = 30 seconds;
	ts_max_delta = 5 minutes;

	/*
	 * kline_with_reason: show the user the reason why they are k/d/glined 
	 * on exit.  May give away who set k/dline when set via tcm.
	 */
	kline_with_reason = yes;

	/*
	 * kline_reason: show this message to users on channel
	 * instead of the oper reason.
	 */
	kline_reason = "Connection closed";

	/*
	 * reject_hold_time: wait this amount of time before disconnecting
	 * a rejected client. Use 0 to disable.
	 */
	reject_hold_time = 0;

	/*
	 * warn_no_nline: warn opers about servers that try to connect but
	 * we don't have a connect {} block for.  Twits with misconfigured 
	 * servers can get really annoying with this enabled.
	 */
	warn_no_nline = yes;

	/*
	 * stats_e_disabled: set this to 'yes' to disable "STATS e" for both
	 * operators and administrators.  Doing so is a good idea in case
	 * there are any exempted (exempt{}) server IPs you don't want to
	 * see leaked.
	 */
	stats_e_disabled = no;

	/* stats_o_oper only: make stats o (opers) oper only */
	stats_o_oper_only = yes;

	/* stats_P_oper_only: make stats P (ports) oper only */
	stats_P_oper_only = yes;

	/*
	 * stats i oper only: make stats i (auth {}) oper only. set to:
	 *     yes:    show users no auth blocks, made oper only.
	 *     masked: show users first matching auth block
	 *     no:     show users all auth blocks.
	 */
	stats_i_oper_only = yes;

	/*
	 * stats_k_oper_only: make stats k/K (klines) oper only.  set to:
	 *     yes:    show users no auth blocks, made oper only
	 *     masked: show users first matching auth block
	 *     no:     show users all auth blocks.
	 */
	stats_k_oper_only = yes;

	/*
	 * caller_id_wait: time between notifying a +g user that somebody
	 * is messaging them.
	 */
	caller_id_wait = 1 minute;

	/*
	 * opers_bypass_callerid: allows operators to bypass +g and message
	 * anyone who has it set (useful if you use services).
	 */
	opers_bypass_callerid = no;

	/*
	 * pace_wait_simple: time between use of less intensive commands
	 * (ADMIN, HELP, (L)USERS, VERSION, remote WHOIS)
	 */
	pace_wait_simple = 1 second;

	/*
	 * pace_wait: time between more intensive commands
	 * (INFO, LINKS, LIST, MAP, MOTD, STATS, WHO, wildcard WHOIS, WHOWAS)
	 */
	pace_wait = 10 seconds;

	/*
	 * short_motd: send clients a notice telling them to read the motd
	 * instead of forcing a motd to clients who may simply ignore it.
	 */
	short_motd = no;

	/*
	 * ping_cookie: require clients to respond exactly to a ping command,
	 * can help block certain types of drones and FTP PASV mode spoofing.
	 */
	ping_cookie = no;

	/* no_oper_flood: increase flood limits for opers. */
	no_oper_flood = yes;

	/*
	 * true_no_oper_flood: completely eliminate flood limits for opers
	 * and for clients with can_flood = yes in their auth {} blocks
	 */
	true_no_oper_flood = yes;

	/* oper_pass_resv: allow opers to over-ride RESVs on nicks/channels */
	oper_pass_resv = yes;

	/*
	 * idletime: the maximum amount of time a user may idle before
	 * they are disconnected
	 */
	idletime = 0;

	/* REMOVE ME.  The following line checks you've been reading. */
	havent_read_conf = 1;

	/*
	 * max_targets: the maximum amount of targets in a single 
	 * PRIVMSG/NOTICE.  Set to 999 NOT 0 for unlimited.
	 */
	max_targets = 4;

	/*
	 * client_flood: maximum amount of data in a clients queue before
	 * they are dropped for flooding.
	 */
	client_flood = 2560 bytes;

	/*
	 * message_locale: the default message locale
	 * Use "standard" for the compiled in defaults.
	 * To install the translated messages, go into messages/ in the
	 * source directory and run `make install'.
	 */
	message_locale = "standard";

	/*
	 * usermodes configurable: a list of usermodes for the options below
	 *
	 * +b - bots         - See bot and drone flooding notices
	 * +c - cconn        - Client connection/quit notices
	 * +D - deaf         - Don't receive channel messages
	 * +d - debug        - See debugging notices
	 * +f - full         - See I: line full notices
	 * +G - softcallerid - Server Side Ignore for users not on your channels
	 * +g - callerid     - Server Side Ignore (for privmsgs etc)
	 * +i - invisible    - Not shown in NAMES or WHO unless you share a 
	 *                     a channel
	 * +k - skill        - See server generated KILL messages
	 * +l - locops       - See LOCOPS messages
	 * +n - nchange      - See client nick changes
	 * +r - rej          - See rejected client notices
	 * +s - servnotice   - See general server notices
	 * +u - unauth       - See unauthorized client notices
	 * +w - wallop       - See server generated WALLOPS
	 * +x - external     - See remote server connection and split notices
	 * +y - spy          - See LINKS, STATS, TRACE notices etc.
	 * +z - operwall     - See oper generated WALLOPS
	 */

	/* oper_only_umodes: usermodes only opers may set */
	oper_only_umodes = bots, cconn, cconn_full, debug, full, skill,
                           nchange, rej, spy, external, operwall,
                           locops, unauth;

	/* oper_umodes: default usermodes opers get when they /oper */
	oper_umodes = bots, locops, servnotice, operwall, wallop;

	/*
	 * servlink_path: path to 'servlink' program used by ircd to handle
	 * encrypted/compressed server <-> server links.
	 *
	 * only define if servlink is not in same directory as ircd itself.
	 */
	#servlink_path = "/usr/local/ircd/bin/servlink";

	/*
	 * default_cipher_preference: default cipher to use for cryptlink when none is
	 * specified in connect block.
	 */
	#default_cipher_preference = "BF/168";

	/*
	 * use_egd: if your system does not have *random devices yet you
	 * want to use OpenSSL and encrypted links, enable this.  Beware -
	 * EGD is *very* CPU intensive when gathering data for its pool
	 */
#	use_egd = yes;

	/*
	 * egdpool_path: path to EGD pool. Not necessary for OpenSSL >= 0.9.7
	 * which automatically finds the path.
	 */
#	egdpool_path = "/var/run/egd-pool";


	/*
	 * compression_level: level of compression for compressed links between
	 * servers.  
	 *
	 * values are between: 1 (least compression, fastest)
	 *                and: 9 (most compression, slowest).
	 */
#	compression_level = 6;

	/*
	 * throttle_time: the minimum amount of time between connections from
	 * the same ip.  exempt {} blocks are excluded from this throttling.
	 * Offers protection against flooders who reconnect quickly.  
	 * Set to 0 to disable.
	 */
	throttle_time = 10;
};

glines {
	/* enable: enable glines, network wide temp klines */
	enable = yes;

	/*
	 * duration: the amount of time a gline will remain on your
	 * server before expiring
	 */
	duration = 1 day;

	/*
	 * logging: which types of rules you want to log when triggered
	 * (choose reject or block)
	 */
	logging = reject, block;

	/*
	 * NOTE: gline ACLs can cause a desync of glines throughout the
	 * network, meaning some servers may have a gline triggered, and
	 * others may not. Also, you only need insert rules for glines
	 * that you want to block and/or reject. If you want to accept and
	 * propagate the gline, do NOT put a rule for it.
	 */

	/* user@host for rule to apply to */
	user = "god@I.still.hate.packets";
	/* server for rule to apply to */
	name = "hades.arpa";

	/*
	 * action: action to take when a matching gline is found. options are:
	 *  reject	- do not apply the gline locally
	 *  block	- do not propagate the gline
	 */
	action = reject, block;

	user = "god@*";
	name = "*";
	action = block;
};

modules {
	/*
	 * module path: other paths to search for modules specified below
	 * and in /modload.
	 */
	path = "/usr/local/ircd/modules";
	path = "/usr/local/ircd/modules/autoload";

	/* module: the name of a module to load on startup/rehash */
	#module = "some_module.so";
};
