X-Git-Url: https://arthur.barton.de/cgi-bin/gitweb.cgi?p=ngircd-alex.git;a=blobdiff_plain;f=doc%2FFAQ.txt;h=bf3628c12bea03d8196029316babd0d0882f7880;hp=94e0a2e82ea157ddae55490a1021035bf72c73e4;hb=fd9266df78e32104af3fa72eb5528b5615a2030e;hpb=b0482db9667a855c878e1cae5902f2926b8edb81 diff --git a/doc/FAQ.txt b/doc/FAQ.txt index 94e0a2e8..bf3628c1 100644 --- a/doc/FAQ.txt +++ b/doc/FAQ.txt @@ -1,61 +1,90 @@ ngIRCd - Next Generation IRC Server - (c)2001,2002 by Alexander Barton, + (c)2001-2003 by Alexander Barton, alex@barton.de, http://www.barton.de/ - ngIRCd ist freie Software und steht unter - der GNU General Public License. + ngIRCd is free software and published under the + terms of the GNU General Public License. -- FAQ: Frequently Asked Questions -- -I. Allgemein -~~~~~~~~~~~~ -Q: Kann der ngIRCd im Netz zusammen mit "normalen" Servern betrieben werden? -A: Ja. ngIRCd ist zum Original kompatibel, getestet wird dies zur Zeit mit - der Version 2.10.3p3 des ircd. +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. + +Q: Is there a homepage with further information and downloads? +A: Yes. Please visit . -Q: Gibt es eine Homepage mit Informationen und Downloads? -A: Ja. Die URL ist . +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. Compilieren +II. Compilation ~~~~~~~~~~~~~~~ -Q: Ich habe die Sourcen von ngIRCd ueber CVS installiert. Nun kann ich - ./configure nicht ausfuehren, da es nicht existiert!? -A: Bei Builds direkt aus dem CVS-Tree muss das configure-Script zunaechst - durch GNU autoconf sowie die Makefile.in's durch GNU automake generiert - werden. Um dies zu vereinfachen existiert das Script "./autogen.sh". - GNU automake und GNU autoconf werden -- im Gegensatz zu Builds aus den - Sourcen eines .tar.gz-Archivs -- hierbei benoetigt! - -Q: ./autogen.sh bricht mit der Meldung "autoheader: command not found" ab. -A: GNU autoconf ist nicht installiert, wird jedoch bei Builds direkt aus - dem CVS-Tree benoetigt. - -Q: ./autogen.sh bricht mit der Meldung "autoconf: Undefined macros: - AC_FUNC_MALLOC" bzw. "AC_CONFIG_SRCDIR" ab. -A: Auf dem System ist eine zu alte Version von GNU autoconf installiert. - Ein Update auf z.B. Version 2.52 loest dieses Problem (eine installiete - alte Version sollte ggf. zunaechst entfernt werden, bei RPM-Paketen z.B. - mit dem Befehl "rpm -e autoconf"). - - -III. Bugs!? -~~~~~~~~~~~ -Q: Gibt es eine Liste der bekannten Bugs bzw. Feature-Wuensche? -A: Ja. Es existiert ein Bug-Tracking-System fuer den ngIRCd (Bugzilla): - URL: . Dort koennen Bugs ge- - meldet und Feature-Wunsche kundgetan werden. Bekannte Bugs koennen in - der Datenbank gesucht und aufgelistet werden. - Einen Account zum Suchen und Melden von Bugs bzw. Feature-Wuenschen - kannst du dir dort selber anlegen. - -Q: Was mache ich, wenn ich einen Bug gefunden habe? -A: Am besten traegst du ihn in das Bug-Tracking-System des ngIRCd ein: - URL: +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 + the Makefile.in templates must be generated using GNU automake and GNU + autoconf. To simplify this task run the ./autogen.sh script which will + execute the required tools for you; then continue with executing the + ./configure script as usual. + +Q: The ./autogen.sh script complains "aclocal: command not found". +A: GNU automake is missing on your system but required for building CVS + versions of ngIRCd. Install GNU automake 1.6 or later and try again. + +Q: The ./autogen.sh script stops with "autoheader: command not found". +A: GNU autoconf is missing on your system but required for building CVS + versions of ngIRCd. Install GNU autoconf 2.52 or later and try again. + +Q: The ./autogen.sh script fails and the message "automake: configure.in: + AM_INIT_AUTOMAKE must be used" is displayed. +A: Most probably you are using version 1.5 of GNU automake which seems to be + incompatible to the build system of ngIRCd. Solution: upgrade to at least + version 1.6 of GNU automake. + (If you are using Debian 3.0 "Woody" you can try to downgrade to version + 1.4 of GNU automake shipped with this distribution; it should work, too.) + + +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: 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. The only known workaround + is to either disable chroot support or to link against dietlibc instead + of glibc. (tnx to Sebastian Siewior) +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 to enable MODE for IRC + operators. + +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 . 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 ! + The author of the particular component will be notified automagically :-) -- -$Id: FAQ.txt,v 1.2 2002/02/19 20:05:02 alex Exp $ +$Id: FAQ.txt,v 1.12 2008/01/02 22:47:58 alex Exp $