Blame


1 077b610e 2002-01-23 alex
2 077b610e 2002-01-23 alex ngIRCd - Next Generation IRC Server
3 077b610e 2002-01-23 alex
4 5170ecf0 2003-03-09 alex (c)2001-2003 by Alexander Barton,
5 077b610e 2002-01-23 alex alex@barton.de, http://www.barton.de/
6 077b610e 2002-01-23 alex
7 5170ecf0 2003-03-09 alex ngIRCd is free software and published under the
8 5170ecf0 2003-03-09 alex terms of the GNU General Public License.
9 077b610e 2002-01-23 alex
10 077b610e 2002-01-23 alex -- FAQ: Frequently Asked Questions --
11 077b610e 2002-01-23 alex
12 077b610e 2002-01-23 alex
13 a93b4d97 2003-04-05 alex I. General
14 a93b4d97 2003-04-05 alex ~~~~~~~~~~
15 a93b4d97 2003-04-05 alex Q: Is it possible to link the ngIRCd with non-ngIRCd servers?
16 a93b4d97 2003-04-05 alex A: Yes. ngIRCd is compatible to the original ircd used by IRCNet. Actually
17 a93b4d97 2003-04-05 alex this is being tested with version 2.10.3p3.
18 5b333085 2003-01-04 alex
19 a93b4d97 2003-04-05 alex Q: Is there a homepage with further information and downloads?
20 b976ec03 2005-07-09 alex A: Yes. Please visit <http://ngircd.barton.de/>.
21 5b333085 2003-01-04 alex
22 c5f4e9d0 2003-04-29 goetz Q: Why should I use ngIRCd instead of the original one?
23 c5f4e9d0 2003-04-29 goetz A: ngIRCd offers several benefits: no problems with dynamic IPs, easy to
24 c5f4e9d0 2003-04-29 goetz configure, open source (GPL), under active development.
25 077b610e 2002-01-23 alex
26 c5f4e9d0 2003-04-29 goetz
27 a93b4d97 2003-04-05 alex II. Compilation
28 077b610e 2002-01-23 alex ~~~~~~~~~~~~~~~
29 a93b4d97 2003-04-05 alex Q: I did a "CVS checkout" but can't execute ./configure because the script
30 a93b4d97 2003-04-05 alex is missing in the generated directory!?
31 a93b4d97 2003-04-05 alex A: When using development versions via CVS, the configure script as well as
32 a93b4d97 2003-04-05 alex the Makefile.in templates must be generated using GNU automake and GNU
33 a93b4d97 2003-04-05 alex autoconf. To simplify this task run the ./autogen.sh script which will
34 a93b4d97 2003-04-05 alex execute the required tools for you; then continue with executing the
35 a93b4d97 2003-04-05 alex ./configure script as usual.
36 077b610e 2002-01-23 alex
37 a93b4d97 2003-04-05 alex Q: The ./autogen.sh script complains "aclocal: command not found".
38 a93b4d97 2003-04-05 alex A: GNU automake is missing on your system but required for building CVS
39 a93b4d97 2003-04-05 alex versions of ngIRCd. Install GNU automake 1.6 or later and try again.
40 077b610e 2002-01-23 alex
41 a93b4d97 2003-04-05 alex Q: The ./autogen.sh script stops with "autoheader: command not found".
42 a93b4d97 2003-04-05 alex A: GNU autoconf is missing on your system but required for building CVS
43 a93b4d97 2003-04-05 alex versions of ngIRCd. Install GNU autoconf 2.52 or later and try again.
44 077b610e 2002-01-23 alex
45 a93b4d97 2003-04-05 alex Q: The ./autogen.sh script fails and the message "automake: configure.in:
46 a93b4d97 2003-04-05 alex AM_INIT_AUTOMAKE must be used" is displayed.
47 a93b4d97 2003-04-05 alex A: Most probably you are using version 1.5 of GNU automake which seems to be
48 a93b4d97 2003-04-05 alex incompatible to the build system of ngIRCd. Solution: upgrade to at least
49 a93b4d97 2003-04-05 alex version 1.6 of GNU automake.
50 a93b4d97 2003-04-05 alex (If you are using Debian 3.0 "Woody" you can try to downgrade to version
51 a93b4d97 2003-04-05 alex 1.4 of GNU automake shipped with this distribution; it should work, too.)
52 077b610e 2002-01-23 alex
53 a93b4d97 2003-04-05 alex
54 a874c26c 2005-07-08 alex III. Runtime
55 a874c26c 2005-07-08 alex ~~~~~~~~~~~~
56 b88e97f1 2005-07-07 fw
57 a874c26c 2005-07-08 alex Q: I cannot connect to remote peers when I use the chroot option, the
58 a874c26c 2005-07-08 alex following is logged: "Can't resolve example.com: unknown error!".
59 a874c26c 2005-07-08 alex A: On Linux/glibc with chroot enabled you need to put some libraries inside
60 a874c26c 2005-07-08 alex the chroot as well, notably libnss_dns; maybe others. Unfortunately, even
61 a874c26c 2005-07-08 alex linking ngircd statically does not help this. The only known workaround
62 a874c26c 2005-07-08 alex is to either disable chroot support or to link against dietlibc instead
63 a874c26c 2005-07-08 alex of glibc. (tnx to Sebastian Siewior)
64 a874c26c 2005-07-08 alex
65 e1b9409e 2005-12-09 fw Q: I am running Linux and ngircd dies on startup with the follwing errors:
66 e1b9409e 2005-12-09 fw IO subsystem: epoll (hint size 100, initial maxfd 100, masterfd -1).
67 e1b9409e 2005-12-09 fw Cannot initialize IO routines: Function not implemented
68 e1b9409e 2005-12-09 fw Server isn't listening on a single port!
69 e1b9409e 2005-12-09 fw ngircd exiting due to fatal errors!
70 e1b9409e 2005-12-09 fw A: epoll is only supported on 2.6 Linux kernels. Either use a 2.6 kernel, or
71 e1b9409e 2005-12-09 fw re-run configure with the --without-epoll parameter. After configure
72 e1b9409e 2005-12-09 fw completed, you should see select() being listed as IO backend:
73 e1b9409e 2005-12-09 fw '(I/O backend: "select()"').
74 a874c26c 2005-07-08 alex
75 a874c26c 2005-07-08 alex IV. Bugs!?
76 a874c26c 2005-07-08 alex ~~~~~~~~~~
77 a93b4d97 2003-04-05 alex Q: Is there a list of known bugs and desired feature enhancements?
78 a93b4d97 2003-04-05 alex A: Yes. Have a look at the bug tracking system (Bugzilla) for ngIRCd located
79 b976ec03 2005-07-09 alex at <http://ngircd.barton.de/bugzilla/index.cgi>. There you can file bug
80 b976ec03 2005-07-09 alex reports and feature requests as well as search the bug database.
81 b0482db9 2002-02-19 alex
82 a93b4d97 2003-04-05 alex Q: What should I do if I found a bug?
83 b976ec03 2005-07-09 alex A: Please file a bug report at <http://ngircd.barton.de/bugzilla/index.cgi>!
84 a93b4d97 2003-04-05 alex The author of the particular component will be notified automagically :-)
85 b0482db9 2002-02-19 alex
86 b0482db9 2002-02-19 alex
87 077b610e 2002-01-23 alex --
88 e1b9409e 2005-12-09 fw $Id: FAQ.txt,v 1.11 2005/12/09 21:14:56 fw Exp $