Return to FAQ.txt CVS log

Up to [local] / ircnowd / doc

Annotation of ircnowd/doc/FAQ.txt, Revision 1.1.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: