ngIRCd - Next Generation IRC Server
- (c)2001-2003 by Alexander Barton,
+ (c)2001-2010 by Alexander Barton,
alex@barton.de, http://www.barton.de/
ngIRCd is free software and published under the
I. General
~~~~~~~~~~
+
Q: Is it possible to link the ngIRCd with non-ngIRCd servers?
A: Yes. ngIRCd is compatible to the original ircd used by IRCNet. Actually
- this is being tested with version 2.10.3p3.
+ this is being tested with version 2.10.3p3. Please note that newer
+ versions (2.11.x) aren't compatible any more!
Q: Is there a homepage with further information and downloads?
-A: Yes. Please visit <http://arthur.ath.cx/~alex/ngircd/>.
+A: Yes. Please visit <http://ngircd.barton.de/>.
+
+Q: Why should I use ngIRCd instead of the original one?
+A: ngIRCd offers several benefits: no problems with dynamic IPs, easy to
+ configure, open source (GPL), under active development.
II. Compilation
~~~~~~~~~~~~~~~
+
Q: I did a "CVS checkout" but can't execute ./configure because the script
is missing in the generated directory!?
A: When using development versions via CVS, the configure script as well as
1.4 of GNU automake shipped with this distribution; it should work, too.)
-III. Bugs!?
-~~~~~~~~~~~
+III. Runtime
+~~~~~~~~~~~~
+
+Q: Where is the log file located?
+A: ngIRCd does not write its own log file. Instead, ngIRCd uses syslog(3).
+ Check the files in /var/log/ and/or consult the documentation for your
+ system logger daemon.
+
+Q: I cannot connect to remote peers when I use the chroot option, the
+ following is logged: "Can't resolve example.com: unknown error!".
+A: see next question blow ...
+
+Q: When running ngIRCd inside a chroot, no IP addresses can be translated
+ in DNS names, errors like "Name or service not known" are logged.
+A: On Linux/glibc with chroot enabled you need to put some libraries inside
+ the chroot as well, notably libnss_dns; maybe others. Unfortunately, even
+ linking ngIRCd statically does not help this. So you can either copy
+ all the required files into the chroot directory:
+ $ mkdir -p ./chroot/etc ./chroot/lib
+ $ cp -a /etc/hosts /etc/resolv.conf /etc/nsswitch.conf ./chroot/etc/
+ $ cp -a /lib/libresolv* /lib/libnss_* ./chroot/lib/
+ Or you can try to link ngIRCd against an other C library (like dietlibc)
+ that doesn't depend on NSS modules and/or these files.
+
+Q: I have added an [Oper] section, how do i log on as IRC operator?
+A: You can use the /OPER command in your IRC client to become an IRC operator.
+ ngIRCd will also log all OPER requests (using syslog), if OPER fails you
+ can look there to determine why it did not work (bad password, unauthorized
+ host mask, etc.)
+
+Q: I am an IRC operator, but MODE doesn't work!
+A: You need to set 'OperCanUseMode = yes' in ngircd.conf, then IRC operators
+ can use the MODE command for changing modes even when they are not joined
+ to the specific channel.
+
+Q: How can I "auto-op" users in channels?
+A: ngIRCd can't do this: you would have to use some "IRC Services", like
+ Atheme (<http://atheme.net/atheme.html>) or Anope (<http://www.anope.org>).
+ See "doc/Services.txt" for setup instructions.
+
+
+IV. Bugs!?
+~~~~~~~~~~
+
Q: Is there a list of known bugs and desired feature enhancements?
-A: Yes. Have a look at the bug tracking system (Bugzilla) for ngIRCd located
- at <http://arthur.ath.cx/bugzilla/ngircd/>. There you can file bug reports
- and feature requests as well as search the bug database.
+A: Yes. Have a look at the bug tracking system (GitHub issues) for ngIRCd located
+ at <https://github.com/ngircd/ngircd/issues>. There you can file bug
+ reports and feature requests as well as search the bug database.
Q: What should I do if I found a bug?
-A: Please file a bug report at <http://arthur.ath.cx/bugzilla/ngircd/>!
- The author of the particular component will be notified automagically :-)
-
+A: Please file a bug report at <https://github.com/ngircd/ngircd/issues/new>!
+ The author will be notified automagically :-)
---
-$Id: FAQ.txt,v 1.5 2003/04/05 11:37:17 alex Exp $