Beschreibung sämtlicher mod_gzip-Status-Codes

Dieses Dokument beschreibt die Menge aller Status-Codes, welche mod_gzip 1.3.26.1a über seine Verarbeitung liefert und über die Feldbeschreibung %{mod_gzip_result}n zur Verwendung in Protokoll-Formaten bereit stellt.

Die Zeilennummern stammen noch aus mod_gzip 1.3.19.1a und werden wahrscheinlich demnächst verschwinden, da sich ihre Wartung seit der Verfügbarkeit von mod_gzip via CVS nicht mehr lohnt.

DECLINED:UNHANDLED_SUBREQ

Verursacher Bedeutung
mod_gzip_type_checker Es liegt eine Apache-interne Teil-Anforderung vor, ausgelöst durch die Verarbeitung einer 'normalen' Anforderung. Nur deren endgültiges Ergebnis wird von mod_gzip geprüft (und möglicherweise komprimiert).

DECLINED:UNHANDLED_REDIR

Verursacher Bedeutung
mod_gzip_type_checker Es liegt eine Apache-interne Weiterleitung vor, ausgelöst durch die Verarbeitung einer 'normalen' Anforderung. Nur deren endgültiges Ergebnis wird von mod_gzip geprüft (und möglicherweise komprimiert).

DECLINED:INIT1

Verursacher Bedeutung
mod_gzip_type_checker Das scheint eine Wertebelegung als Initialisierung zu sein - jedenfalls hat es keine unmittelbare Auswirkung auf den Lauf der Verarbeitung.

DECLINED:STATIC_GZ_FOUND

Verursacher Bedeutung
mod_gzip_type_checker Zu der angeforderten Datei wurde eine statisch komprimierte Version (mit der hart-codierten Dateinamens-Endung .gz) gefunden und durfte an den UserAgent ausgeliefert werden, anstatt die Original-Datei dynamisch komprimieren zu müssen.
mod_gzip_handler

DECLINED:FEXT_GZ

Verursacher Bedeutung
mod_gzip_type_checker Die Anforderung bezieht sich explizit auf eine statisch komprimierte Datei (mit der hart-codierten Dateinamens-Endung .gz); der Inhalt solcher Dateien wird unverändert ausgeliefert.
mod_gzip_handler

DECLINED:NO_DCONF

Verursacher Bedeutung
mod_gzip_type_checker Der dconf-Pointer hat den Wert NULL. mod_gzip kann seine Konfigurations-Struktur nicht ansprechen und damit die gesetzten Werte seiner Direktiven nicht abfragen.

DECLINED:OFF

Verursacher Bedeutung
mod_gzip_type_checker Der Komprimierung ist für den Definitionsbereich dieser Datei nicht eingeschaltet (mod_gzip_on No für die komplette Apache-Konfiguration, diesen Virtual Host, diesen Verzeichnisbaum oder diese .htaccess-Datei)

DECLINED:NOT_GET_OR_POST

Verursacher Bedeutung
mod_gzip_type_checker Die Anforderung verwendet keine der HTTP-Methoden GET bzw. POST, aber nur Daten dieser Methoden können sinnvollerweise komprimiert werden.

DECLINED:HEAD_REQUEST

Verursacher Bedeutung
mod_gzip_type_checker Diese Anforderung verwendet die HTTP-Methode HEAD; eine solche Anforderung bewirkt nicht die Erzeugung eines (komprimierbaren) Dokument-Inhalt, sondern lediglich die Erzeugung eines (nicht komprimierbaren) HTTP-Headers.

DECLINED:HTTP_LEVEL_TOO_LOW

Verursacher Bedeutung
mod_gzip_type_checker Die Anforderung verwendet eine HTTP-Protokoll-Version, die nicht so hoch ist, wie durch die Direktive mod_gzip_min_http mindestens gefordert wurde.

DECLINED:NO_GZIP

Verursacher Bedeutung
mod_gzip_type_checker Die Anforderung enthält zwar einen Accept-Encoding-Header, aber in dessen Liste der (von diesem UserAgent unterstützten) Kodierungen ist die Kodierung gzip nicht enthalten - der UserAgent versteht also offenbar keine gzip-komprimierten Daten.

DECLINED:NO_ACCEPT_ENCODING

Verursacher Bedeutung
mod_gzip_type_checker Die Anforderung enthält keinen Accept-Encoding-Header - der UserAgent versteht also offenbar keine gzip-komprimierten Daten.

DECLINED:NO_ITEMS_DEFINED

Verursacher Bedeutung
mod_gzip_type_checker Die Liste der Regeln (zur Entscheidung, ob der Inhalt der angeforderten Datei komprimiert werden soll) ist leer (weder mod_gzip_include_item noch mod_gzip_exclude_item wurden verwendet). Damit ist der normale Entscheidungsprozeß nicht durchführbar.

DECLINED:REQ_HEADER_FIELD_EXCLUDED

Verursacher Bedeutung
mod_gzip_type_checker Diese Anforderung wurde während der Analyse der Filter-Regeln (mod_gzip_validate1 (header_name, header_value, MOD_GZIP_REQUEST), Zeile 2511) von der Komprimierung ausgeschlossen.
(Es muß eine Regel vom Typ mod_gzip_exclude_item reqheader erfüllt gewesen sein - ein Fehlen jeglicher mod_gzip_include_item-Regeln kann nicht vorliegen, weil noch weitere Tests folgen werden.)

DECLINED:EXCLUDED

Verursacher Bedeutung
mod_gzip_type_checker Die Anforderung wurde während der Analyse der Filter-Regeln (mod_gzip_validate1 (file, uri, content_type, handler), Zeile 2612) von der Komprimierung ausgeschlossen, wobei die empfangenen HTTP-Header-Felder der Anforderung bereits erfolgreich gegenüber mod_gzip_exclude_item geprüft waren.
(Das ist leider nicht sehr aussagekräftig ... wenn hier wenigstens klar wäre, ob ein explizites mod_gzip_exclude_item vorlag - und ggf. von welcher Klasse - oder nur kein mod_gzip_include_item gefunden wurde ... !)

COMMAND:VERSION

Verursacher Bedeutung
mod_gzip_do_command Diese Anforderung bewirkte die Ausführung des mit der Direktive mod_gzip_command_version definierten Kommandos zur Status-Anzeige von mod_gzip selbst (Versionsnummer und 'on'/'off').
Die Ausgabe dieses Kommandos ist so kurz (weniger als 100 Bytes), daß sich eine Komprimierung des Inhaltes nicht lohnt.

DECLINED:INVALID_COMMAND

Verursacher Bedeutung
mod_gzip_do_command Irgendwas muß bei der Ausführung des internen Status-Kommandos schief gegangen sein.
(Mir ist aber nicht klar, ob und wann dieser Fall jemals auftreten kann.)

INIT2

Verursacher Bedeutung
mod_gzip_handler Das scheint eine Wertebelegung als Initialisierung zu sein - jedenfalls hat es keine unmittelbare Auswirkung auf den Lauf der Verarbeitung.

DECLINED:OFF2

Verursacher Bedeutung
mod_gzip_handler Der Komprimierung ist für den Definitionsbereich dieser Datei nicht eingeschaltet (mod_gzip_on No für die komplette Apache-Konfiguration, diesen Virtual Host, diesen Verzeichnisbaum oder diese .htaccess-Datei)

DECLINED:EXCLUDED_BY_HANDLER

Verursacher Bedeutung
mod_gzip_handler Die Anforderung wurde während der Analyse der Filter-Regeln (mod_gzip_validate1 (file, uri, content_type, handler), Zeile 3091) von der Komprimierung ausgeschlossen, wobei die empfangenen HTTP-Header-Felder der Anforderung bereits erfolgreich gegenüber mod_gzip_exclude_item geprüft waren.
(Das ist leider auch nicht besonders aussagekräftig; außerdem ist mir nicht klar, wieso das jetzt der Handler gewesen sein muß bzw. wieso dann die vier anderen Parameter noch an mod_gzip_validate1 übergeben wurden.)

RECOVERY

Verursacher Bedeutung
mod_gzip_handler Irgendwas ist bei der Ausführung von mod_gzip_redir1_handler schiefgegangen ... aber was? Wir werden jetzt einen internen Redirect machen müssen, wieso auch immer ... und in Zeile 3310 sogar dessen Statuscode über unseren eigenen drüber schreiben.

DECLINED:DYN1_OPENFAIL_BODY

Verursacher Bedeutung
mod_gzip_redir1_handler mod_gzip_dyn1_getfdo1 hat vergeblich versucht, eine neue Datei anzulegen.
(Dieser Zugriff wird in einem HTTP_INTERNAL_SERVER_ERROR enden - ein vernünftiges Ergebnis bekommen wir nicht mehr hin ... äh, wieso eigentlich? Können wir den Versuch einer Komprimierung schon nicht mehr abbrechen? Außerdem hätten wir an dieser Stelle eigentlich genauere Informationen, was passiert ist ... warum werden die nicht in den Status hinein codiert?)

STAT_FAILED

Verursacher Bedeutung
mod_gzip_sendfile2 Die zu sendende Datei ist nicht vorhanden (stat()-Returncode != 0); das ist wohl eines der "this can't happen"-Ereignisse.

CAP_FILE_EMPTY

Verursacher Bedeutung
mod_gzip_sendfile2 Wir haben eine zu sendende Datei (der stat()-Aufruf hat funktioniert), aber ihre Größe beträgt weniger als 1 Byte. Der zu komprimierende Inhalt des Dokuments scheint also irgendwie nicht bei uns angekommen zu sein, wieso auch immer.

CAP_FOPEN_FAILED

Verursacher Bedeutung
mod_gzip_sendfile2 Wir haben eine zu sendende Datei (der stat()-Aufruf hat funktioniert), aber der Versuch, sie zum Lesen zu öffnen (fopen(name,"rb")), ist gescheitert.

NO_HTTP_EOH

Verursacher Bedeutung
mod_gzip_sendfile2 Der HTTP-Header des während der aktuellen Anforderung erzeugten Ergebnisses wurde nicht korrekt abgeschlossen. (Beim Parsen des HTTP-Headers hätten wir in Zeile 5957 eine Leerzeile finden müssen.)
Einen solchen Header können wir nicht verarbeiten (wir müssen ihn ja für die Komprimierung teilweise umschreiben).

NO_HTTP_RESP_CODE

Verursacher Bedeutung
mod_gzip_sendfile2 Der HTTP-Header des während der aktuellen Anforderung erzeugten Ergebnisses enthält keinen Statuscode. (In der 1. Zeile des HTTP-Headers hätten wir in Zeile 5983 einen HTTP-Statuscode finden müssen.)
Etwas später werden wir aber genau diesen Statuscode prüfen wollen - das wird dann sicherlich nicht funktionieren können.

SEND_AS_IS:NO_200

Verursacher Bedeutung
mod_gzip_sendfile2 Der HTTP-Statuscode der erzeugten Antwort hat nicht den Wert 200 - und nur bei diesem Wert kann ein zu komprimierender Dokumentinhalt vorliegen.
(Hm ... und was ist mit den ganzen 404-Fehlerdokumenten?)

SEND_AS_IS:RESPONSE_FIELD_EXCLUDED

Verursacher Bedeutung
mod_gzip_sendfile2 Die Anforderung wurde während der Analyse der Filter-Regeln (mod_gzip_validate1 (header_name, header_value, MOD_GZIP_RESPONSE), Zeile 6081) von der Komprimierung ausgeschlossen.
(Das war jetzt offenbar ein HTTP-Header des Antwortdokuments, denn der Rest wurde nicht geprüft. Für ein DECLINED ist es bereits zu spät, das macht anscheinend nur vor dem eigentlichen Request Sinn ... ?)

SEND_AS_IS:NO_BODY

Verursacher Bedeutung
mod_gzip_sendfile2 Wir haben zwar einen Inhalt mit einem brauchbaren HTTP-Header, aber dieser Inhalt ist weniger als 1 Byte lang. Es ist einfach nichts da zum Komprimieren. (Dieser Statuscode tritt beispielsweise auf, wenn eine Datei mit 0 Bytes Inhalt angesprochen wird, etwa eine Dummy-robots.txt-Datei etc.)

SEND_AS_IS:UNKNOWN_TE_VALUE

Verursacher Bedeutung
mod_gzip_sendfile2 Im HTTP-Header des Ergebnisses der Anforderung ist ein Transfer-Encoding angegeben, und zwar ein anderes als chunked, welches das einzige wäre, mit dem wir fertig werden könnten (indem wir aus den chunks ein einziges Paket machen und dieses dann komprimieren).

SEND_AS_IS:HAS_CE

Verursacher Bedeutung
mod_gzip_sendfile2 Im HTTP-Header des Ergebnisses der Anforderung ist ein Content-Encoding angegeben, Theoretisch könnte man in HTTP mehrere Content-Encodings ineinander schachteln; die praktische Erfahrung zeigt allerdings, daß damit keiner der verfügbaren UserAgents vernünftig umgehen kann. Also lassen wir den Inhalt besser unverändert.

SEND_AS_IS:NO_CONTENT_TYPE_IN_RESPONSE_HEADER

Verursacher Bedeutung
mod_gzip_sendfile2 Der HTTP-Header des Ergebnisses der Anforderung enthält keinen Content-Type. (Beim Parsen der HTTP-Headers hätten wir in Zeile 6034 einen Content-type finden sollen.)
Nun ist allerdings ein Content-type laut HTTP kein Pflichtfeld; tatsächlich darf der UserAgent sogar einen Content-type raten, wenn vom Server keiner angegeben wurde. Andererseits basiert die wichtigste include-Regel auf diesem Content-type, und wenn da keiner vorhanden ist, dann wird es schwierig werden, eine entsprechende Regel zum Feuern zu bringen ...
Ich persönlich habe genau diese Prüfung aus mod_gzip ausgebaut, denn ich bekomme via mod_proxy Seiten von einem M$/IIS ohne Content-type (ich weiß aber, daß es text/html sein soll), die ich komprimiert weitersenden will ...

SEND_AS_IS:RESPONSE_CONTENT_TYPE_EXCLUDED

Verursacher Bedeutung
mod_gzip_sendfile2 Die Anforderung wurde während der Analyse der Filter-Regeln (mod_gzip_validate1 (CONTENT_TYPE), Zeile 6307) von der Komprimierung ausgeschlossen.

SEND_AS_IS:DECHUNK_OPTION_IS_OFF

Verursacher Bedeutung
mod_gzip_sendfile2 Es wurde ein Transfer-Encoding: chunked entdeckt, aber in der Konfiguration wurde mod_gzip nicht erlaubt, diese Codierung zu entfernen (d. h. alle chunks aufzusammeln und ein einziges Paket daraus zu erstellen, dessen Inhalt dann komprimierbar wäre). Die Direktive mod_gzip_dechunk Yes hätte mod_gzip erlaubt, diese Anforderung zu komprimieren.

SEND_AS_IS:FOPEN_FAILED

Verursacher Bedeutung
mod_gzip_sendfile2 Wir wollten gerade mit dem Komprimieren anfangen. Dazu wäre es notwendig gewesen, eine temporäre Datei zu öffnen, deren Namen wir zuvor von mod_gzip_create_unique_filename haben berechnen lassen. Aber der Versuch, diese Datei zum Schreiben zu öffnen, ist gescheitert - daher wird der Versuch, die Daten zu komprimieren, abgebrochen.
Dieser Fall kann insbesondere auch dann auftreten, falls mod_gzip gerade versucht hat, den veralteten Inhalt einer statisch vorkomprimierten Datei zu aktualisieren, aber kein Schreibrecht auf diese Datei besaß.

SEND_AS_IS:FSEEK_FAILED

Verursacher Bedeutung
mod_gzip_sendfile2 Wir wollten gerade mit dem Komprimieren anfangen. Nachdem die Eingabedatei erfolgreich geöffnet wurde, sollte jetzt in dieser Datei mit fseek (ifh,0,0) offenbar an deren Anfang positioniert werden - dies ist aber gescheitert.
(Mir ist noch nicht klar, wieso an dieser Stelle bereits entschieden ist, daß die Daten aus einer Datei gelesen werden müssen und nicht aus irgend einem Apache-Puffer ... wir sind noch nicht im de-chunking?)

SEND_AS_IS:BODY_MISSING

Verursacher Bedeutung
mod_gzip_sendfile2 Beim vorherigen Kopieren des Inhalts der zu komprimierenden Datei wurde festgestellt, daß der Inhalt dieser Datei aus 0 Bytes besteht - da macht es keinen Sinn, etwas zu komprimieren.

SEND_AS_IS:WORK_OPENFAIL

Verursacher Bedeutung
mod_gzip_open_output_file Der Versuch, die zuvor während der Komprimierung des Inhalts erzeugte Ausgabedatei wieder zum Lesen zu öffnen (um diese Daten zu senden), ist gescheitert.

OK / DECHUNK:OK

Verursacher Bedeutung
mod_gzip_encode_and_transmit Die Komprimierung wurde erfolgreich durchgeführt. (Dieser Wert wird zu Beginn der Verarbeitung als Default-Wert gesetzt und im Fehlerfall überschrieben.)

DECLINED:NO_ILEN / DECHUNK:DECLINED:NO_ILEN

Verursacher Bedeutung
mod_gzip_encode_and_transmit Die Länge des zu komprimierenden Inhalts ist kleiner als 1 Zeichen - da gibt es nichts zu tun.

DECLINED:TOO_SMALL / DECHUNK:DECLINED:TOO_SMALL

Verursacher Bedeutung
mod_gzip_encode_and_transmit Die Länge des zu komprimierenden Inhalts ist kleiner als der durch die Anweisung mod_gzip_minimum_file_size definierte Wert.

DECLINED:TOO_BIG / DECHUNK:DECLINED:TOO_BIG

Verursacher Bedeutung
mod_gzip_encode_and_transmit Die Länge des zu komprimierenden Inhalts ist größer als der durch die Anweisung mod_gzip_maximum_file_size definierte Wert.

DECLINED:NO_OLEN / DECHUNK:DECLINED:NO_OLEN

Verursacher Bedeutung
mod_gzip_encode_and_transmit Die Länge des komprimierten Inhalts ist kleiner als 1 Zeichen - da muß während der Komprimierung irgendwas schief gegangen sein.

DECLINED:ORIGINAL_SMALLER / DECHUNK:DECLINED:ORIGINAL_SMALLER

Verursacher Bedeutung
mod_gzip_encode_and_transmit Die Länge des komprimierten Inhalts ist kleiner als die Länge des Original-Inhalts - die Komprimierung hat also nicht zu einer Einsparung geführt. Deshalb wird der unkomprimierte Inhalt ausgeliefert.

DECLINED:REOPEN_FAILED / DECHUNK:DECLINED:REOPEN_FAILED

Verursacher Bedeutung
mod_gzip_encode_and_transmit Der Versuch, die zuvor während der Komprimierung des Inhalts erzeugte Ausgabedatei wieder zum Lesen zu öffnen (um diese Daten zu senden), ist gescheitert.

TRANSMIT_ERROR:ISMEM:%d:%s / DECHUNK:TRANSMIT_ERROR:ISMEM:%d:%s

Verursacher Bedeutung
mod_gzip_encode_and_transmit Fehler bei der Ausgabe komprimierter Daten aus dem Hauptspeicher (Meldung im in DEBUG-Modus)

TRANSMIT_ERROR:ISMEM:%d / DECHUNK:TRANSMIT_ERROR:ISMEM:%d

Verursacher Bedeutung
mod_gzip_encode_and_transmit Fehler bei der Ausgabe komprimierter Daten aus dem Hauptspeicher

TRANSMIT_ERROR:%d / DECHUNK:TRANSMIT_ERROR:%d:%s

Verursacher Bedeutung
mod_gzip_encode_and_transmit Fehler bei der Ausgabe komprimierter Daten aus der temporären Datei

TRANSMIT_ERROR:%d / DECHUNK:TRANSMIT_ERROR:%d

Verursacher Bedeutung
mod_gzip_encode_and_transmit Fehler bei der Ausgabe komprimierter Daten aus der temporären Datei

SEND_AS_IS:PRECOMPRESSED_VARIANT_OUTDATED

Verursacher Bedeutung
mod_gzip_handler (neu in mod_gzip 1.3.19.2a) Der Inhalt einer statisch vorkomprimierten Datei ist älter als derjenige der unkomprimierten Originaldatei. Daher wurde der Inhalt der Originaldatei (in unkomprimierter Form) ausgeliefert - besser korrekte Daten liefern als veraltete.

DECLINED:METHOD_EXCLUDED

Verursacher Bedeutung
mod_gzip_type_checker (neu in mod_gzip 1.3.19.2a) Die Anforderung dieses URL erfolgte mit einer HTTP-Methode, deren Ergebnisse nicht mit der Direktive mod_gzip_handle_methods als zu komprimieren deklariert wurden.

DECLINED:POST_TOO_BIG

Verursacher Bedeutung
mod_gzip_type_checker (neu in mod_gzip 1.3.26.1a) Der Inhalt eines HTTP-POST-Request ist größer als der verfügbare Puffer und kann von mod_gzip nicht korrekt verarbeitet werden - dieses Problem tritt nur unter Windows auf. Die Antwort auf diese Anforderung wird in unkomprimierter Form ausgeliefert.

OK:PRECOMPRESSED_VARIANT_UPDATED

Verursacher Bedeutung
mod_gzip_compress_file (neu in mod_gzip 1.3.26.1a) Während der Auslieferung des Inhalts einer statisch vorkomprimierten Datei wurde erkannt, daß deren Inhalt älter war als derjenige der zugehörigen Original-Datei. Der Inhalt der vorkomprimierten Datei wurde durch erneute Komprimierung des Original-Inhalts erfolgreich aktualisiert; der komprimierte Inhalt wurde anschließend ausgeliefert.

(Michael Schröpl, 2002-09-30)