JK-Wiki edv:prg:apache

edv:prg:apache:apache_kompilieren

Anonymous (anonymous@undisclosed.example.com) — 2020-01-11T01:23:28+00:00

	aktuell
Zeile 1:	Zeile 1:
	+	====== Apache aus den Quellen kompilieren ======

	+	Als Erstes alle Sources (%%httpd-2.4.27.tar.gz%%, %%apr-1.6.2.tar.gz%%, %%apr-iconv-1.2.1.tar.gz%%, %%apr-util-1.6.0.tar.gz%%) inklusive Patches und Hashes unter "${HOME}/download/Apache_HTTP_Server_2.4.27/Source" untergebracht.
	+
	+	Nach der Prüfung der Kontrollsummen (%%.md5%%, %%.sha1%%, %%.sha256%%, %%.asc%%) die %%.gz%%-Archive dort entpackt:
	+
	+	<code>
	+	userid@rhel:/users/userid/download/Apache_HTTP_Server_2.4.27/Source> ls -l
	+	total 68076
	+	-rwxr-x---. 1 userid groupid 5826560 Jun 9 14:56 apr-1.6.2.tar
	+	-rwxr-x---. 1 userid groupid 1071074 Oct 5 11:24 apr-1.6.2.tar.gz
	+	-rwxr-x---. 1 userid groupid 8683520 Nov 15 2007 apr-iconv-1.2.1.tar
	+	-rwxr-x---. 1 userid groupid 1233989 Oct 5 11:24 apr-iconv-1.2.1.tar.gz
	+	drwxr-x---. 2 userid groupid 4096 Oct 5 11:28 apr-patches
	+	-rwxr-x---. 1 userid groupid 3481600 May 4 01:20 apr-util-1.6.0.tar
	+	-rwxr-x---. 1 userid groupid 565507 Oct 5 11:24 apr-util-1.6.0.tar.gz
	+	drwxr-x---. 2 userid groupid 4096 Oct 2 17:52 httpd-2.4.27-patches
	+	-rwxr-x---. 1 userid groupid 39874560 Oct 2 17:22 httpd-2.4.27.tar
	+	-rwxr-x---. 1 userid groupid 8603417 Oct 5 10:59 httpd-2.4.27.tar.gz
	+	-rwxr-x---. 1 userid groupid 793 Oct 2 17:24 httpd-2.4.27.tar.gz.asc
	+	-rwxr-x---. 1 userid groupid 54 Oct 2 17:24 httpd-2.4.27.tar.gz.md5
	+	-rwxr-x---. 1 userid groupid 62 Oct 2 17:24 httpd-2.4.27.tar.gz.sha1
	+	-rwxr-x---. 1 userid groupid 86 Oct 2 17:24 httpd-2.4.27.tar.gz.sha256
	+	userid@rhel:/users/userid/download/Apache_HTTP_Server_2.4.27/Source>
	+	</code>
	+
	+	Folgende Abhängigkeiten musste ich nachinstalliert (sonst konnte ich nicht kompilieren):
	+
	+	* expat-devel
	+	* pcre-devel
	+
	+	%%httpd-2.4.27.tar%% ins Verzeichnis %%apache%% (unterhalb von %%${HOME}%%) verschoben und dort entpackt.
	+
	+	Folgende %%.tar%%-Pakete samt Patches ins Verzeichnis %%srclib%% (unterhalb von %%${HOME}/apache/httpd-2.4.27%%) verschoben und dort entpackt:
	+
	+	* apr
	+	* apr-iconf
	+	* apr-util
	+
	+	Zuerst alle Patches eingespielt, danach kompiliert in der Reihenfolge:
	+
	+	* apr
	+	* apr-iconf
	+	* apr-util
	+	* httpd
	+
	+	Hier der Ablauf:
	+
	+	<code bash>
	+	cd ${HOME}/apache/httpd-2.4.27
	+
	+	export PREFIX_APACHE=${PWD}
	+
	+	export PATH_SRC_APACHE=${PREFIX_APACHE}
	+	export PATH_SRC_APR=${PATH_SRC_APACHE}/srclib/apr-1.6.2
	+	export PATH_SRC_APR_UTIL=${PATH_SRC_APACHE}/srclib/apr-util-1.6.0
	+	export PATH_SRC_APR_ICONV=${PATH_SRC_APACHE}/srclib/apr-iconv-1.2.1
	+
	+	export LIB=${PATH_SRC_APR}/lib:${PATH_SRC_APR_UTIL}/lib:${PATH_SRC_APR_ICONV}/lib:${PREFIX_APACHE}/lib
	+	export LIBPATH=${LIB}
	+	export LIBRARY_PATH=${LIB}
	+
	+	export INCLUDE=${PATH_SRC_APACHE}/include:${PATH_SRC_APR_ICONV}/include:${PATH_SRC_APR}/include:${PATH_SRC_APR_UTIL}/include
	+
	+	cd srclib
	+
	+	cd apr-1.6.2
	+	./configure --prefix=${PREFIX_APACHE}
	+	make
	+	make install
	+	cd ..
	+
	+	cd apr-iconv-1.2.1
	+	./configure --prefix=${PREFIX_APACHE} --with-apr=${PATH_SRC_APR}
	+	make
	+	make install
	+	cd ..
	+
	+	cd apr-util-1.6.0
	+	./configure --prefix=${PREFIX_APACHE} --with-apr=${PATH_SRC_APR}
	+	make
	+	make install
	+	cd ..
	+
	+	cd ..
	+	./configure --prefix=${PREFIX_APACHE} --enable-so --enable-modules="most" --enable-debugger-mode --with-apr=${PATH_SRC_APR} --with-apr-util=${PATH_SRC_APR_UTIL}
	+	make
	+	make install
	+	</code>
	+
	+	Dabei werden einige Meldungen ausgegeben, unter anderem:
	+
	+	Während "make install" von "apr-1.6.2":
	+
	+	libtool: warning: remember to run 'libtool --finish /usr/local/apr/lib'
	+
	+	Während "make" von "apr-iconv-1.2.1":
	+
	+	iconv_ccs.c: In function 'apr_iconv_ccs_event':
	+	iconv_ccs.c:47:16: warning: assignment discards 'const' qualifier from pointer target type [enabled by default]
	+	mod->im_data = mod->im_desc->imd_data;
	+	^
	+
	+	Während "make install" von "apr-util-1.6.0":
	+
	+	libtool: warning: relinking 'libaprutil-1.la'
	+
	+	Ich habe diese Meldungen zunächst ignoriert.
	+
	+	:!: Um ein einzelnes MPM auszuwählen, das statisch kompiliert werden soll, wird die Option --with-mpm=Name verwendet. Für UNIX stehen folgende Varianten zur Auswahl:
	+	* %%prefork%% – für jede Client-Verbindung wird ein eigener Prozess verwendet; es werden stets einige Prozesse auf Vorrat geforkt.
	+	* %%worker%% – eine kleine Anzahl von Prozessen verwaltet für jede Client-Verbindung einen Thread; dieses Modell ist speicherschonender als prefork.
	+	* %%event%% – eine erweiterte Variante von worker, bei der Keepalive-Verbindungen nicht permanent einen Thread blockieren.
	+	Um MPMs (in Apache 2.4) dynamisch laden zu können, muss die Option --enable-mpms-shared=Liste verwendet werden. Beispiel: <code>--enable-mpms-shared="prefork worker"</code>
	+
	+	Jetzt den neuen Apache starten (vorher nur noch die conf/httpd.conf anpassen):
	+
	+	<code bash>
	+	userid@rhel:/users/userid/apache/httpd-2.4.27> bin/httpd -k start
	+	userid@rhel:/users/userid/apache/httpd-2.4.27>
	+	</code>
	+
	+	...oder beenden:
	+
	+	<code bash>
	+	userid@rhel:/users/userid/apache/httpd-2.4.27> bin/httpd -k stop
	+	userid@rhel:/users/userid/apache/httpd-2.4.27>
	+	</code>
	+
	+	...oder neu starten:
	+
	+	<code bash>
	+	userid@rhel:/users/userid/apache/httpd-2.4.27> bin/httpd -k restart
	+	userid@rhel:/users/userid/apache/httpd-2.4.27>
	+	</code>
	+
	+	Zur Kontrolle im Web-Browser auf die URL [[http://rhel/]] (bzw. den host-Namen "rhel" durch einen korrekten DNS-Namen ersetzen) gehen, als Bestätigung soll der Browser einen einzigen String It works! zeigen.
	+
	+	Konfiguration von [[EDV:Soft:Server:Web-Server#Apache]].
	+
	+	Parameter, die beim Start angegeben werden können: [[https://httpd.apache.org/docs/2.4/programs/httpd.html]]\\
	+	Für Entwicklungs- und Debug-Zwecke sind davon folgende besonders interessant:
	+	\|-f config \|Ein anderes KonfigurationsFile anstelle von "conf/httpd.conf" nutzen. Der Pfad soll relativ zum ServerRoot angegeben werden. \|
	+	\|-e level \|Setzt LogLevel während des StartUps. \|
	+	\|-E file \|Schreibt Fehlermeldungen in das File file während des StartUps. \|
	+	\|-X \|Startet Apache im Debug-Modus. Es wird ein einziger Worker gestartet und der Server wird sich von der Konsole nicht verabschieden. \|
	+
	+
	+	----
	+	Stand: 26.07.2018
	+
	+	EOF

edv:prg:apache:apache-module

Anonymous (anonymous@undisclosed.example.com) — 2020-01-11T01:23:29+00:00

	aktuell
Zeile 1:	Zeile 1:
	+	====== Apache-Module ======

	+	Welche Module im Apache statisch verlinkt sind, findet man auf der Kommandozeile mit "%%apache -l%%" heraus:
	+
	+	<code bash>
	+	apache -l
	+	</code>
	+
	+	Auf einer Windows-Maschine mit installiertem Apache 2.2.4 ergibt das beispielsweise folgende Anzeige:
	+	Compiled in modules:
	+	core.c
	+	mod_win32.c
	+	mpm_winnt.c
	+	http_core.c
	+	mod_so.c
	+
	+	(Je nach installierter Version kann der Befehl auch "%%httpd -l%%" oder "%%apache2 -l%%" lauten.)
	+
	+	In dem oben gezeigten Beispiel für den selbst kompilierten Apache:
	+
	+	<code>
	+	userid@rhel:/users/userid/apache/httpd-2.4.27/bin> ./httpd -l
	+	Compiled in modules:
	+	core.c
	+	mod_so.c
	+	http_core.c
	+	event.c
	+	userid@rhel:/users/userid/apache/httpd-2.4.27/bin>
	+	</code>
	+
	+	===== Fertige Module kompilieren =====
	+
	+	Falls einige Module nur als Quelltext vorliegen, müssen sie zuerst kompiliert werden. Apache stellt dafür in seinem "bin"-Verzeichnis das Tool apxs zur Verfügung. Dieses Tool erlaubt es, in einem Rutsch das Modul zu kompilieren, installieren und in der "conf/httpd.conf" zu aktivieren.
	+
	+	Hier ist ein Beispiel.\\ Als ich Apache (httpd-2.4.27) kompiliert hatte, wurde dabei das Mudul mod_cgi nicht mit kompiliert. Das kann man per Hand nachholen:
	+
	+	<code bash>
	+	userid@rhel:/users/userid/apache/httpd-2.4.27/modules/generators> ~/apache/httpd-2.4.27/bin/apxs -cia mod_cgi.c
	+	</code>
	+
	+	Die Parameter "-cia" vom "apxs" stehen für:
	+	* "c" - kompilieren
	+	* "i" - installiern
	+	* "a" - aktivieren
	+
	+	Oder einzeln bzw. Schritt-für-Schritt:
	+	<code bash>
	+	userid@rhel:/users/userid/apache/httpd-2.4.27/modules/generators> ~/apache/httpd-2.4.27/bin/apxs -c mod_cgi.c
	+	userid@rhel:/users/userid/apache/httpd-2.4.27/modules/generators> ~/apache/httpd-2.4.27/bin/apxs -i mod_cgi.la
	+	userid@rhel:/users/userid/apache/httpd-2.4.27/modules/generators> ~/apache/httpd-2.4.27/bin/apxs -a mod_cgi.so
	+	</code>
	+
	+	Die letzte Zeile bewirkt, dass die Konfiguration ("httpd.conf") um ensprechende Angaben zum Modul erweitert wird:
	+
	+	<code>
	+	LoadModule cgi_module modules/mod_cgi.so
	+	</code>
	+
	+	Zur Kontrolle bietet Apache zwei Skripte im cgi-bin-Verzeichnis - "printenv" (in Perl) und "test-cgi" (Shell-Script). Bitte beachten, dass bei den CGI-Skripten das x-Recht für "alle" gesetzt sein soll, damit diese ausfürbar sind.\\ Im Web-Browser auf die URL [[http://apache-adresse/cgi-bin/printenv]] bzw. [[http://apache-adresse/cgi-bin/test-cgi]] gehen.
	+
	+	:!: ACHTUNG:\\ Diese beide Skripte sind nur als Beispiel gedacht dürfen nicht in einer produktiven Umgebung betrieben werden - Sicherheitsrisiko!
	+
	+	==== Module in C++ ====
	+
	+	Ein in C++ geschriebenes Modul zu kompilieren und installieren, geht etwas anders:
	+
	+	<code bash>
	+	userid@rhel:/users/userid/apache/httpd-2.4.27/modules/beispiel/cpp> c++ -g -O2 -Wall -fPIC -I~/apache/httpd-2.4.27/include mod_beispiel.cpp
	+	userid@rhel:/users/userid/apache/httpd-2.4.27/modules/beispiel/cpp> c++ -shared -o mod_beispiel.so mod_beispiel.o
	+	userid@rhel:/users/userid/apache/httpd-2.4.27/modules/beispiel/cpp> cp mod_beispiel.so ~/apache/httpd-2.4.27/modules/
	+	</code>
	+
	+	:!: Nicht vergessen, die Modul-Symbole mit %%extern "C"%% zu deklarieren, um C-Linkage zu erzwingen.
	+
	+
	+	===== Module schreiben (in C) =====
	+
	+	Vereinfachte Übersicht über {{:edv:prg:apache:apache_module_-_aufbau_01_-_2017-10-24_.pdf\|Aufbau von Apache-Modulen}} anhand des Beispiel-Moduls "holiday".
	+
	+	Wichtige Strukturen (definiert in httpd.h):
	+
	+	* request_rec - Diese Struktur representiert den jeweiligen (bzw. aktuellen) http-Request.\\ Die Struktur geht über alle Handler durch, die von den Modulen implementiert sind.
	+	* server_rec - Diese Struktur speichert Informationen über jeden logischen (sprich virtuellen) Server.\\ Jeder logische Server hat normalerweise eine eigene Instanz dieser Struktur. Die Struktur wird beim Start des Servers erzeugt und bleibt permanent bestehen, solange der Server läuft.
	+	* conn_rec - Diese Struktur representiert eine TCP-Connection.\\ Sie wird erzeugt, wenn Apache einen Request vom Client entgegen nimmt und wird zerstört, wenn die Connection schließt.\\ Es ist üblich, dass mehrere "request_rec" auf dieselbe "conn_rec" verweisen, weil sie in der Folge über dieselbe TCP-Connection abgesetzt werden.
	+	* process_rec - Diese Struktur representiert den Prozess.
	+
	+	Mit diesen Strukturen sind entsprechende APR-Pools verknüpft:
	+
	+	* request pool\\ Lifetime: http-Request\\ Zugriff: %%request->pool%%
	+	* process pool (für lang "lebende" Ressourcen)\\ Lifetime: Server Prozess\\ Zugriff: %%process->pool%%
	+	* connection pool\\ Lifetime: TCP-Connection\\ Zugriff: %%connection->pool%%
	+	* configuration pool\\ Lifetime: bis zum nächsten Neulesen der Konfiguration\\ Zugriff: %%process->pconf%%
	+
	+	:!: Achtung! Die Pools sind nicht Thread-sicher!
	+
	+	Beispiel für den Zugriff:
	+
	+	<code c>
	+	int my_func(request_rec* r)
	+	{
	+	// Zugriff auf Request-Pool:
	+	some_call(r->pool);
	+
	+	// Zugriff auf Prozess-Pool:
	+	some_call(r->server->process->pool);
	+
	+	// Zugriff auf Connection-Pool:
	+	some_call(r->connection->pool);
	+	}
	+	</code>
	+
	+	Häufig verwendete Elemente der request_rec-Struktur:
	+	* %%r->handler%% (char*): Beinhaltet den Namen des Handlers, den der Server gerade fragt, den aktuellen Request zu bearbeiten.
	+	* %%r->method%% (char*): Beinhaltet den Namen des HTTP-Requests, z.B. GET oder POST.
	+	* %%r->filename%% (char*): Beinhaltet den "translated filename", den der Client angefordert hat.
	+	* %%r->args%% (char*): Beinhaltet den Argumenten-String aus dem Request, falls vorhanden.
	+	* %%r->headers_in%% (apr_table_t*): Beinhaltet alle Headers, die vom Client gesendet wurden.
	+	* %%r->connection%% (conn_rec*): Diese Record beinhaltet Information über die aktuelle Connection.
	+	* %%r->user%% (char*): Falls URI eine Authentifizierung verlangt, hier steht der "username".
	+	* %%r->useragent_ip%% (char*): Die IP-Adresse des Clients.
	+	* %%r->pool%% (apr_pool_t*): Der "memory pool" des aktuellen Requests.
	+
	+	Die komplette Liste aller Felder der request_rec-Struktur findet man im httpd.h-Header (oder unter [[http://ci.apache.org/projects/httpd/trunk/doxygen/structrequest__rec.html]]).
	+
	+	Hier (beispielsweise) eine Vorlage für ein Modul (namens "modulname"). Grundgerüst:
	+
	+	mod_modulname.c
	+	<code c>
	+	#include "httpd.h"
	+	#include "http_config.h"
	+	#include "http_protocol.h"
	+
	+	// Forward-Deklaration der Modul-Datenstruktur
	+	module AP_MODULE_DECLARE_DATA modulname_module;
	+
	+
	+	/* */
	+	/* Hier befinden sich alle internen Funktionen des Moduls */
	+	/* */
	+
	+	// Datenstruktur des Moduls (Felder, die irrelevant sind, mit NULL initialisieren)
	+	module AP_MODULE_DECLARE_DATA modulname_module =
	+	{
	+	STANDARD20_MODULE_STUFF, // Makro für Apache2
	+	modulname_dir_config, // Konfiguration pro Verzeichnis
	+	modulname_dir_merge, // Merger der Verzeichniskonfigurationen
	+	modulname_server_config, // Konfiguration pro Server
	+	modulname_server_merge, // Merger der Serverkonfigurationen
	+	modulname_commands, // Befehlstabelle (Direktiven)
	+	modulname_register_hooks // Hooks (Aufruf der Modulfunktionen)
	+	};
	+	</code>
	+
	+	Die Struktur module hat folgenden Aufbau:
	+
	+	<code c>
	+	typedef struct module_struct module;
	+	struct module_struct
	+	{
	+	int version; // API version, not module version;
	+	int minor_version;
	+	int module_index;
	+	const char *name;
	+	void *dynamic_load_handle;
	+	struct module_struct *next;
	+	unsigned long magic;
	+	void (rewrite_args) (process_rec process);
	+
	+	void (create_dir_config) (apr_pool_t p, char dir);
	+	void (merge_dir_config) (apr_pool_t p, void base_conf, void *new_conf);
	+	void (create_server_config) (apr_pool_t p, server_rec s);
	+	void (merge_server_config) (apr_pool_t p, void base_conf, void *new_conf);
	+	const command_rec *cmds;
	+	void (register_hooks) (apr_pool_t p);
	+	};
	+	</code>
	+
	+	Die Konstante STANDARD20_MODULE_STUFF belegt die ersten 8 Felder der Struktur und wird standardmäßig wie folgt definiert:
	+
	+	<code c>
	+	#define STANDARD20_MODULE_STUFF MODULE_MAGIC_NUMBER_MAJOR, \
	+	MODULE_MAGIC_NUMBER_MINOR, \
	+	-1, \
	+	__FILE__, \
	+	NULL, \
	+	NULL, \
	+	MODULE_MAGIC_COOKIE, \
	+	NULL
	+	</code>
	+
	+	:!: Die Deklaration durch das Makro "AP_MODULE_DECLARE_DATA" kann durch das Makro "AP_DECLARE_MODULE" ersetzt werden. Dabei muss der Modulname ohne Zusatz "_module" angegeben werden:
	+
	+	<code c>
	+	AP_DECLARE_MODULE(modulname) =
	+	{
	+	STANDARD20_MODULE_STUFF,
	+	modulname_dir_config,
	+	modulname_dir_merge,
	+	modulname_server_config,
	+	modulname_server_merge,
	+	modulname_commands,
	+	modulname_register_hooks
	+	};
	+	</code>
	+
	+	(Info unter: [[https://httpd.apache.org/docs/2.4/developer/new_api_2_4.html#api_changes]])
	+
	+	Das unterste Feld dieser Struktur zeigt auf die CallBack-Funktion, die für das Modul erforderliche Hooks registriert:
	+
	+	<code c>
	+	static void modulname_register_hooks(apr_pool_t *pool)
	+	{
	+	// Hier werden für die Hook-Bearbeitung zuständige CallBack-Funktionen registriert
	+	// Als Beispiel, der Handler wird durch die Funktion "modulname_handler" realisiert:
	+	ap_hook_handler(modulname_handler, NULL, NULL, APR_HOOK_MIDDLE);
	+	}
	+	</code>
	+
	+	:!: Außer ap_hook_handler() gibt es auch weitere [[EDV:PRG:Apache:Hooks]]. FIXME
	+
	+	:!: %%APR_HOOK_MIDDLE%% steht für den relativen Zeitpunkt, wann (ungefähr) der relevante Hook aufgerufen wird. Es gibt folgende Definitionen:
	+
	+	<code c>
	+	/* Hook orderings */
	+	#define APR_HOOK_REALLY_FIRST (-10) // run this hook first, before ANYTHING
	+	#define APR_HOOK_FIRST 0 // run this hook first
	+	#define APR_HOOK_MIDDLE 10 // run this hook somewhere
	+	#define APR_HOOK_LAST 20 // run this hook after every other hook which is defined
	+	#define APR_HOOK_REALLY_LAST 30 // run this hook last, after EVERYTHING
	+	</code>
	+
	+	Der Pointer "apr_pool_t *pool" kann für die Pre-Initialisierung von irgendwelchen Struktur genutzt werden, bevor irgendein Request durch den hier gebundenen Handler "modulname_handler" bearbeitet wird.
	+
	+	Die CallBack-Funktion des Handlers, in der die eigentliche Funktionalität des Moduls gekapselt ist:
	+
	+	<code c>
	+	static int modulname_handler(request_rec *r)
	+	{
	+	/* */
	+	/* Hier arbeitet das Modul */
	+	/* */
	+
	+	return DECLINED; // Falls nicht zuständig
	+	}
	+	</code>
	+
	+	Weitere Rückgabewerte:
	+	* Allgemein:
	+	* DECLINED: Der Handler ist für diesen Request nicht zuständig.
	+	* OK: Der Request wurde erfolgreich bearbeitet.
	+	* DONE: Der Request wurde bearbeitet und der Server soll diesen Thread schließen, ohne ihn weiter zu bearbeiten.
	+	* HTTP-spezifisch:
	+	* HTTP_OK (200): Der Request war OK.
	+	* HTTP_MOVED_PERMANENTLY (301): Die Ressource wurde "verschoben" zu einer anderen URL.
	+	* HTTP_UNAUTHORIZED (401): Der Client wurde für duese Seite nicht authorisiert.
	+	* HTTP_FORBIDDEN (403): Keine Berechtigung / Zugriff verweigert.
	+	* HTTP_NOT_FOUND (404): Spricht für sich - "File not found".
	+	* HTTP_INTERNAL_SERVER_ERROR (500): Ebenfalls selbsterklärend - "Internal server error".
	+
	+
	+	:!: Hier sind Beispiele, wie man die Konfiguration(en) ausliest und behandelt: [[http://httpd.apache.org/docs/2.4/developer/modguide.html#context]]
	+
	+
	+	==== Request parsen ====
	+
	+	Alles, was wir zum Parsen von GET- und POST-Daten benötigen, sind vier einfache Zeilen:
	+
	+	<code c>
	+	eine_funktion(request_rec *r)
	+	{
	+	apr_table_t *GET;
	+	apr_array_header_t *POST;
	+
	+	ap_args_to_table(r, &GET);
	+	ap_parse_form_data(r, NULL, &POST, -1, 8192);
	+
	+	// Weiterer Code...
	+	}
	+	</code>
	+
	+	Zum Beispiel, wir wollen prüfen, ob ein GET-Parameter namens "digest" übergeben wurde und, falls dieser den Wert "md5" hat, dies entsprechend behandeln, sonst einen default-Wert zuweisen:
	+
	+	<code c>
	+	eine_funktion(request_rec *r)
	+	{
	+	// Hier Code inklusive Parsen...
	+	// ...
	+
	+	// Den Key "digest" aus dem Query-String holen:
	+	const char *digestType = apr_table_get(GET, "digest");
	+
	+	// Falls "md5", entsprechende Behandlung:
	+	if (!strcasecmp(digestType, "md5")) {
	+	// Weiterer Code...
	+	}
	+
	+	// Falls nicht vorhanden, auf den default-Wert setzen:
	+	if (!digestType) digestType = "sha1";
	+
	+	// Weiterer Code...
	+
	+	}
	+	</code>
	+
	+	Der Code für einen POST-Request ist ein bißchen komplexer, hier ein Beispiel: [[http://httpd.apache.org/docs/2.4/developer/modguide.html#get_post]]
	+
	+	An gleicher Stelle gibt es 2 weitere Beispiele: "Printing out every HTTP header received" (bzw. das Lesen von Felder aus dem HTTP-Header) und "Reading the request body into memory".
	+
	+
	+	==== Request-Behandlung ====
	+
	+	Module können in den Bearbeitungszyklus auf folgenden Wege (Hooks) eingreifen (nach Phasen gruppiert):
	+
	+	* post_read_request-Phase markiert den Übergang vom Protokoll zur Behandlung des Requests. Das request_rec-Objekt ist zwar gültig, jedoch viele Felder sind noch nicht gesetzt.
	+	* post_read_request - Allgemeiner Hook, läuft sofort beim Erstellen des request_rec-Objekts.
	+	* request preparation-Phase:
	+	* Sub-Phase: Auflösung des Requests ins Filesystem und/oder logisches URL-Spaces entsprechend Definition des Servers.
	+	* translate_name - Mapping der Request-URL in das Filesystem.
	+	* map_to_storage - Wendet die "per-directory"-Konfiguration an.
	+	* Sub-Phase: Erster Hook, bei dem die "per-directory"-Konfiguration zur Verfügung steht.
	+	* header_parser - Prüfung des "HTTP-Request"-Headers. Ein allgemeiner Hook nachdem die Konfiguration komplett zur Verfügung steht, aber vor dem Begin von spezifischen Phasen.
	+	* Security-Phase: Hier wird bestimmt, wozu der User berechtigt ist.
	+	* access_checker - Kontrolle, ob der Zugriff zulässig für den Remote-Host.
	+	* check_user_id - Authentifizierung des "remote Users" (falls anwendbar).
	+	* auth_checker - Kontrolle, ob der remote-User für den Request berechtigt ist.
	+	* Sub-Phase: Die letzte Phase vor dem Content Generator.
	+	* type_checker - Anwendung der Konfigurationsregeln, die bestimmen die Handler- und Response-Headers.
	+	* fixup - Allgemeiner Hook am Ende der Vorbereitung des Requests, aber bevor die Handler aufgerufen werden.
	+	* handler-Phase (Content Generator):
	+	* insert_filter - Fügt Content-Filter hinzu.
	+	* handler - Bearbeitung des Requests und Generierung der Response.
	+	* logger-Phase (die finale Phase):
	+	* logger - Protokollierung der Transaktion.
	+
	+	:!: Bitte die URLs nicht mit Dateisystempfaden verwechseln! Obwohl sie übereinstimmen können (und defaultmäßig auch tun das), ist dies nur eine Frage der Konvention.\\ Die Begriffe %%<Directory>%% und %%<Files>%% beziehen sich auf das Filesystem, die %%<Location>%% dagegen auf die URLs.
	+
	+	==== Häufig genutzte Funktionen ====
	+
	+	* ap_rputs()<code c>ap_rputs(const char string, request_rec r);</code>Sendet einen String zum Client:<code c>ap_rputs("Hello, world!", r);</code>
	+	* ap_rprintf()<code c>int ap_rprintf(request_rec r, const char fmt, ... );</code>Diese Funktion funktioniert ähnlich wie printf(), mit dem Unterschied, dass sie das Ergebnis zum Client sendet:<code c>ap_rprintf(r, "Hello, %s!", r->useragent_ip);</code>
	+	* ap_set_content_type()<code c>ap_set_content_type(request_rec r, const char type);</code>Setzt den Content-Type für den Output:<code c>ap_set_content_type(r, "text/plain"); /* force a raw text output */</code>
	+
	+
	+	==== Speicherverwaltung ====
	+
	+	Man sollte vermeiden, Speicher mit den malloc() bzw. free() zu zuteilen bzw. freizugeben. Das gleiche gilt fürs Öffnen/Schließen von Files mittels fopen() bzw. fclose(), für Sockets und auch Mutexe.\\ Für Ressource-Management sind die APR-Pools zuständig. Das ist zwar eine andere Vorgehensweise als Constructor/Destructor oder Garbage Collection Model, die komplett im Hintergrund agieren, verwaltet aber weitgehend selbständig die Zuteilung und Freigabe von Ressourcen.
	+
	+	Beispiel:
	+	<code c>
	+	// Konventionelle Methode:
	+	mytype* myvar = malloc(sizeof(mytype));
	+	/* Prüfung, ob "myvar != NULL" */
	+
	+	/* Weiterer Code */
	+
	+	free(myvar);
	+
	+	// ----------------------------------------
	+
	+	// APR Methode:
	+	mytype* myvar = apr_palloc(pool, sizeof(mytype));
	+
	+	/* Weiterer Code, keine explizite Freigabe */
	+	</code>
	+
	+	Es ist auch möglich, beide Methoden zu kombinieren. Dabei werden Ressourcen auf konventionelle Weise zugeteilt und dann "in die Hände" von APR übergeben.
	+
	+	Hier ein Beispiel:
	+	<code c>
	+	// Speicher:
	+	mytype* myvar = malloc(sizeof(mytype));
	+	apr_pool_cleanup_register(pool, myvar, free, apr_pool_cleanup_null);
	+
	+	// File:
	+	FILE* f = fopen(filename, "r");
	+	apr_pool_cleanup_register(pool, f, fclose, apr_pool_cleanup_null);
	+	</code>
	+
	+	:!: Dabei bleibt die Möglichkeit, auf diese Weise für die "externe" (durch APR) Verwaltung registrierte Ressourcen nativ freizugeben, trotzdem bestehen.
	+
	+	<code c>
	+	// Irgendwas zuteilen:
	+	my_type* my_res = my_res_alloc(args);
	+	// In der APR-Speicherverwaltung registrieren:
	+	apr_pool_cleanup_register(pool, my_res, my_res_free, apr_pool_cleanup_null);
	+
	+	/* Weiterer Code, in dem my_res verwendet wird */
	+
	+	// Nachdem wir "my_res" nicht mehr brauchen:
	+	rv = my_res_free(my_res);
	+	// Aus der APR-Speicherverwaltung herausnehmen:
	+	apr_pool_cleanup_kill(pool, my_res, my_res_free);
	+	// Danach folgt die Fehlerbehandlung:
	+	if (rv != APR_SUCCESS)
	+	{
	+	/* Fehlerbehandlung */
	+	}
	+	</code>
	+
	+	Die beiden letzten Aktionen (Freigabe und Unregistrierung) kann man auch in einem Call realisieren:
	+
	+	<code c>
	+	apr_pool_cleanup_run(pool, my_res, my_res_free);
	+	</code>
	+
	+	Häufig verwendete Funktionen:
	+
	+	* *void apr_palloc(apr_pool_t p, apr_size_t size)*: Zuteilung von "size" Bytes in dem "pool".
	+	* *void apr_pcalloc(apr_pool_t p, apr_size_t size)*: Zuteilung von "size" Bytes in dem "pool" und Setzen aller Bytes auf 0.
	+	* *char apr_pstrdup(apr_pool_t p, const char s)**: Dupliziert den String "s". Das ist besonders praktisch fürs Kopieren von konstanten Werte um sie zu editieren.
	+	* *char apr_psprintf(apr_pool_t p, const char fmt, ... )**: Ähnlich wie "sprintf()", mit dem Unterschied, dass der Server liefert die entsprechend zugeteilte Zielvariable.
	+
	+	Hier ein Beispiel:
	+
	+	<code c>
	+	static int example_handler(request_rec *r)
	+	{
	+	const char *original = "Dieser String ist nicht editierbar";
	+	char *copy;
	+	int *integers;
	+
	+	// Platz für 10x "int" zuteilen und deren Werte auf 0 setzen.
	+	integers = apr_pcalloc(r->pool, sizeof(int) * 10);
	+
	+	// Eine Kopie von dem Inhalt der Variable "original" erzeugen - die Kopie ist editierbar.
	+	copy = apr_pstrdup(r->pool, original);
	+
	+	return OK;
	+	}
	+	</code>
	+
	+
	+	==== Info zu den "Bucket brigades" ====
	+
	+	(Quelle: [[https://ci.apache.org/projects/httpd/trunk/doxygen/group__APR__Util__Bucket__Brigades.html#ga9a30babfeb6e290db124d8f9b69e49e4]], hier meine Übersetzung.)
	+
	+	__Vereinfachte Beschreibung:__\\ Bucket brigades stellen einen komplexen Datenstrom dar, der ohne unnötiges Kopieren durch mehrere Schichten im IO-System behandelt werden kann.
	+
	+	__Vollständigere Beschreibung:__\\ Eine "bucket brigade" ist eine doppelt verkettete Liste (Ring) von "buckets", so dass wir nicht auf das Einfügen vorne und das Entfernen hinten beschränkt sind. Buckets werden nur als Mitglieder einer Brigade herumgereicht, wobei auch "Singleton-Buckets" für kurze Zeiträume auftreten können. "Buckets" speichern Daten verschiedener Typen. Sie können sich auf Daten im Speicher oder einen Teil einer Datei oder eines MMAP-Bereichs oder auf die Ausgabe eines Prozesses usw. beziehen.
	+
	+	"Buckets" haben auch einige typabhängige Zugriffsfunktionen: read, split, copy, setaside und destroy.
	+
	+	* read gibt die Adresse und Größe der Daten im Bucket zurück.\\ Wenn sich die Daten nicht im Speicher befinden, werden sie eingelesen, und der Bucket ändert den Typ, sodass er sich auf den neuen Speicherort der Daten beziehen kann. Wenn alle Daten nicht in den Bucket passen, wird ein neuer Bucket in die Brigade eingefügt, um den Rest zu platzieren.
	+
	+	* split teilt die Daten in einem Bucket in zwei Bereiche auf.\\ Nach der Aufteilung bezieht sich der ursprüngliche Bucket auf den ersten Teil der Daten, und der neue Bucket, der in die Brigade nach dem ursprünglichen Bucket eingefügt wird, auf den zweiten Teil der Daten.\\ Referenz-Zähler werden entsprechend gepflegt.
	+
	+	* setaside stellt sicher, dass die Daten im Bucket eine ausreichend lange Lebensdauer haben.\\ Manchmal ist es praktisch, einen Bucket zu erstellen, der sich auf Daten auf dem Stack bezieht, in der Erwartung, dass er konsumiert wird (Ausgabe an das Netzwerk), bevor der Stack abgewickelt wird. Wenn sich diese Erwartung unerfüllt bleibt, wird die "setaside"-Funktion aufgerufen, um die Daten an einen sicheren Ort zu verschieben.
	+
	+	* copy erstellt ein Duplikat der Bucket-Struktur, solange es möglich ist, um mehrere Referenzen auf eine einzige Kopie der Daten zu haben.\\ Es können nicht alle Bucket-Typen kopiert werden.
	+
	+	* destroy behandelt Referenz-Zähler der Ressourcen, die von einem Bucket verwendet werden, und gibt sie bei Bedarf frei.
	+
	+	:!: Alle o.g. Funktionen verfügen über Wrapper-Makros (apr_bucket_read(), apr_bucket_destroy(), usw.), und diese Makros sollten verwendet werden, anstatt die Funktionszeiger direkt zu verwenden.
	+
	+	Um in eine "bucket brigade" zu schreiben, werden zuerst "iovec" gemacht, damit wir nicht zu kleine Daten-Portionen schreiben.\\
	+	Momentan ignorieren wir das "Komprimieren" der Buckets in so wenige Buckets wie möglich, aber wenn wir wirklich eine gute Performance haben wollen, dann müssen wir die Buckets zusammenfassen, bevor wir sie zu einem "iovec" konvertieren (oder möglicherweise während wir sie zu einem "iovec" konvertieren).
	+
	+	:!: Ein weiterer Artikel, der das Konzept von "bucket brigades" erläutert: [[http://www.apachetutor.org/dev/brigades]]
	+
	+	----
	+	Stand: 01.08.2018
	+
	+	EOF

edv:prg:apache:apr_apu

Anonymous (anonymous@undisclosed.example.com) — 2020-01-11T01:23:29+00:00

	aktuell
Zeile 1:	Zeile 1:
	+	====== APR, APR-Utils ======

	+	===== Liste der APR-Module =====
	+
	+	apr-1.6.2:
	+	^ APR-Modul ^ Kommentar ^
	+	\| apr_allocator.h: \| APR Internal Memory Allocation \|
	+	\| apr_atomic.h: \| APR Atomic Operations \|
	+	\| apr_cstr.h: \| C string goodies. \|
	+	\| apr_dso.h: \| APR Dynamic Object Handling Routines \|
	+	\| apr_env.h: \| APR Environment functions \|
	+	\| apr_errno.h: \| APR Error Codes \|
	+	\| apr_escape.h: \| APR-UTIL Escaping \|
	+	\| apr_file_info.h: \| APR File Information \|
	+	\| apr_file_io.h: \| APR File I/O Handling \|
	+	\| apr_fnmatch.h: \| APR FNMatch Functions \|
	+	\| apr_general.h: \| APR Miscellaneous library routines \|
	+	\| apr_getopt.h: \| APR Command Arguments (getopt) \|
	+	\| apr_global_mutex.h: \| APR Global Locking Routines \|
	+	\| apr.h: \| APR Platform Definitions \|
	+	\| apr_hash.h: \| APR Hash Tables \|
	+	\| apr_inherit.h: \| APR File Handle Inheritance Helpers \|
	+	\| apr_lib.h: \| APR general purpose library routines \|
	+	\| apr_mmap.h: \| APR MMAP routines \|
	+	\| apr_network_io.h: \| APR Network library \|
	+	\| apr_perms_set.h: \| APR Process Locking Routines \|
	+	\| apr_poll.h: \| APR Poll interface \|
	+	\| apr_pools.h: \| APR memory allocation \|
	+	\| apr_portable.h: \| APR Portability Routines \|
	+	\| apr_portable.h: \| alias for local OS socket \|
	+	\| apr_proc_mutex.h: \| APR Process Locking Routines \|
	+	\| apr_random.h: \| APR PRNG routines \|
	+	\| apr_ring.h: \| APR Rings \|
	+	\| apr_shm.h: \| APR Shared Memory Routines \|
	+	\| apr_signal.h: \| APR Signal Handling \|
	+	\| apr_skiplist.h: \| APR skip list implementation \|
	+	\| apr_strings.h: \| APR Strings library \|
	+	\| apr_support.h: \| APR Support functions \|
	+	\| apr_tables.h: \| APR Table library \|
	+	\| apr_thread_cond.h: \| APR Condition Variable Routines \|
	+	\| apr_thread_mutex.h: \| APR Thread Mutex Routines \|
	+	\| apr_thread_proc.h: \| APR Thread and Process Library \|
	+	\| apr_thread_rwlock.h: \| APR Reader/Writer Lock Routines \|
	+	\| apr_time.h: \| APR Time Library \|
	+	\| apr_user.h: \| APR User ID Services \|
	+	\| apr_version.h: \| APR Versioning Interface \|
	+	\| apr_want.h: \| APR Standard Headers Support \|
	+
	+	Details unter: [[https://apr.apache.org/docs/apr/1.6/files.html]]
	+
	+	===== Liste der APU-Module =====
	+
	+	apr-util-1.6.0:
	+	^ APU-Modul ^ Kommentar ^
	+	\| apr_anylock.h: \| APR-Util transparent any lock flavor wrapper \|
	+	\| apr_base64.h: \| APR-UTIL Base64 Encoding \|
	+	\| apr_buckets.h: \| APR-UTIL Buckets/Bucket Brigades \|
	+	\| apr_crypto.h: \| APR-UTIL Crypto library \|
	+	\| apr_crypto.h: \| Perform once-only initialisation. Call once only. \|
	+	\| apr_crypto.h: \| Zero out the buffer provided when the pool is cleaned up. \|
	+	\| apr_crypto.h: \| Always zero out the buffer provided, without being optimized out by \|
	+	\| apr_crypto.h: \| Timing attacks safe buffers comparison, where the executing time does \|
	+	\| apr_crypto.h: \| Get the driver struct for a name \|
	+	\| apr_crypto.h: \| Return the name of the driver. \|
	+	\| apr_crypto.h: \| Get the result of the last operation on a context. If the result \|
	+	\| apr_crypto.h: \| Create a context for supporting encryption. Keys, certificates, \|
	+	\| apr_crypto.h: \| Get a hash table of key types, keyed by the name of the type against \|
	+	\| apr_crypto.h: \| Get a hash table of key modes, keyed by the name of the mode against \|
	+	\| apr_crypto.h: \| Create a key from the provided secret or passphrase. The key is cleaned \|
	+	\| apr_crypto.h: \| Create a key from the given passphrase. By default, the PBKDF2 \|
	+	\| apr_crypto.h: \| Initialise a context for encrypting arbitrary data using the given key. \|
	+	\| apr_crypto.h: \| Encrypt data provided by in, write it to out. \|
	+	\| apr_crypto.h: \| Encrypt final data block, write it to out. \|
	+	\| apr_crypto.h: \| Initialise a context for decrypting arbitrary data using the given key. \|
	+	\| apr_crypto.h: \| Decrypt data provided by in, write it to out. \|
	+	\| apr_crypto.h: \| Decrypt final data block, write it to out. \|
	+	\| apr_crypto.h: \| Clean encryption / decryption context. \|
	+	\| apr_crypto.h: \| Clean encryption / decryption context. \|
	+	\| apr_crypto.h: \| Shutdown the crypto library. \|
	+	\| apr_date.h: \| APR-UTIL date routines \|
	+	\| apr_dbd.h: \| APR-UTIL DBD library \|
	+	\| apr_dbm.h: \| APR-UTIL DBM library \|
	+	\| apr_hooks.h: \| Apache hook functions \|
	+	\| apr_ldap.h: \| APR-UTIL LDAP \|
	+	\| apr_ldap_init.h: \| APR-UTIL LDAP ldap_init() functions \|
	+	\| apr_ldap_option.h: \| APR-UTIL LDAP ldap_*_option() functions \|
	+	\| apr_ldap_rebind.h: \| Apache LDAP library \|
	+	\| apr_ldap_url.h: \| APR-UTIL LDAP ldap_init() functions \|
	+	\| apr_md4.h: \| APR-UTIL MD4 Library \|
	+	\| apr_md5.h: \| APR MD5 Routines \|
	+	\| apr_memcache.h: \| Client interface for memcached \|
	+	\| apr_optional.h: \| APR-UTIL registration of functions exported by modules \|
	+	\| apr_optional_hooks.h: \| Apache optional hook functions \|
	+	\| apr_queue.h: \| Thread Safe FIFO bounded queue \|
	+	\| apr_redis.h: \| Client interface for redis \|
	+	\| apr_reslist.h: \| APR-UTIL Resource List Routines \|
	+	\| apr_rmm.h: \| APR-UTIL Relocatable Memory Management Routines \|
	+	\| apr_sdbm.h: \| apr-util SDBM library \|
	+	\| apr_sha1.h: \| APR-UTIL SHA1 library \|
	+	\| apr_siphash.h: \| APR-UTIL siphash library \|
	+	\| apr_siphash.h: \| Computes SipHash-c-d, producing a 64bit (APR_SIPHASH_DSIZE) hash \|
	+	\| apr_siphash.h: \| Computes SipHash-c-d, producing a 64bit (APR_SIPHASH_DSIZE) hash \|
	+	\| apr_siphash.h: \| Computes SipHash-2-4, producing a 64bit (APR_SIPHASH_DSIZE) hash \|
	+	\| apr_siphash.h: \| Computes SipHash-2-4, producing a 64bit (APR_SIPHASH_DSIZE) hash \|
	+	\| apr_siphash.h: \| Computes SipHash-4-8, producing a 64bit (APR_SIPHASH_DSIZE) hash \|
	+	\| apr_siphash.h: \| Computes SipHash-4-8, producing a 64bit (APR_SIPHASH_DSIZE) hash \|
	+	\| apr_strmatch.h: \| APR-UTIL string matching routines \|
	+	\| apr_thread_pool.h: \| APR Thread Pool Library \|
	+	\| apr_uri.h: \| APR-UTIL URI Routines \|
	+	\| apr_uuid.h: \| APR UUID library \|
	+	\| apr_xlate.h: \| APR I18N translation library \|
	+	\| apr_xml.h: \| APR-UTIL XML Library \|
	+	\| apu_errno.h: \| APR-Util Error Codes \|
	+	\| apu.h: \| APR-Utility main file \|
	+	\| apu_version.h: \| APR-util Versioning Interface \|
	+	\| apu_want.h: \| APR Standard Headers Support \|
	+
	+	----
	+	Stand: 26.10.2017
	+
	+	EOF

edv:prg:apache:hooks

Anonymous (anonymous@undisclosed.example.com) — 2020-01-11T01:23:29+00:00

	aktuell
Zeile 1:	Zeile 1:
	+	====== Weitere Hooks ======

	+	* ap_hook_child_init(): Place a hook that executes when a child process is spawned (commonly used for initializing modules after the server has forked).
	+	* ap_hook_pre_config(): Place a hook that executes before any configuration data has been read (very early hook).
	+	* ap_hook_post_config(): Place a hook that executes after configuration has been parsed, but before the server has forked.
	+	* ap_hook_translate_name(): Place a hook that executes when a URI needs to be translated into a filename on the server (think mod_rewrite).
	+	* ap_hook_quick_handler(): Similar to ap_hook_handler, except it is run before any other request hooks (translation, auth, fixups etc).
	+	* ap_hook_log_transaction(): Place a hook that executes when the server is about to add a log entry of the current request.
	+
	+	Komplette Liste befindet sich unter [[https://ci.apache.org/projects/httpd/trunk/doxygen/group__hooks.html]]
	+
	+	Auch das Apache-Modul modules/examples/mod_example_hooks.c bietet viel Infos über die Nutzung von Hooks.
	+
	+	----
	+	Stand: 26.07.2018
	+
	+	EOF

	aktuell
Zeile 1:	Zeile 1:
	+	====== APR, APR-Utils ======

	+	===== Liste der APR-Module =====
	+
	+	apr-1.6.2:
	+	^ APR-Modul ^ Kommentar ^
	+	\| apr_allocator.h: \| APR Internal Memory Allocation \|
	+	\| apr_atomic.h: \| APR Atomic Operations \|
	+	\| apr_cstr.h: \| C string goodies. \|
	+	\| apr_dso.h: \| APR Dynamic Object Handling Routines \|
	+	\| apr_env.h: \| APR Environment functions \|
	+	\| apr_errno.h: \| APR Error Codes \|
	+	\| apr_escape.h: \| APR-UTIL Escaping \|
	+	\| apr_file_info.h: \| APR File Information \|
	+	\| apr_file_io.h: \| APR File I/O Handling \|
	+	\| apr_fnmatch.h: \| APR FNMatch Functions \|
	+	\| apr_general.h: \| APR Miscellaneous library routines \|
	+	\| apr_getopt.h: \| APR Command Arguments (getopt) \|
	+	\| apr_global_mutex.h: \| APR Global Locking Routines \|
	+	\| apr.h: \| APR Platform Definitions \|
	+	\| apr_hash.h: \| APR Hash Tables \|
	+	\| apr_inherit.h: \| APR File Handle Inheritance Helpers \|
	+	\| apr_lib.h: \| APR general purpose library routines \|
	+	\| apr_mmap.h: \| APR MMAP routines \|
	+	\| apr_network_io.h: \| APR Network library \|
	+	\| apr_perms_set.h: \| APR Process Locking Routines \|
	+	\| apr_poll.h: \| APR Poll interface \|
	+	\| apr_pools.h: \| APR memory allocation \|
	+	\| apr_portable.h: \| APR Portability Routines \|
	+	\| apr_portable.h: \| alias for local OS socket \|
	+	\| apr_proc_mutex.h: \| APR Process Locking Routines \|
	+	\| apr_random.h: \| APR PRNG routines \|
	+	\| apr_ring.h: \| APR Rings \|
	+	\| apr_shm.h: \| APR Shared Memory Routines \|
	+	\| apr_signal.h: \| APR Signal Handling \|
	+	\| apr_skiplist.h: \| APR skip list implementation \|
	+	\| apr_strings.h: \| APR Strings library \|
	+	\| apr_support.h: \| APR Support functions \|
	+	\| apr_tables.h: \| APR Table library \|
	+	\| apr_thread_cond.h: \| APR Condition Variable Routines \|
	+	\| apr_thread_mutex.h: \| APR Thread Mutex Routines \|
	+	\| apr_thread_proc.h: \| APR Thread and Process Library \|
	+	\| apr_thread_rwlock.h: \| APR Reader/Writer Lock Routines \|
	+	\| apr_time.h: \| APR Time Library \|
	+	\| apr_user.h: \| APR User ID Services \|
	+	\| apr_version.h: \| APR Versioning Interface \|
	+	\| apr_want.h: \| APR Standard Headers Support \|
	+
	+	Details unter: [[https://apr.apache.org/docs/apr/1.6/files.html]]
	+
	+	===== Liste der APU-Module =====
	+
	+	apr-util-1.6.0:
	+	^ APU-Modul ^ Kommentar ^
	+	\| apr_anylock.h: \| APR-Util transparent any lock flavor wrapper \|
	+	\| apr_base64.h: \| APR-UTIL Base64 Encoding \|
	+	\| apr_buckets.h: \| APR-UTIL Buckets/Bucket Brigades \|
	+	\| apr_crypto.h: \| APR-UTIL Crypto library \|
	+	\| apr_crypto.h: \| Perform once-only initialisation. Call once only. \|
	+	\| apr_crypto.h: \| Zero out the buffer provided when the pool is cleaned up. \|
	+	\| apr_crypto.h: \| Always zero out the buffer provided, without being optimized out by \|
	+	\| apr_crypto.h: \| Timing attacks safe buffers comparison, where the executing time does \|
	+	\| apr_crypto.h: \| Get the driver struct for a name \|
	+	\| apr_crypto.h: \| Return the name of the driver. \|
	+	\| apr_crypto.h: \| Get the result of the last operation on a context. If the result \|
	+	\| apr_crypto.h: \| Create a context for supporting encryption. Keys, certificates, \|
	+	\| apr_crypto.h: \| Get a hash table of key types, keyed by the name of the type against \|
	+	\| apr_crypto.h: \| Get a hash table of key modes, keyed by the name of the mode against \|
	+	\| apr_crypto.h: \| Create a key from the provided secret or passphrase. The key is cleaned \|
	+	\| apr_crypto.h: \| Create a key from the given passphrase. By default, the PBKDF2 \|
	+	\| apr_crypto.h: \| Initialise a context for encrypting arbitrary data using the given key. \|
	+	\| apr_crypto.h: \| Encrypt data provided by in, write it to out. \|
	+	\| apr_crypto.h: \| Encrypt final data block, write it to out. \|
	+	\| apr_crypto.h: \| Initialise a context for decrypting arbitrary data using the given key. \|
	+	\| apr_crypto.h: \| Decrypt data provided by in, write it to out. \|
	+	\| apr_crypto.h: \| Decrypt final data block, write it to out. \|
	+	\| apr_crypto.h: \| Clean encryption / decryption context. \|
	+	\| apr_crypto.h: \| Clean encryption / decryption context. \|
	+	\| apr_crypto.h: \| Shutdown the crypto library. \|
	+	\| apr_date.h: \| APR-UTIL date routines \|
	+	\| apr_dbd.h: \| APR-UTIL DBD library \|
	+	\| apr_dbm.h: \| APR-UTIL DBM library \|
	+	\| apr_hooks.h: \| Apache hook functions \|
	+	\| apr_ldap.h: \| APR-UTIL LDAP \|
	+	\| apr_ldap_init.h: \| APR-UTIL LDAP ldap_init() functions \|
	+	\| apr_ldap_option.h: \| APR-UTIL LDAP ldap_*_option() functions \|
	+	\| apr_ldap_rebind.h: \| Apache LDAP library \|
	+	\| apr_ldap_url.h: \| APR-UTIL LDAP ldap_init() functions \|
	+	\| apr_md4.h: \| APR-UTIL MD4 Library \|
	+	\| apr_md5.h: \| APR MD5 Routines \|
	+	\| apr_memcache.h: \| Client interface for memcached \|
	+	\| apr_optional.h: \| APR-UTIL registration of functions exported by modules \|
	+	\| apr_optional_hooks.h: \| Apache optional hook functions \|
	+	\| apr_queue.h: \| Thread Safe FIFO bounded queue \|
	+	\| apr_redis.h: \| Client interface for redis \|
	+	\| apr_reslist.h: \| APR-UTIL Resource List Routines \|
	+	\| apr_rmm.h: \| APR-UTIL Relocatable Memory Management Routines \|
	+	\| apr_sdbm.h: \| apr-util SDBM library \|
	+	\| apr_sha1.h: \| APR-UTIL SHA1 library \|
	+	\| apr_siphash.h: \| APR-UTIL siphash library \|
	+	\| apr_siphash.h: \| Computes SipHash-c-d, producing a 64bit (APR_SIPHASH_DSIZE) hash \|
	+	\| apr_siphash.h: \| Computes SipHash-c-d, producing a 64bit (APR_SIPHASH_DSIZE) hash \|
	+	\| apr_siphash.h: \| Computes SipHash-2-4, producing a 64bit (APR_SIPHASH_DSIZE) hash \|
	+	\| apr_siphash.h: \| Computes SipHash-2-4, producing a 64bit (APR_SIPHASH_DSIZE) hash \|
	+	\| apr_siphash.h: \| Computes SipHash-4-8, producing a 64bit (APR_SIPHASH_DSIZE) hash \|
	+	\| apr_siphash.h: \| Computes SipHash-4-8, producing a 64bit (APR_SIPHASH_DSIZE) hash \|
	+	\| apr_strmatch.h: \| APR-UTIL string matching routines \|
	+	\| apr_thread_pool.h: \| APR Thread Pool Library \|
	+	\| apr_uri.h: \| APR-UTIL URI Routines \|
	+	\| apr_uuid.h: \| APR UUID library \|
	+	\| apr_xlate.h: \| APR I18N translation library \|
	+	\| apr_xml.h: \| APR-UTIL XML Library \|
	+	\| apu_errno.h: \| APR-Util Error Codes \|
	+	\| apu.h: \| APR-Utility main file \|
	+	\| apu_version.h: \| APR-util Versioning Interface \|
	+	\| apu_want.h: \| APR Standard Headers Support \|
	+
	+	----
	+	Stand: 26.10.2017
	+
	+	EOF