X-Git-Url: https://arthur.barton.de/cgi-bin/gitweb.cgi?p=ngircd-alex.git;a=blobdiff_plain;f=doc%2Fsample-ngircd.conf;h=6ae6b444f37a3aa0f4d7a76e45234be9bc838547;hp=c7845135104eb67555e7a6b201fea7c76199fef6;hb=1c99b8377fd7afdac9170440677f6940b0995370;hpb=ce2738c9840565f1665ac1d5b63b970eadfa5f39

diff --git a/doc/sample-ngircd.conf b/doc/sample-ngircd.conf
index c7845135..6ae6b444 100644
--- a/doc/sample-ngircd.conf
+++ b/doc/sample-ngircd.conf
@@ -1,27 +1,108 @@
-# $Id: sample-ngircd.conf,v 1.3 2002/02/17 17:34:50 alex Exp $
+# $Id: sample-ngircd.conf,v 1.8 2002/03/30 13:03:12 alex Exp $
+
+#
+# Das ist eine Beispiel-Konfiguration fuer den ngIRCd, die an die
+# jeweiligen Beduerfnisse angepasst werden kann/muss.
+#
+# Kommentare werden mit "#" oder ";" eingeleitet.
+#
 
 [Global]
+
+	#
+	# Im [Global]-Abschnitt der Konfigurationsdatei wird der Server
+	# "an sich" konfiguriert. Notwendig ist nur die Variable "Name",
+	# Info ist in der Regel ebengalls anzupassen. Fuer alle uebrigen
+	# Variablen koennen oft die Defaults benutzt werden.
+	#
+
+	# Servername im IRC-Netz
 	Name = irc.the.net
+
+	# Info-Text des Servers
 	Info = Server Info Text
-	Ports = 6667, 6668, 6669
-	MotdFile = /usr/local/etc/ngircd.motd
-	PingTimeout = 120
-	PongTimeout = 10
-	ConnectRetry = 60
+
+	# Ports, auf denen Verbindungen angenommen werden sollen. Es koennen
+	# mehrere Ports mit "," getrennt angegeben werden. (Default: 6667)
+	;Ports = 6667, 6668, 6669
+
+	# Textdatei mit der "Message of the Day" (MOTD)
+	;MotdFile = /usr/local/etc/ngircd.motd
+
+	# User-ID, unter der der Daemon laufen soll (dazu muss der Server
+	# jedoch mit root-Rechten gestartet werden).
+	# ACHTUNG: Die Konfigurations- und MOTD-Datei muessen fuer diesen
+	# Benutzer lesbar sein, ansonsten schlaegt ein RESTART fehl!
+	;ServerUID = 65534
+
+	# Group-ID, zu der der Daemon wechseln soll (hierzu muss der Server
+	# jedoch mit root-Rechten gestartet werden)
+	;ServerGID = 65534
+
+	# Nach <PingTimeout> Sekunden verschickt der Server bei Inaktivitaet
+	# von einem Client diesem ein PING.
+	;PingTimeout = 120
+
+	# Antwortet ein Client, der ein PING bekam, nicht innerhalb von
+	# <PongTimeout> Sekunden mit einem PONG, so wird er disconnectiert.
+	;PongTimeout = 20
+
+	# Der Server versucht alle <ConnectRetry> Sekunden, noch nicht bzw.
+	# nicht mehr connectierte Server-Links aufzubauen.
+	;ConnectRetry = 60
+
 
 [Operator]
-;	Name = TheOper
-;	Password = ThePwd
 
-[Server]
-;	Host = connect-to-host.the.net
-;	Name = irc2.the.net
-;	Port = 6666
-;	Password = ThePwd1
+	#
+	# Mit einem [Operator]-Block wird der Name und das Passwort eines
+	# IRC-Operators konfiguriert. Es darf mehrere [Operator]-Bloecke
+	# geben (fuer jeden Operator einen).
+	#
+
+	# ID des IRC-Operators (muss nicht mit dem Nick identisch sein).
+	;Name = TheOper
+
+	# Passwort des IRC-Operators
+	;Password = ThePwd
+
 
 [Server]
-;	Host = wait-for-host.the.net
-;	Name = irc3.the.net
-;	Password = ThePwd2
+
+	#
+	# In [Server]-Bloecken werden Server konfiguriert, zu denen dieser
+	# Server sich verbinden soll bzw. von denen Verbindungen angekommen
+	# werden duerfen.
+	# Es koennen mehrere Server konfiguriert werden, d.h. [Server]-
+	# Bloecke koennen mehrfach vorkommen.
+	# Ist fuer einen Server ein Port konfiguriert, so versucht dieser
+	# Server die Gegenseite zu connectieren. Ist kein Port vorgegeben,
+	# so wartet dieser Server auf eine Verbindung der Gegenseite.
+	#
+	# Server-Gruppen:
+	# Fuer jeden Server kann (optinal!) eine Gruppe konfiguriert werden,
+	# zu der er gehoert (wird nur beachtet, wenn ein Port konfiguriert
+	# ist!): eine solche Server-Gruppe wird quasi als ein Server ange-
+	# sehen, der ngIRCd baut also nur eine Verbindung auf. Schlaegt die
+	# Verbindung zu einem Server in einer Gruppe fehl, so wird der
+	# naechste Server in der Gruppe probiert.
+	#
+
+	# Hostname des Servers
+	;Host = connect-to-host.the.net
+
+	# IRC-Name des Servers
+	;Name = irc2.the.net
+
+	# Port, zu dem dieser Server eine Verbindung herstellen soll. Wird
+	# kein Port angegeben, so wird auf eine Verbindung der Gegenseite
+	# gewartet.
+	;Port = 6666
+
+	# Passwort fuer diese Verbindung
+	;Password = ThePwd1
+
+	# Gruppe, zu der dieser Server gehoert (optional).
+	;Group = 123
 
 # -eof-