Dokumentation
Unterstützte Plattformen
ngIRCd wird vor allem unter aktuellen Versionen von Linux, macOS, FreeBSD und OpenBSD entwickelt und getestet.
Auf den folgenden Plattformen wurde der ngIRCd zudem bereits erfolgreich compiliert und eingesetzt:
- AIX (3.2.5 [IBM XL C Compiler])
- A/UX (3.x [Apple C Compiler, GNU C])
- FreeBSD (4.5 and newer on i386, x86_64 [GNU C])
- Haiku (on x86_64 [GNU C])
- HP-UX (9.10, 10.20, 11.11 on hppa, m68k [HP-UX cc, GNU C])
- IRIX (6.5 [SGI MIPSpro C 7.30])
- Linux (2.x and newer; on aarch64, armhf, hppa, i386, mipsel, powerpc, x86_64, ... [GNU C, Clang, PCC & TCC])
- macOS (Darwin) (10.0 and newer on i386, powerpc, x86_64 & aarch64 [GNU C 2.95.x, 3.x, 4.x & Apple Clang])
- NetBSD (1.5.2 and newer on alpha, i386, m68k, sparc, x86_64, ... [GNU C])
- OpenBSD (3.4 and newer on hppa, i386, powerpc, x86_64 [GNU C])
- Solaris (2.5.1 and newer on i386, sparc [GNU C])
- Windows: Cygwin or WSL (GNU C)
Da sich der ngIRCd an übliche UNIX-Standards hält und GNU automake sowie GNU autoconf verwendet, stehen die Chancen nicht schlecht, dass er sich auf weiteren UNIXoiden Systemen übersetzen bzw. relativ einfach anpassen lässt.
Installation
ngIRCd ist für UNIXoide Systeme konzipiert, die Installation sollte auf einem modernen UNIX-ähnlichen System, das von GNU automake und GNU autoconf („configure“) unterstützt wird, keine besonderen Schwierigkeiten bereiten.
Der Standardfall sieht so aus:
tar xzf ngircd-<version>.tar.gz
cd ngircd-<version>
./configure
make
Nun sollte sich in src/ngircd
der ausführbare Server
(in der Regel ngircd
) befinden.
make install
Der ausführbare Server wurde nun in /usr/local/sbin
installiert.
Vom Server wird die Konfigurationsdatei ngircd.conf
in
/usr/local/etc
erwartet; eine Beispiel-Konfigurationsdatei
ist im Verzeichnis doc
zu finden.
Weitere Hinweise zur Installation und Konfiguration finden sich in der Datei INSTALL.
Dokumentation
Ein wenig Dokumentation ist im Quellpaket enthalten, zum Teil im Hauptverzeichnis (so z. B. die Dokumente INSTALL, README, NEWS und COPYING), andere im Unterverzeichnis doc (wie z. B. SSL.txt, FAQ.txt und die Beispiel-Konfiguration sample-ngircd.conf).
Die Dateien der aktuellen Version sind hier im Web (in englischer Sprache) zu finden:
- AUTHORS
- Bopm.txt
- Capabilities.txt
- Commands.txt
- Contributing.txt
- COPYING
- HowToRelease.txt
- Modes.txt
- PAM.txt
- Platforms.txt
- Protocol.txt
- RFC.txt
- Services.txt
- SSL.md
- README-AUX.txt
- README-BeOS.txt (deutsch)
- README-Interix.txt
Manual Pages
Außerdem enthält ngIRCd zwei manual pages
:
ngircd(8)
(für den Daemon) und ngircd.conf(5)
(für seine Konfigurationsdatei). Sie enthalten noch mehr Details und
listen alle möglichen Kommandozeilenparameter und
Konfigurationsoptionen auf. Sie können sie mit dem
man
-Befehl lesen (wenn sie lokal auf Ihrem System
installiert sind, z.B. man 8 ngircd
und man 5
ngircd.conf
) oder online hier:
- Server: ngircd(8)
- Konfigurationsdatei: ngircd.conf(5)