Annotation of ircnowd/doc/FAQ.txt, Revision 1.1
1.1 ! tomglok 1:
! 2: ngIRCd - Next Generation IRC Server
! 3:
! 4: (c)2001-2010 by Alexander Barton,
! 5: alex@barton.de, http://www.barton.de/
! 6:
! 7: ngIRCd is free software and published under the
! 8: terms of the GNU General Public License.
! 9:
! 10: -- FAQ: Frequently Asked Questions --
! 11:
! 12:
! 13: I. General
! 14: ~~~~~~~~~~
! 15:
! 16: Q: Is it possible to link the ngIRCd with non-ngIRCd servers?
! 17: A: Yes. ngIRCd is compatible to the original ircd used by IRCNet. Actually
! 18: this is being tested with version 2.10.3p3. Please note that newer
! 19: versions (2.11.x) aren't compatible any more!
! 20:
! 21: Q: Is there a homepage with further information and downloads?
! 22: A: Yes. Please visit <http://ngircd.barton.de/>.
! 23:
! 24: Q: Why should I use ngIRCd instead of the original one?
! 25: A: ngIRCd offers several benefits: no problems with dynamic IPs, easy to
! 26: configure, open source (GPL), under active development.
! 27:
! 28:
! 29: II. Compilation
! 30: ~~~~~~~~~~~~~~~
! 31:
! 32: Q: I did a "Git checkout" but can't execute ./configure because the script
! 33: is missing in the generated directory!?
! 34: A: When using development versions via Git, the configure script as well as
! 35: the Makefile.in templates must be generated using GNU automake and GNU
! 36: autoconf. To simplify this task run the ./autogen.sh script which will
! 37: execute the required tools for you; then continue with executing the
! 38: ./configure script as usual.
! 39:
! 40: Q: The ./autogen.sh script complains "aclocal: command not found".
! 41: A: GNU automake is missing on your system but required for building Git
! 42: versions of ngIRCd. Install GNU automake 1.6 or later and try again.
! 43:
! 44: Q: The ./autogen.sh script stops with "autoheader: command not found".
! 45: A: GNU autoconf is missing on your system but required for building Git
! 46: versions of ngIRCd. Install GNU autoconf 2.52 or later and try again.
! 47:
! 48: Q: The ./autogen.sh script fails and the message "automake: configure.in:
! 49: AM_INIT_AUTOMAKE must be used" is displayed.
! 50: A: Most probably you are using version 1.5 of GNU automake which seems to be
! 51: incompatible to the build system of ngIRCd. Solution: upgrade to at least
! 52: version 1.6 of GNU automake.
! 53: (If you are using Debian 3.0 "Woody" you can try to downgrade to version
! 54: 1.4 of GNU automake shipped with this distribution; it should work, too.)
! 55:
! 56:
! 57: III. Runtime
! 58: ~~~~~~~~~~~~
! 59:
! 60: Q: Where is the log file located?
! 61: A: ngIRCd does not write its own log file. Instead, ngIRCd uses syslog(3).
! 62: Check the files in /var/log/ and/or consult the documentation for your
! 63: system logger daemon.
! 64:
! 65: Q: I cannot connect to remote peers when I use the chroot option, the
! 66: following is logged: "Can't resolve example.com: unknown error!".
! 67: A: see next question blow ...
! 68:
! 69: Q: When running ngIRCd inside a chroot, no IP addresses can be translated
! 70: in DNS names, errors like "Name or service not known" are logged.
! 71: A: On Linux/glibc with chroot enabled you need to put some libraries inside
! 72: the chroot as well, notably libnss_dns; maybe others. Unfortunately, even
! 73: linking ngIRCd statically does not help this. So you can either copy
! 74: all the required files into the chroot directory:
! 75: $ mkdir -p ./chroot/etc ./chroot/lib
! 76: $ cp -a /etc/hosts /etc/resolv.conf /etc/nsswitch.conf ./chroot/etc/
! 77: $ cp -a /lib/libresolv* /lib/libnss_* ./chroot/lib/
! 78: Or you can try to link ngIRCd against an other C library (like dietlibc)
! 79: that doesn't depend on NSS modules and/or these files.
! 80:
! 81: Q: I have added an [Oper] section, how do i log on as IRC operator?
! 82: A: You can use the /OPER command in your IRC client to become an IRC operator.
! 83: ngIRCd will also log all OPER requests (using syslog), if OPER fails you
! 84: can look there to determine why it did not work (bad password, unauthorized
! 85: host mask, etc.)
! 86:
! 87: Q: I am an IRC operator, but MODE doesn't work!
! 88: A: You need to set 'OperCanUseMode = yes' in ngircd.conf, then IRC operators
! 89: can use the MODE command for changing modes even when they are not joined
! 90: to the specific channel.
! 91:
! 92: Q: How can I "auto-op" users in channels?
! 93: A: ngIRCd can't do this: you would have to use some "IRC Services", like
! 94: Atheme (<http://atheme.net/atheme.html>) or Anope (<http://www.anope.org>).
! 95: See "doc/Services.txt" for setup instructions.
! 96:
! 97:
! 98: IV. Bugs!?
! 99: ~~~~~~~~~~
! 100:
! 101: Q: Is there a list of known bugs and desired feature enhancements?
! 102: A: Yes. Have a look at the bug tracking system (GitHub issues) for ngIRCd located
! 103: at <https://github.com/ngircd/ngircd/issues>. There you can file bug
! 104: reports and feature requests as well as search the bug database.
! 105:
! 106: Q: What should I do if I found a bug?
! 107: A: Please file a bug report at <https://github.com/ngircd/ngircd/issues/new>!
! 108: The author will be notified automagically :-)
! 109:
CVSweb
![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to FAQ.txt CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [local] / ircnowd / doc