ViewVC Help

View File | Revision Log | Show Annotations | View Changeset | Root Listing

root/svn/ircd-hybrid/trunk/doc/reference.conf

Comparing ircd-hybrid-8/doc/example.conf (file contents):
Revision 1351 by michael, Thu Apr 12 22:56:05 2012 UTC vs.
Revision 1534 by michael, Sun Sep 23 13:17:14 2012 UTC

#	Line 3 | Line 3
3		*
4		* Written by ejb, wcampbel, db, leeh and others
5		* Other example configurations can be found in the source dir under
6	<	* etc/.
6	>	* doc/.
7		*
8		* $Id$
9		*/
#	Line 56 | Line 56 | serverinfo {
56		sid = "_CHANGE_ME_";
57
58		/*
59	<	* description: the description of the server.  '[' and ']' may not
60	<	* be used here for compatibility with older servers.
59	>	* description: the description of the server.
60		*/
61	<	description = "hybrid-7 test server";
61	>	description = "ircd-hybrid test server";
62
63		/*
64		* network info: the name and description of the network this server
#	Line 124 | Line 123 | serverinfo {
123		*/
124		#ssl_certificate_file = "/usr/local/ircd/etc/cert.pem";
125
127	–
126		/*
127		* ssl_dh_param_file:
128		*
#	Line 136 | Line 134 | serverinfo {
134		*
135		*      openssl dhparam -out dhparam.pem 1024
136		*
137	<	* Further information regarding specific OpenSSL dhparam
138	<	* command-line options can be found in the OpenSSL manual.
137	>	* Prime size must be at least 1024 bits. Further information
138	>	* regarding specific OpenSSL dhparam command-line options
139	>	* can be found in the OpenSSL manual.
140		*/
141		#ssl_dh_param_file = "/usr/local/ircd/etc/dhparam.pem";
142
143		/*
144		* ssl_cipher_list:
145		*
146	<	* List of ciphers that are supported by _this_ server. Can be used to enforce
147	<	* specific ciphers for incoming SSL/TLS connections.
148	<	* If a client (which also includes incoming server connections) isn't capable
149	<	* of any cipher listed below, the connection will simply be rejected.
150	<	*
146	>	* List of ciphers that are supported by _this_ server. Can be used to
147	>	* enforce specific ciphers for incoming SSL/TLS connections.
148	>	* If a client (which also includes incoming server connections) isn't
149	>	* capable of any cipher listed below, the connection will simply be
150	>	* rejected.
151		* A list of supported ciphers can be obtained by running:
152		*
153		*      openssl ciphers -ssl3 -tls1 -v
154		*
155	<	* Multiple ciphers are separated by colons. The order of preference is from
156	<	* left to right.
155	>	* Multiple ciphers are separated by colons. The order of preference is
156	>	* from left to right.
157		*/
158		#ssl_cipher_list = "DHE-RSA-AES256-SHA:AES256-SHA";
159
#	Line 162 | Line 161 | serverinfo {
161		* ssl_server_method:
162		* ssl_client_method:
163		*
164	<	* SSL/TLS protocols we provide for incoming secure connections.
164	>	* SSL/TLS methods we provide for incoming (server method) and
165	>	* outgoing (client method) SSL/TLS connections.
166		* This can be either sslv3 for SSLv3, and/or tlsv1 for TLSv1.
167	–	* SSLv2 is not suppported.
167		*/
168		#ssl_server_method = tlsv1, sslv3;
169		#ssl_client_method = tlsv1;
#	Line 183 | Line 182 | admin {
182		* class {}:  contains information about classes for users
183		*/
184		class {
185	<	/* name: the name of the class.  classes are text now */
185	>	/* name: the name of the class */
186		name = "users";
187
188		/*
#	Line 227 | Line 226 | class {
226		* they are dropped.
227		*/
228		sendq = 100 kbytes;
229	+
230	+	/*
231	+	* recvq: maximum amount of data in a clients queue before they
232	+	* are dropped for flooding. Defaults to 2560 if the chosen
233	+	* value isn't within the range of 512 to 8000.
234	+	*/
235	+	recvq = 2560 bytes;
236		};
237
238		class {
#	Line 234 | Line 240 | class {
240		ping_time = 90 seconds;
241		number_per_ip = 10;
242		max_number = 100;
243	<	sendq = 100kbytes;
243	>	sendq = 100 kbytes;
244		};
245
246		class {
#	Line 421 | Line 427 | operator {
427		* +C - cconn_full   - Client connection/quit notices full
428		* +D - deaf         - Don't receive channel messages
429		* +d - debug        - See debugging notices
430	<	* +f - full         - See I: line full notices
430	>	* +f - full         - See auth{} block full notices
431		* +G - softcallerid - Server Side Ignore for users not on your channels
432		* +g - callerid     - Server Side Ignore (for privmsgs etc)
433		* +H - hidden       - Hides operator status to other users
#	Line 445 | Line 451 | operator {
451		* allowed to do on the server. All options default to no.
452		* Available options:
453		*
454	<	* module       - allows MODLIST, MODRESTART, MODLOAD, MODUNLOAD
454	>	* module       - allows MODULE
455		* global_kill  - allows remote users to be /KILL'd
456		* remote       - allows remote SQUIT and CONNECT
457		* remoteban    - allows remote KLINE/UNKLINE
#	Line 461 | Line 467 | operator {
467		* rehash       - allows oper to REHASH config
468		* die          - allows DIE
469		* restart      - allows RESTART
470	+	* set          - allows SET
471		* admin        - gives admin privileges. admins for example,
472		*                may see the real IP addresses of servers.
473		*/
#	Line 524 | Line 531 | connect {
531		/* class: the class this server is in */
532		class = "server";
533
534	+	/*
535	+	* ssl_cipher_list:
536	+	*
537	+	* List of ciphers that the server we are connecting to must support.
538	+	* If the server isn't capable of any cipher listed below, the
539	+	* connection will simply be rejected.
540	+	* Can be used to enforce stronger ciphers, even though this option
541	+	* is not necessarily required to establish a SSL/TLS connection.
542	+	*
543	+	* Multiple ciphers are separated by colons. The order of preference
544	+	* is from left to right.
545	+	*/
546		#ssl_cipher_list = "DHE-RSA-AES256-SHA:AES256-SHA";
547
548		/*
549		* autoconn   - controls whether we autoconnect to this server or not,
550		*              dependent on class limits. By default, this is disabled.
532	–	* burst_away - This will send the /away string that users have set
533	–	*              on the server burst. Note this can be a lot of data
534	–	*              and slow down your server burst.
535	–	* topicburst - Send topics to this server during channel burst. Works
536	–	*              only if the server we are connecting to is capable
537	–	*              of TBURST/TB.
551		* ssl        - Initiates a TLS/SSL connection.
552		*/
553	<	#       flags = autoconn, burst_away, topicburst;
553	>	#       flags = autoconn, ssl;
554		};
555
556		connect {
#	Line 672 | Line 685 | resv {
685		/* resv: the nicks and channels users may not join/use */
686		nick = "Global";
687		nick = "DevNull";
688	+	nick = "BotServ";
689		nick = "Services";
690		nick = "StatServ";
691	+	nick = "HelpServ";
692		nick = "HostServ";
693		nick = "NickServ";
694		nick = "ChanServ";
#	Line 728 | Line 743 | channel {
743		*   3 | mirc color
744		*  15 | plain text
745		*  22 | reverse
746	+	*  29 | italic
747		*  31 | underline
748		* 160 | non-breaking space
749		*/
#	Line 740 | Line 756 | channel {
756		restrict_channels = no;
757
758		/*
743	–	* disable_local_channels: prevent users from joining &channels.
744	–	*/
745	–	disable_local_channels = no;
746	–
747	–	/*
748	–	* use_invex: Enable/disable channel mode +I, a n!u@h list of masks
749	–	* that can join a +i channel without an invite.
750	–	*/
751	–	use_invex = yes;
752	–
753	–	/*
754	–	* use_except: Enable/disable channel mode +e, a n!u@h list of masks
755	–	* that can join a channel through a ban (+b).
756	–	*/
757	–	use_except = yes;
758	–
759	–	/*
760	–	* use_knock: Allows users to request an invite to a channel that
761	–	* is locked somehow (+ikl).  If the channel is +p or you are banned
762	–	* the knock will not be sent.
763	–	*/
764	–	use_knock = yes;
765	–
766	–	/*
759		* knock_delay: The amount of time a user must wait between issuing
760		* the knock command.
761		*/
#	Line 776 | Line 768 | channel {
768		knock_delay_channel = 1 minute;
769
770		/*
771	<	* burst_topicwho: enable sending of who set topic on topicburst
772	<	* default is yes
771	>	* max_chans_per_user: The maximum number of channels a user can
772	>	* join/be on.
773		*/
774	<	burst_topicwho = yes;
774	>	max_chans_per_user = 25;
775
776		/*
777	<	* max_chans_per_user: The maximum number of channels a user can
777	>	* max_chans_per_oper: The maximum number of channels an oper can
778		* join/be on.
779		*/
780	<	max_chans_per_user = 25;
780	>	max_chans_per_oper = 50;
781
782		/* quiet_on_ban: stop banned people talking in channels. */
783		quiet_on_ban = yes;
784
785		/* max_bans: maximum number of +b/e/I modes in a channel */
786	<	max_bans = 25;
786	>	max_bans = 100;
787
788		/*
789		* how many joins in how many seconds constitute a flood, use 0 to
#	Line 852 | Line 844 | serverhide {
844		hidden = no;
845
846		/*
855	–	* disable_hidden: prevent servers hiding themselves from a
856	–	* /links output.
857	–	*/
858	–	disable_hidden = no;
859	–
860	–	/*
847		* hide_servers: hide remote servernames everywhere and instead use
848		* hidden_name and network_desc.
849		*/
#	Line 894 | Line 880 | general {
880		/* max_watch: maximum WATCH entries a client can have. */
881		max_watch = 60;
882
883	+	/* gline_enable: enable glines, network wide temp klines */
884	+	gline_enable = yes;
885	+
886	+	/*
887	+	* gline_duration: the amount of time a gline will remain on your
888	+	* server before expiring
889	+	*/
890	+	gline_duration = 1 day;
891	+
892	+	/*
893	+	* gline_request_duration:  how long a pending G-line can be around.
894	+	* 10 minutes should be plenty
895	+	*/
896	+	gline_request_duration = 10 minutes;
897	+
898		/*
899		* gline_min_cidr: the minimum required length of a CIDR bitmask
900		* for IPv4 based glines
#	Line 1083 | Line 1084 | general {
1084
1085		/*
1086		* pace_wait: time between more intensive commands
1087	<	* (INFO, LINKS, LIST, MAP, MOTD, STATS, WHO, wildcard WHOIS, WHOWAS)
1087	>	* (AWAY, INFO, LINKS, MAP, MOTD, STATS, WHO, wildcard WHOIS, WHOWAS)
1088		*/
1089		pace_wait = 10 seconds;
1090
#	Line 1121 | Line 1122 | general {
1122		max_targets = 4;
1123
1124		/*
1124	–	* client_flood: maximum amount of data in a clients queue before
1125	–	* they are dropped for flooding.
1126	–	*/
1127	–	client_flood = 2560 bytes;
1128	–
1129	–	/*
1125		* message_locale: the default message locale
1126		* Use "standard" for the compiled in defaults.
1127		* To install the translated messages, go into messages/ in the
#	Line 1142 | Line 1137 | general {
1137		* +C - cconn_full   - Client connection/quit notices full
1138		* +D - deaf         - Don't receive channel messages
1139		* +d - debug        - See debugging notices
1140	<	* +f - full         - See I: line full notices
1140	>	* +f - full         - See auth{} block full notices
1141		* +G - softcallerid - Server Side Ignore for users not on your channels
1142		* +g - callerid     - Server Side Ignore (for privmsgs etc)
1143		* +H - hidden       - Hides operator status to other users
#	Line 1190 | Line 1185 | general {
1185		throttle_time = 10;
1186		};
1187
1193	–	glines {
1194	–	/* enable: enable glines, network wide temp klines */
1195	–	enable = yes;
1196	–
1197	–	/*
1198	–	* duration: the amount of time a gline will remain on your
1199	–	* server before expiring
1200	–	*/
1201	–	duration = 1 day;
1202	–
1203	–	/*
1204	–	* log: which types of rules you want to log when triggered
1205	–	* (choose reject or block)
1206	–	*/
1207	–	log = reject, block;
1208	–
1209	–	/*
1210	–	* NOTE: gline ACLs can cause a desync of glines throughout the
1211	–	* network, meaning some servers may have a gline triggered, and
1212	–	* others may not. Also, you only need insert rules for glines
1213	–	* that you want to block and/or reject. If you want to accept and
1214	–	* propagate the gline, do NOT put a rule for it.
1215	–	*/
1216	–
1217	–	/* user@host for rule to apply to */
1218	–	user = "god@I.still.hate.packets";
1219	–	/* server for rule to apply to */
1220	–	name = "hades.arpa";
1221	–
1222	–	/*
1223	–	* action: action to take when a matching gline is found. options are:
1224	–	*  reject - do not apply the gline locally
1225	–	*  block  - do not propagate the gline
1226	–	*/
1227	–	action = reject, block;
1228	–
1229	–	user = "god@*";
1230	–	name = "*";
1231	–	action = block;
1232	–	};
1233	–
1188		modules {
1189		/*
1190		* path: other paths to search for modules specified below
1191	<	* and in /modload.
1191	>	* and in "/module load".
1192		*/
1193		path = "/usr/local/ircd/lib/ircd-hybrid/modules";
1194		path = "/usr/local/ircd/lib/ircd-hybrid/modules/autoload";

Diff Legend

–	Removed lines
+	Added lines
<	Changed lines (old)
>	Changed lines (new)