]>
Commit | Line | Data |
---|---|---|
1 | If you don't read this first, we won't help you. | |
2 | :-) | |
3 | ||
4 | ******************************* IMPORTANT ************************************* | |
5 | ||
6 | *********** Note for those who dont bother reading docs ***************** | |
7 | * - Reading INSTALL is now a must, as the old DPATH is now specified * | |
8 | * when configure is run. * | |
9 | * You now need to ./configure --prefix="/path/to/install/it" * | |
10 | * will be installed with your ircd! * | |
11 | ************************************************************************* | |
12 | ||
13 | ALSO, IF YOU ARE UPGRADING YOUR CURRENT SOURCE TREE, AND YOU TRY TO BUILD | |
14 | IN IT WITHOUT PERFORMING AT LEAST 'make clean', THINGS _WILL_ BREAK. IT IS | |
15 | RECOMMENDED THAT YOU RUN 'make distclean' AND THEN RERUN './configure'! | |
16 | ||
17 | ******************************* REQUIREMENTS ********************************** | |
18 | ||
19 | New Features - A short introduction: | |
20 | - charybdis-3.x now has several major changes over previous version that you | |
21 | will notice right away. | |
22 | o SSL Client support. | |
23 | o Connection Throttling. | |
24 | ||
25 | - Please see NEWS for more detailed changes. | |
26 | ||
27 | ||
28 | Necessary Requirements: | |
29 | ||
30 | - A supported platform (look below) | |
31 | ||
32 | - A working dynamic load library, unless | |
33 | compiling as static, without module | |
34 | support. | |
35 | ||
36 | - A working lex. Solaris /usr/ccs/bin/lex | |
37 | appears to be broken, on this system flex | |
38 | should be used. | |
39 | ||
40 | ||
41 | Feature Specific Requirements: | |
42 | ||
43 | - For SSL Clients, SSL Challenge controlled OPER feature, and encrypted server links, | |
44 | a working OpenSSL library | |
45 | ||
46 | - For encrypted oper and (optional) server passwords, a working DES, MD5, or SHA library. | |
47 | ||
48 | ******************************************************************************* | |
49 | ||
50 | - To report bugs in charybdis, visit us at irc.atheme.org #charybdis | |
51 | ||
52 | - Known bugs are listed in the BUGS file | |
53 | ||
54 | - See the INSTALL document for info on configuring and compiling | |
55 | charybdis. | |
56 | ||
57 | - Please read doc/index.txt to get an overview of the current documentation. | |
58 | ||
59 | - The files, /etc/services, /etc/protocols, and /etc/resolv.conf, MUST be | |
60 | readable by the user running the server in order for ircd to start. | |
61 | Errors from adns causing the ircd to refuse to start up are often related | |
62 | to permission problems on these files. | |
63 | ||
64 | - FREEBSD USERS: if you are compiling with ipv6 you may experience | |
65 | problems with ipv4 due to the way the socket code is written. To | |
66 | fix this you must: "sysctl net.inet6.ip6.v6only=0" | |
67 | ||
68 | - SOLARIS USERS: this code appears to tickle a bug in older gcc and | |
69 | egcs ONLY on 64-bit Solaris7. gcc-2.95 and SunPro C on 64bit should | |
70 | work fine, and any gcc or SunPro compiled on 32bit. | |
71 | ||
72 | - DARWIN AND MACOS X USERS: You must be using at least the December 2001 | |
73 | Development Tools from Apple to build charybdis with shared modules. | |
74 | Before then you MUST disable shared modules, as we do not have the proper | |
75 | flags for cc(1) prior to that point to produce shared modules. | |
76 | ||
77 | - SUPPORTED PLATFORMS: this code should compile without any warnings on: | |
78 | FreeBSD 6.x/7.x, | |
79 | Gentoo & Gentoo Hardened ~x86/~amd64/~fbsd | |
80 | Fedora 8/9 / CentOS 4/5 / Redhat Enterprise 5 | |
81 | Debian Etch, | |
82 | OpenSuSE 10/11, | |
83 | OpenSolaris 2008.x? | |
84 | Solaris 10 sparc. | |
85 | ||
86 | Please let us know if you find otherwise. | |
87 | It probably does not compile on AIX, IRIX or libc5 Linux. | |
88 | ||
89 | - TESTED PLATFORMS: The code has been tested on the following platforms, and | |
90 | is known to run properly. | |
91 | FreeBSD 6.x/7.x | |
92 | Linux glibc-2.6, glibc-2.7 | |
93 | Solaris 2.6/7/8 | |
94 | OpenBSD 2.8 | |
95 | NetBSD 1.4 | |
96 | OpenVMS/Alpha 7.2 (static modules, no ssld) | |
97 | ||
98 | - Please read NEWS for information about what is in this release | |
99 | ||
100 | - Other files recommended for reading: BUGS, INSTALL | |
101 | ||
102 | -------------------------------------------------------------------------------- | |
103 | $Id$ |