ViewVC Help

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

root/svn/ircd-hybrid/trunk/INSTALL

Comparing:
ircd-hybrid-7.2/INSTALL (file contents), Revision 920 by michael, Thu Nov 8 07:46:34 2007 UTC vs.
ircd-hybrid/trunk/INSTALL (file contents), Revision 1663 by michael, Sat Nov 17 20:25:02 2012 UTC

#	Line 2 | Line 2
2
3		$Id$
4
5	<	Copyright (c) 1997-2007 IRCD-Hybrid Development Team
5	>	Copyright (c) 1997-2012 IRCD-Hybrid Development Team
6
7		----------------------------------------------------------------------
8
#	Line 15 | Line 15
15		| - You now need to ./configure --prefix="/path/to/install/it" as a      |
16		|   minimum. Try ./configure --help or read this file for more info on   |
17		|   the possible options you can pass to configure.                      |
18	–	|                                                                        |
19	–	| - Important: The old config format WILL NOT WORK. Please see point 7!  |
18		+------------------------------------------------------------------------+
19
20		***** EFNET NOTE *****
21	<	You should run ./configure with the option '--enable-efnet' to tweak
24	<	some options to be EFNet based.  You must also use the example.efnet.conf
25	<	instead of example.conf.
21	>	You should use the example.efnet.conf instead of example.conf.
22		**********************
23
24		----------------------------------------------------------------------
#	Line 34 | Line 30
30		ircd-hybrid.
31
32		1.  Read the NEWS file to find out about the exciting new features in
33	<	this version. Other good reads are BUGS, etc/example.conf, and
34	<	README.FIRST.
39	<
40	<	An example.conf for EFnet is in etc/ with the values "approved" as of
41	<	October 12th, 2003 called example.efnet.conf.
33	>	this version. Other good reads are BUGS, doc/example.conf, and
34	>	README.
35
36		2.  Run the configure script. It will create config.h and the
37	<	Makefiles to match your system. In hybrid-7, the paths are now handled
37	>	Makefiles to match your system. The paths are now handled
38		with the --prefix option to configure.
39		/usr/local/ircd is the default if no prefix is specified.
40
#	Line 52 | Line 45
45		undefined results:
46
47		* --enable-kqueue - Use the superior kqueue(2) system call as
48	<	opposed to the default poll(2).  This is currently only available
48	>	opposed to the default poll(2). This is currently only available
49		on FreeBSD 4.1 or higher.
50
51		* --enable-devpoll - Enable the superior /dev/poll support on
52	<	Solaris.  Linux /dev/poll is broken and will not work with this
52	>	Solaris. Linux /dev/poll is broken and will not work with this
53		option.
54
55	<	* --enable-epoll - Enables epoll(4) Signal I/O system.  This is
55	>	* --enable-epoll - Enables epoll(4) Signal I/O system. This is
56		currently only available on 2.5.44 Linux kernel versions or
57		later.
58
59		* --enable-rtsigio - Enable the superior Linux RealTime Signal I/O
60	<	system.  This is currently only available on 2.4 Linux kernel
60	>	system. This is currently only available on 2.4 Linux kernel
61		versions or later.
62
63	<	* --enable-poll - Use POSIX poll(2).
63	>	* --enable-poll - Use POSIX poll(2).
64
65	<	* --enable-select - Use POSIX select(2).
65	>	* --enable-select - Use POSIX select(2).
66
67	<	Incidentally, the order of listing above is the order of auto-
68	<	detection in configure.  So if you do have kqueue but wish to
69	<	enable select(2) instead (bad idea), you must use --enable-select.
67	>	Incidentally, the order of listing above is the order of auto-
68	>	detection in configure. So if you do have kqueue but wish to
69	>	enable select(2) instead (bad idea), you must use --enable-select.
70
71		* --enable-openssl - Enable the openssl dependent crypto functions.
72	<	This will allow CHALLENGE to work and encrypted links. On systems
73	<	where the configure script can automatically detect OpenSSL, this
74	<	option is not necessary.  If configure cannot find OpenSSL, you
75	<	must specify a path with this option
72	>	Required for the SSL Challenge controlled OPER feature, compressed
73	>	and/or SSL/TLS server links, as well as SSL/TLS client connections.
74	>
75	>	On systems where the configure script can automatically detect
76	>	OpenSSL, this option is not necessary. If configure cannot find
77	>	OpenSSL, you must specify a path with this option
78		(--enable-openssl=/path/to/openssl)
79
80	+
81		These are optional or have default values that may be overridden:
82
83	<	* --disable-shared-modules - Disable module support.  This option is
88	<	more secure, but reduces a lot of the flexibility in hybrid-7.
89	<	This may need to be used on some systems without a working
90	<	dlopen/dlsym.
91	<
92	<	* --enable-assert - Enable use of numerous debugging checks.  This
83	>	* --enable-assert - Enable use of numerous debugging checks. This
84		should not be used on any production servers for maximum speed
85	<	so as to prevent cores from things that shouldn't normally happen.
85	>	so as to prevent cores from things that shouldn't normally happen.
86
87	<	* --enable-halfops - Enable halfops (%, mode +h) usage. Halfops
88	<	are similar to plain ops, but can't kick/deop plain ops. Halfops
89	<	may or may not kick/deop other halfops depending on if (+p) is
90	<	set. Halfops may not set (+/-p).
91	<
92	<	* --enable-small-net - Tunes the server for smaller networks by
93	<	reducing the startup memory footprint. This should really only be
94	<	used for *small* networks, as this tends to be a performance hit
104	<	on larger networks.
105	<
106	<	* --enable-syslog=kill/squit/connect/users/oper, separated by
107	<	spaces, in quotes - Enables syslog logging, with events you specify
108	<	(none is okay too, and logs the most essential messages only.)
109	<
110	<	* --enable-syslog-facility=FACILITY - Check with your sysadmin to see
111	<	what this should be; by default it is LOG_LOCAL4. If you get it wrong
112	<	initially, no problem; just edit the value in include/setup.h.
87	>	* --enable-debugging - Prepares Makefiles to compile the ircd sources
88	>	with proper settings that are required for debugging purposes.
89	>	This switch basically sets CFLAGS to "-g -O0".
90	>
91	>	* --enable-halfops - Enable halfops (%, mode +h) usage. Halfops
92	>	are similar to plain ops, but can't kick/deop plain ops. Halfops
93	>	may or may not kick/deop other halfops depending on if (+p) is
94	>	set. Halfops may not set (+/-p).
95
96		* --with-nicklen,
97	<	--with-topiclen - Respectively, sets the maximum NICK length and
98	<	maximum TOPIC length. Note that this must be consistent across your
99	<	entire network. Defaults are 9 and 120, respectively.
118	<
119	<	* --disable-zlib - Build the ircd without ziplinks support.
120	<
121	<	* --disable-gline-voting - This is good for small networks or where
122	<	G-Line voting is not necessary. Please understand that by disabling
123	<	this, it will allow any operator with G-Line permissions to G-Line
124	<	someone without requiring the approval of 2 other operators. However,
125	<	it is useful if you use proxy scanners or services that do G-Lines.
126	<
127	<	3.  Run 'make'; this should build the ircd.
128	<
129	<	4.  Run 'make install'; this will install the server, modules(1), and tools
130	<	in the path with the prefix specified when configure was ran.
97	>	--with-topiclen - Respectively, sets the maximum NICK length and
98	>	maximum TOPIC length. Note that this must be consistent across your
99	>	entire network. Defaults are 9 and 120, respectively.
100
132	–	(1) Unless the server was compiled without module support.
101
134	–	5.  If you wish to install the contrib modules, run 'make install' in the
135	–	contrib/ folder to compile and install the modules and help pages.
102
103	<	6.  If you wish to enable the user log, oper log, and failed oper log,
138	<	kill log, kline log and the gline log issue these commands at the
139	<	shell prompt (in the prefix directory).
140	<
141	<	$ touch logs/userlog
142	<	$ touch logs/operlog
143	<	$ touch logs/foperlog
144	<	$ touch logs/kill
145	<	$ touch logs/kline
146	<	$ touch logs/gline
147	<
148	<	Note: If you use different names in ircd.conf, you must 'touch'
149	<	their specific names.
150	<
151	<	7.  If you are upgrading from Hybrid 5 or Hybrid 6, the config files
152	<	have changed drastically...
153	<
154	<	By default, the kline file is named kline.conf, the dline file is
155	<	named dline.conf, the xline file is called xline.conf, and the gline
156	<	file is called gline.conf.
157	<
158	<	The nick resv file is named nresv.conf, channel resv file is named
159	<	cresv.conf.
103	>	3.  Run 'make'; this should build the ircd.
104
105	<	The oper motd file is named opers.motd.
105	>	4.  Run 'make install'; this will install the server, modules, and tools
106	>	in the path with the prefix specified when configure was ran.
107
108		----------------------------------------------------------------------
109
#	Line 172 | Line 117
117		on you, PLEASE contact bugs@ircd-hybrid.org ASAP with a backtrace of
118		the core. The Hybrid team can't fix bugs if no one tells us about them!
119
175	–	- http://forum.ircd-hybrid.org/
176	–	We decided to create a phpBB-like forum about ircd-hybrid, where you
177	–	can get help from coders and admins, post your suggestions, modules etc.
178	–
120		- https://lists.ircd-hybrid.org/mailman/listinfo/hybrid
121		Here you can subscribe to a mailing list for general discussion of Hybrid.
122
#	Line 188 | Line 129
129
130		1.  Change to the directory containing the core file
131
132	<	2.  Run gdb on the binary and the core file. With an unmodified Hybrid-7.2
132	>	2.  Run gdb on the binary and the core file. With an unmodified ircd-hybrid
133		installation, an example command line is below (in the /usr/local/ircd
134		directory)
135

Diff Legend

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