| 2 |
|
|
| 3 |
|
$Id$ |
| 4 |
|
|
| 5 |
< |
Copyright (c) 1997-2012 IRCD-Hybrid Development Team |
| 5 |
> |
Copyright (c) 1997-2013 IRCD-Hybrid Development Team |
| 6 |
|
|
| 7 |
|
---------------------------------------------------------------------- |
| 8 |
|
|
| 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 |
|
|
| 22 |
– |
***** EFNET NOTE ***** |
| 23 |
– |
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. |
| 26 |
– |
********************** |
| 27 |
– |
|
| 20 |
|
---------------------------------------------------------------------- |
| 21 |
|
|
| 22 |
|
HOW TO BUILD |
| 26 |
|
ircd-hybrid. |
| 27 |
|
|
| 28 |
|
1. Read the NEWS file to find out about the exciting new features in |
| 29 |
< |
this version. Other good reads are BUGS, etc/example.conf, and |
| 38 |
< |
README. |
| 29 |
> |
this version. Other good reads are doc/reference.conf, and README. |
| 30 |
|
|
| 31 |
|
2. Run the configure script. It will create config.h and the |
| 32 |
|
Makefiles to match your system. The paths are now handled |
| 51 |
|
currently only available on 2.5.44 Linux kernel versions or |
| 52 |
|
later. |
| 53 |
|
|
| 63 |
– |
* --enable-rtsigio - Enable the superior Linux RealTime Signal I/O |
| 64 |
– |
system. This is currently only available on 2.4 Linux kernel |
| 65 |
– |
versions or later. |
| 66 |
– |
|
| 54 |
|
* --enable-poll - Use POSIX poll(2). |
| 55 |
|
|
| 56 |
|
* --enable-select - Use POSIX select(2). |
| 60 |
|
enable select(2) instead (bad idea), you must use --enable-select. |
| 61 |
|
|
| 62 |
|
* --enable-openssl - Enable the openssl dependent crypto functions. |
| 63 |
< |
This will allow CHALLENGE to work and encrypted links. On systems |
| 64 |
< |
where the configure script can automatically detect OpenSSL, this |
| 65 |
< |
option is not necessary. If configure cannot find OpenSSL, you |
| 66 |
< |
must specify a path with this option |
| 63 |
> |
Required for the SSL Challenge controlled OPER feature, compressed |
| 64 |
> |
and/or SSL/TLS server links, as well as SSL/TLS client connections. |
| 65 |
> |
|
| 66 |
> |
On systems where the configure script can automatically detect |
| 67 |
> |
OpenSSL, this option is not necessary. If configure cannot find |
| 68 |
> |
OpenSSL, you must specify a path with this option |
| 69 |
|
(--enable-openssl=/path/to/openssl) |
| 70 |
|
|
| 71 |
|
|
| 75 |
|
should not be used on any production servers for maximum speed |
| 76 |
|
so as to prevent cores from things that shouldn't normally happen. |
| 77 |
|
|
| 78 |
+ |
* --enable-debugging - Prepares Makefiles to compile the ircd sources |
| 79 |
+ |
with proper settings that are required for debugging purposes. |
| 80 |
+ |
This switch basically sets CFLAGS to "-g -O0". |
| 81 |
+ |
|
| 82 |
|
* --enable-halfops - Enable halfops (%, mode +h) usage. Halfops |
| 83 |
|
are similar to plain ops, but can't kick/deop plain ops. Halfops |
| 84 |
|
may or may not kick/deop other halfops depending on if (+p) is |
| 85 |
|
set. Halfops may not set (+/-p). |
| 86 |
|
|
| 94 |
– |
* --enable-small-net - Tunes the server for smaller networks by |
| 95 |
– |
reducing the startup memory footprint. This should really only be |
| 96 |
– |
used for *small* networks, as this tends to be a performance hit |
| 97 |
– |
on larger networks. |
| 98 |
– |
|
| 99 |
– |
* --with-nicklen, |
| 100 |
– |
--with-topiclen - Respectively, sets the maximum NICK length and |
| 101 |
– |
maximum TOPIC length. Note that this must be consistent across your |
| 102 |
– |
entire network. Defaults are 9 and 120, respectively. |
| 103 |
– |
|
| 104 |
– |
|
| 87 |
|
|
| 88 |
|
3. Run 'make'; this should build the ircd. |
| 89 |
|
|
| 90 |
|
4. Run 'make install'; this will install the server, modules, and tools |
| 91 |
|
in the path with the prefix specified when configure was ran. |
| 92 |
|
|
| 111 |
– |
5. If you wish to install the contrib modules, run 'make install' in the |
| 112 |
– |
contrib/ folder to compile and install the modules and help pages. |
| 113 |
– |
|
| 114 |
– |
6. If you are upgrading from Hybrid 5 or Hybrid 6, the config files |
| 115 |
– |
have changed drastically. |
| 116 |
– |
|
| 117 |
– |
By default, the kline file is named kline.conf, the dline file is |
| 118 |
– |
named dline.conf, and the xline file is called xline.conf. |
| 119 |
– |
|
| 120 |
– |
The nick resv file is named nresv.conf, channel resv file is named |
| 121 |
– |
cresv.conf. |
| 122 |
– |
|
| 123 |
– |
The oper motd file is named opers.motd. |
| 124 |
– |
|
| 93 |
|
---------------------------------------------------------------------- |
| 94 |
|
|
| 95 |
|
HOW TO GET HELP |
