103 lines
4.1 KiB
Text
103 lines
4.1 KiB
Text
|
If you don't read this first, we won't help you.
|
||
|
|
:-)
|
||
|
|
|
||
|
|
******************************* IMPORTANT *************************************
|
||
|
|
|
||
|
|
*********** Note for those who dont bother reading docs *****************
|
||
|
|
* - Reading INSTALL is now a must, as the old DPATH is now specified *
|
||
|
|
* when configure is run. *
|
||
|
|
* You now need to ./configure --prefix="/path/to/install/it" *
|
||
|
|
* - The old config format WILL NOT WORK. Please see doc/example.conf ! *
|
||
|
|
* - The old kline format WILL NOT WORK. Please use convertklines which *
|
||
|
|
* will be installed with your ircd! *
|
||
|
|
*************************************************************************
|
||
|
|
|
||
|
|
ALSO, IF YOU ARE UPGRADING YOUR CURRENT SOURCE TREE, AND YOU TRY TO BUILD
|
||
|
|
IN IT WITHOUT PERFORMING AT LEAST 'make clean', THINGS _WILL_ BREAK. IT IS
|
||
|
|
RECOMMENDED THAT YOU RUN 'make distclean' AND THEN RERUN './configure'!
|
||
|
|
|
||
|
|
******************************* REQUIREMENTS **********************************
|
||
|
|
|
||
|
|
Necessary Requirements:
|
||
|
|
|
||
|
|
- A supported platform (look below)
|
||
|
|
|
||
|
|
- A working dynamic load library, unless
|
||
|
|
compiling as static, without module
|
||
|
|
support.
|
||
|
|
|
||
|
|
- A working lex. Solaris /usr/ccs/bin/lex
|
||
|
|
appears to be broken, on this system flex
|
||
|
|
should be used.
|
||
|
|
|
||
|
|
|
||
|
|
Feature Specific Requirements:
|
||
|
|
|
||
|
|
- For the SSL Challenge controlled OPER feature and encrypted server links,
|
||
|
|
a working OpenSSL library
|
||
|
|
|
||
|
|
- For encrypted oper and (optional) server passwords, a working DES and/or
|
||
|
|
MD5 library
|
||
|
|
|
||
|
|
*******************************************************************************
|
||
|
|
|
||
|
|
- To report bugs in ircd-ratbox, send the bug report to ircd-ratbox@lists.ratbox.org
|
||
|
|
|
||
|
|
- Known bugs are listed in the BUGS file
|
||
|
|
|
||
|
|
- See the INSTALL document for info on configuring and compiling
|
||
|
|
ircd-ratbox.
|
||
|
|
|
||
|
|
- Please read doc/index.txt to get an overview of the current documentation.
|
||
|
|
|
||
|
|
- Old Hybrid 5/6 configuration files are no longer supported. All conf
|
||
|
|
files will have to be converted to the new format. A convertconf
|
||
|
|
utility is provided and installed into bin/.
|
||
|
|
|
||
|
|
- If you are wondering why config.h is practically empty, its because many
|
||
|
|
things that were once in config.h are now specified in the 'general'
|
||
|
|
block of ircd.conf. Look at example.conf for more information about
|
||
|
|
these options.
|
||
|
|
|
||
|
|
- The files, /etc/services, /etc/protocols, and /etc/resolv.conf, MUST be
|
||
|
|
readable by the user running the server in order for ircd to start.
|
||
|
|
Errors from adns causing the ircd to refuse to start up are often related
|
||
|
|
to permission problems on these files.
|
||
|
|
|
||
|
|
- There is a mailing list for ircd-ratbox. To subscribe to this list
|
||
|
|
visit http://lists.ratbox.org/cgi-bin/mailman/listinfo/ircd-ratbox
|
||
|
|
Note that this list also gets the commit emails from the CVS server.
|
||
|
|
|
||
|
|
- FREEBSD USERS: if you are compiling with ipv6 you may experience
|
||
|
|
problems with ipv4 due to the way the socket code is written. To
|
||
|
|
fix this you must: "sysctl net.inet6.ip6.v6only=0"
|
||
|
|
|
||
|
|
- SOLARIS USERS: this code appears to tickle a bug in older gcc and
|
||
|
|
egcs ONLY on 64-bit Solaris7. gcc-2.95 and SunPro C on 64bit should
|
||
|
|
work fine, and any gcc or SunPro compiled on 32bit.
|
||
|
|
|
||
|
|
- DARWIN AND MACOS X USERS: You must be using at least the December 2001
|
||
|
|
Development Tools from Apple to build ircd-ratbox with shared modules.
|
||
|
|
Before then you MUST disable shared modules, as we do not have the proper
|
||
|
|
flags for cc(1) prior to that point to produce shared modules.
|
||
|
|
|
||
|
|
- SUPPORTED PLATFORMS: this code should compile without any warnings
|
||
|
|
on FreeBSD 3.x/4.x, RedHat 6.2, Debian Potato and Solaris 7/8 sparc.
|
||
|
|
Please let us know if you find otherwise.
|
||
|
|
It probably does not compile on AIX, IRIX or libc5 Linux.
|
||
|
|
|
||
|
|
- TESTED PLATFORMS: The code has been tested on the following platforms, and
|
||
|
|
is known to run properly.
|
||
|
|
FreeBSD 3.x/4.x
|
||
|
|
Linux glibc
|
||
|
|
Solaris 2.6/7/8
|
||
|
|
OpenBSD 2.8
|
||
|
|
NetBSD 1.4
|
||
|
|
|
||
|
|
- Please read doc/whats-new.txt for information about what is in this release
|
||
|
|
|
||
|
|
- Other files recommended for reading: BUGS, INSTALL
|
||
|
|
|
||
|
|
--------------------------------------------------------------------------------
|
||
|
|
$Id: README.FIRST 1837 2006-08-22 14:05:58Z nenolod $
|