ngircd/INSTALL

                     ngIRCd - Next Generation IRC Server

                      (c)2001,2002 by Alexander Barton,
                    alex@barton.de, http://www.barton.de/

                  ngIRCd ist freie Software und steht unter
                       der GNU General Public License.

                         -- INSTALL / Installation --
                         
                      Ilja Osthoff, <ilja@glide.ath.cx>


 +-----------------------------------------------------------------------+
 | Please note: English translations of some of the german documentation |
 | files can be found in the directory "doc/en" -- please have a look!   |
 +-----------------------------------------------------------------------+


I. Standard-Installation
~~~~~~~~~~~~~~~~~~~~~~~~

ngIRCd ist fuer UNIXoide-Systeme konzipiert worden, das bedeutet, dass die
Installation auf einem modernen UNIX-aehnlichen System kein Problem dar-
stellen sollte. Das System muss nur von GNU automake und GNU autoconf
("configure") unterstuetzt werden.

Die Standard-Installation sieht so aus:

   1) tar xzf ngircd-<Version>.tar.gz
   2) cd ngircd-<Version>
   3) ./autogen.sh	[nur erforderlich, wenn ueber CVS bezogen]
   4) ./configure
   5) make
   6) make install


zu 3): "autogen.sh"

Der erste Schritt, autogen.sh, ist nur notwendig, wenn das configure-Script
noch nicht vorhanden ist. Dies ist nie bei offiziellen ("stabilen") Versionen
in tar.gz-Archiven der Fall, jedoch immer, wenn der Source-Code ueber CVS
bezogen wurde.

Dieser Absatz ist also eigentlich ausschliesslich fuer Entwickler interessant.

autogen.sh erzeugt die fuer das configure-Script notwendigen Makefile.in's
sowie das configure-Script selber und weitere fuer den make-Lauf erforderliche
Dateien. Dazu wird sowohl GNU automake als auch GNU autoconf (in aktuellen
Versionen!) benoetigt.

(nochmal: "Endanwender" mussen diesen Schritt i.d.R. nicht ausfuehren!)


zu 4): "./configure"

Mit dem configure-Script wird ngIRCd, wie GNU Software meistens, an das
lokale System angepasst und die erforderlichen Makefile's erzeugt.

Im Optimalfall sollte configure alle benoetigten Libraries, Header etc. selber
erkennen und entsprechend reagieren. Sollte dies einmal nicht der Fall sein,
so zeigt "./configure --help" moegliche Optionen.


zu 5): "make"

Der make-Befehl bearbeitet die vom configure-Script erzeugten Makefile's und
uebersetzt den ngIRCd.


zu 6): "make install"

Mit "make install" wird der Server und ggf. eine Beispiels-Konfiguration
im System installiert; hierzu sind in der Regel root-Rechte erforderlich.
Eine bereits vorhandene Konfigurationsdatei wird nie ueberschrieben.

Folgende Dateien werden installiert:

- /usr/local/sbin/ngircd: ausfuehrbarer Server
- /usr/local/etc/ngircd.conf: Beispiel-Konfiguration, wenn nicht vorhanden


II. Nuetzliche make-Targets
~~~~~~~~~~~~~~~~~~~~~~~~~~~

Die vom configure-Script erzeugten Makefile's enthalten immer die folgenden
nuetzlichen Targets:

 - clean: alle Erzeugnisse des Compilers/Linkers loeschen.
   Naechster Schritt: -> make

 - distclean: zusaetzliche alle Makefile's loeschen.
   Naechster Schritt: -> ./configure

 - maintainer-clean: alle automat. erzeugten Dateien loeschen.
   Naechster Schritt: -> ./autogen.sh



III. Konfigurationsdatei ngircd.conf
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

In der Konfigurationsdatei werden Kommentare durch "#" oder durch ";"
eingeleitet. Dieses dient nur der besseren Lesbarkeit.

Die Datei ist in drei Abschnitte unterteilt: [Global], [Operator] und
[Server]. Im [Global]-Teil werden die grundlegenden Einstellungen vor-
genommen, z.B. der Server-Name und die Ports, auf denen er Verbindungen
annehmen soll. In [Operator]-Abschnitten werden Server-Operatoren fest-
gelegt und unter [Server] werden die Einstellungen fuer die Verbindung
mit anderen Servern konfiguriert.

Die Bedeutung der einzelnen Variablen ist in der Beispiel-Konfiguration
"doc/sample-ngircd.conf" erklaert, die bei "make install" auch als
"ngircd.conf" in /usr/local/etc installiert wird, wenn dort noch keine
Konfigurationsdatei vorhanden ist.


IV. Kommandozeilen-Optionen
~~~~~~~~~~~~~~~~~~~~~~~~~~~

Folgende Parameter koennen dem ngIRCd u.a. uebergeben werden:

-f, --config <file>
	Der Daemon wird angewiesen, statt der Standard-Konfigurationsdatei
	/usr/local/etc/ngircd.conf die Datei <file> einzulesen.

-n, --nodaemon
	ngIRCd soll im Fordergrund laufen; alle Meldungen werden zusaetzlich
	zum Syslog auch auf der Konsole ausgegeben.

-p, --passive
	Verbindungen zu anderen Servern (wie in der Konfigurationsdatei in
	[Server]-Abschnitten definiert) werden nicht automatisch hergestellt.

--configtest
	Die Konfigurationsdatei wird eingelesen, ueberprueft und so aus-
	gegeben, wie sie vom ngIRCd interpretiert wurde. Danach beendet
	sich der Server wieder.

Mit dem Parameter "--help" werden alle unterstuetzten Parameter angezeigt,
mit "--version" die Versionsnummer. Bei beiden Parametern beendet sich der
Server nach der Ausgabe wieder.


-- 
$Id: INSTALL,v 1.8 2002/09/16 11:03:05 alex Exp $