-------------------------------------------------------------------------------
 errpage - fli4l documentation

 Creation:	01.07.2003 hei
 Last update:	13.02.2004 hei
 Version: 	1.1 

 written by:	Till Heidtmann <t.heidtmann@web.de>


 This program is free software; you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
 the Free Software Foundation; either version 2 of the License, or
 (at your option) any later version.
-------------------------------------------------------------------------------

#------------------------------------------------------------------------------
# Optional package: ERRPAGE
#------------------------------------------------------------------------------


********************************* Beschreibung ********************************

ERRPAGE startet einen (zweiten) Mini-Http-Server auf einem whlbaren Port.
Es wird eine lapidare Fehlermeldung angezeigt, wenn darauf zugegriffen
wird. Die knnt ihr natrlich anpassen:-)
OPT_ERRPAGE wurde als Beipack zu OPT_DOMBLK gemacht, kann aber auch 
von jedem anderen opt genutzt werden.

**************************** Einschrnkungen **********************************

Der Port, auf dem ERRPAGE lauscht, sollte zur Verfgung stehen und nach auen
gesperrt sein (ist bei der Voreinstellung der Fall).

********************** Installationsvoraussetzungen ***************************

fli4l 2.0.7, 2.0.8
OPT_HTTPD (auf der Downloadseite von fli4l, *nicht* bei den opts)
		
****************************** Konfiguration **********************************

Die Konfiguration sollte sich aus der Beispielkonfig ergeben:

OPT_ERRPAGE='yes'                 	# install ERRPAGE, ja oder nein.
ERRPAGE_PORT='8000'			# Der Port, auf dem er lauschen soll.

Der Port muss sich natrlich vom Haupt-httpd unterscheiden und sollte nicht 
gerade andere Sachen auer Betrieb setzen.
Es empfiehlt sich, diesen Port nach auen zu sperren.

*************************** Enthaltene Dateien ********************************

config/errpage.txt		:	Konfigurationsdatei.
check/errpage.txt		:	Variablen-Prfung.
opt/errpage.txt			:	Liste der zu kopierenden Dateien.
opt/etc/rc.d/rc110.errpage	:	Das boot-Skript.
opt/etc/prep/prep.errpage	:	Prparieren der htmls
opt/files/usr/local/errpage/index.html:	Die grandiose Fehlermeldungsseite.
doc/deutsch/dev/errpage.txt	:	Kurzinfo fr Fremdverwendung.
doc/deutsch/opt/errpage.txt	:	Diese Datei.

*************************** Technische Details ********************************

Keine CGIs, gestartet als nobody, gechrootet.

Es wird ein zweiter mini-httpd in /opt/files/usr/local/errpage gestartet als
nobody, gechrootet. index.html und errors/err404.html und err400.html werden so 
abgelegt, dass das geht.

Zur Verwendung durch andere opts:
Umleiten z.B. mit 
ipchains -I <chain> -p tcp -s <Quelle> --dport 80 -j REDIRECT ERRPAGE_PORT
(lschen mit ipchains -D ...wie oben...)
Verlinken mit:
http://<server>:ERRPAGE_PORT

ERRPAGE_PORT ist in /var/run/errpage.port verfgbar.

********************************* Feedback ************************************

Falls sowas schon irgendwo existiert, bitte mail an mich. Auch ich habe mir
nicht _alle_ opts angeschaut.

Wer ne hbsche, aber schlanke Fehlerseite macht, mge sie mir schicken:-)

Fehler/Patches bitte an die Gruppe spline.fli4l.opt oder per mail an mich. 

*********************************** ToDo **************************************

Englische Doku. 
Sonst eigentlich nix. Einfach ist genial.

********************************** Historie ***********************************

ver 0.9.2: 01.07.03	Auslieferung mit OPT_DOMBLK

ver 0.9.3: 05.07.03	Port in /var/run/errpage.port hinterlegt.
			Fehler in der Doku bereinigt.
			Loggen abgeschaltet.

ver 1.0:   26.08.03	Caching-Problem mit dem IE behoben (Danke fr den 
			Hinweis von Patrick Gnewikow)

ver 1.1:   02.01.04	err400.html aktiviert.
			
********************************** Gute N8 ************************************

(c) 2003/2004 Till Heidtmann <t.heidtmann@web.de>