Man page - cupsd-logs(5)

Packages contains this manual

Available languages:

en fr pt de

Manual

cupsd-logs

NAME
BESCHREIBUNG
ZUGRIFFSPROTOKOLL-DATEIFORMAT
FEHLERPROTOKOLL-DATEIFORMAT
SEITENPROTOKOLL-DATEIFORMAT
SIEHE AUCH
COPYRIGHT

NAME

cupsd-logs - Cupsd-Protokolldateien (access_log, error_log und page_log)

BESCHREIBUNG

cupsd (8) verwaltet normalerweise drei Protokolldateien: access_log , um Anfragen, die an den Auftragsplaner eingereicht wurden, nachzuverfolgen, error_log , um den Fortgang und Fehler nachzuverfolgen und page_log , um gedruckte Seiten nachzuverfolgen. Konfigurationsdirektiven in cupsd.conf (5) und cups-files.conf (5) regeln, welche Informationen protokolliert und wo sie gespeichert werden.

ZUGRIFFSPROTOKOLL-DATEIFORMAT

Die Datei access_log fĂŒhrt jede HTTP-Ressource auf, auf die durch einen Web-Browser oder -Client zugegriffen wird. Jede Zeile ist eine ausfĂŒhrliche Version des sogenannten »Common Log Format«, wie es von vielen Web-Servern und Web-Berichtswerkzeugen verwandt wird:

Rechner Gruppe Benutzer Datum-Zeit " Methode Ressource Version " Status Bytes Ipp-Vorgang Ipp-Status

Zum Beispiel:

10.0.1.2 - - [01/Dec/2005:21:50:28 +0000] "POST / HTTP/1.1" 200 317
CUPS-Get-Printers successful-ok-ignored-or-substituted-attributes
localhost - - [01/Dec/2005:21:50:32 +0000] "GET /admin HTTP/1.1"
200 0 - -
localhost - - [01/Dec/2005:21:50:32 +0000] "POST / HTTP/1.1"
200 157 CUPS-Get-Printers
successful-ok-ignored-or-substituted-attributes
localhost - - [01/Dec/2005:21:50:32 +0000] "POST / HTTP/1.1"
200 1411 CUPS-Get-Devices -
localhost - - [01/Dec/2005:21:50:32 +0000] "GET /admin HTTP/1.1"
200 6667 - -

Das Feld Rechner enthÀlt normalerweise nur eine IP-Adresse, es sei denn, Sie haben die Direktive HostNameLookups in der Datei cupsd.conf aktiviert oder die IP-Adresse entspricht Ihrem lokalen Rechner.

Das Feld Gruppe enthÀlt immer »-«.

Das Feld Benutzer enthĂ€lt den authentifizierten Benutzernamen des anfragenden Benutzers. Falls kein Benutzername und Passwort fĂŒr die Anfrage bereitgestellt wurde, enthĂ€lt dieses Feld »-«.

Das Feld Datum-Zeit enthÀlt das Datum und die Uhrzeit der Anfrage in lokaler Zeit und im Format »[TT/MON/JJJJ:HH:MM:SS +ZZZZ]«.

Das Feld Methode enthĂ€lt die verwandte HTTP-Methode: »GET«, »HEAD«, »OPTIONS«, »POST« oder PUT«. »GET«-Anfragen werden verwandt, um Dateien vom Server zu erhalten, sowohl fĂŒr die Web-Schnittstelle als auch um die Konfigurations- und Protokolldateien zu erhalten. »HEAD«-Anfragen werden zum Erhalt von Informationen ĂŒber eine Ressource vor einem »GET« verwandt. »OPTIONS«-Anfragen werden zum Hochstufen einer Anfrage auf TLS-VerschlĂŒsselung verwandt. »POST«-Anfragen werden fĂŒr Webformulare und IPP-Anfragen verwandt. »PUT«-Anfragen dienen dem Hochladen von Konfigurationsdateien.

Das Feld Ressource ist der Dateiname der angefragten Ressource.

Das Feld Version ist die vom Client verwandte HTTP-Spezifikationsversion. FĂŒr CUPS-Clients wird sie stets »HTTP/1.1« sein.

Das Feld Status enthÀlt den HTTP-Ergebnisstatus der Anfrage, wie folgt:

200

Vorgang erfolgreich

201

Datei erfolgreich erstellt/verÀndert

304

Die angeforderte Datei hat sich nicht geÀndert.

400

Fehlerhafte HTTP-Anfrage. Typischerweise bedeutet dies, dass ein Schadprogramm einen Zugriff auf Ihren Server versucht.

401

Unauthorisiert, Authentifizierung (Benutzername + Passwort) wird benötigt.

403

Zugriff verboten; typischerweise bedeutet dies, dass ein Client versucht, auf eine Datei oder Ressource zuzugreifen, fĂŒr den sie keine Zugriffsrechte hat.

404

Die Datei oder Ressource existiert nicht.

405

URL-Zugriffsmethode ist nicht erlaubt. Typischerweise bedeutet dies, dass ein Web-Browser Ihren Server als Proxy verwendet.

413

Anfrage zu groß. Typischerweise bedeutet dies, dass ein Client versuchte, eine Datei zu drucken, die grĂ¶ĂŸer ist als MaxRequestSize erlaubt.

426

Hochstufen auf TLS-verschlĂŒsselte Verbindung

500

Server-Fehler. Typischerweise passiert dies, wenn der Server nicht in der Lage ist, eine Datei zu öffnen/zu erstellen. Schauen Sie in der Datei error_log fĂŒr weitere Details.

501

Der Client erbat VerschlĂŒsselung aber die UnterstĂŒtzung dafĂŒr ist nicht aktiviert/einkompiliert.

505

HTTP-Versionsnummer wird nicht unterstĂŒtzt. Typischerweise bedeutet dies, dass ein Schadprogramm versucht, auf Ihren Server zuzugreifen.

Das Feld Bytes enthĂ€lt die Anzahl an Bytes in der Anfrage. FĂŒr POST-Anfragen enthĂ€lt das Feld Bytes die Anzahl von Bytes in nicht IPP-Daten, die vom Client empfangen wurden.

Das Feld Ipp-Vorgang enthĂ€lt entweder »-« fĂŒr nicht IPP-Anfragen oder den IPP-Vorgangsnamen fĂŒr POST-Anfragen, die eine IPP-Anfrage enthalten.

Das Feld Ipp-Status enthĂ€lt entweder »-« fĂŒr nicht IPP-Anfragen oder den IPP-Status-Codenamen fĂŒr POST-Anfragen, die eine IPP-Antwort enthalten.

FEHLERPROTOKOLL-DATEIFORMAT

Die Datei error_log listet Nachrichten vom Auftragsplaner auf - Fehler, Warnungen usw. Die Direktive LogLevel in der Datei cupsd.conf (5) steuert, welche Nachrichten protokolliert werden:

Stufe Datum-Uhrzeit Nachricht

Zum Beispiel:

I [20/May/1999:19:18:28 +0000] [Job 1] Queued on ’DeskJet’ by ’mike’.
D [20/May/1999:19:18:28 +0000] [Job 1] argv[0]="DeskJet"
D [20/May/1999:19:18:28 +0000] [Job 1] argv[1]="1"
D [20/May/1999:19:18:28 +0000] [Job 1] argv[2]="mike"
D [20/May/1999:19:18:28 +0000] [Job 1] argv[3]="myjob"
D [20/May/1999:19:18:28 +0000] [Job 1] argv[4]="1"
D [20/May/1999:19:18:28 +0000] [Job 1] argv[5]="media=
na_letter_8.5x11in sides=one-sided"
D [20/May/1999:19:18:28 +0000] [Job 1] argv[6]="/var/spool/cups/
d000001-001"
I [20/May/1999:19:21:02 +0000] [Job 2] Queued on ’DeskJet’ by ’mike’.
I [20/May/1999:19:22:24 +0000] [Job 2] Canceled by ’mike’.

Das Feld Stufe enthÀlt den Typ der Nachricht:

A

Warnungsnachricht (LogLevel alert)

C

Kritische Fehlernachricht (LogLevel crit)

D

Fehlersuchnachricht (LogLevel debug)

d

Detaillierte Fehlersuchnachricht (LogLevel debug2)

E

Normale Fehlernachricht (LogLevel error)

I

Informative Nachricht (LogLevel info)

N

Hinweisnachricht (LogLevel notice)

W

Warnungsnachricht (LogLevel warn)

X

Notfallfehlernachricht (LogLevel emerg)

Das Feld Datum-Zeit enthÀlt das Datum und die Uhrzeit vom Beginn des Drucks. Das Format dieses Feldes ist identisch zu dem Datum-Uhrzeit-Feld in der Datei access_log .

Das Feld Nachricht enthÀlt eine formlose Textnachricht. Nachrichten von Auftragsfiltern haben den PrÀfix »[Job NNN]«, wobei »NNN« die Auftrags-ID ist.

SEITENPROTOKOLL-DATEIFORMAT

Die Datei page_log listet die Gesamtzahl an gedruckten Seiten (BlĂ€ttern) auf. StandardmĂ€ĂŸig enthĂ€lt jede Zeile die folgenden Informationen:

Drucker Benutzer Auftrags-ID Datum-Uhrzeit total Anzahl-BlÀtter Auftrags-Abrechnung Auftrags-erstellender-Rechnername Auftragsname Medium Seiten

Beispielsweise könnte der Eintrag fĂŒr einen zweiseitigen Auftrag namens »meinAuftrag« wie folgt aussehen:

DeskJet root 1 [20/May/1999:19:21:06 +0000] total 2 acme-123
localhost meinAuftrag na_letter_8.5x11in one-sided

Die Direktive PageLogFormat in der Datei cupsd.conf (5) kann zum Ändern der Information verwandt werden.

Das Feld Drucker enthÀlt den Namen des Druckers, der die Seite gedruckt hat. Falls Sie einen Auftrag an eine Druckerklasse gesendet haben, wird dieses Feld den Namen des Druckers enthalten, dem dieser Auftrag zugewiesen wurde.

Das Feld Benutzer enthÀlt den Namen des Benutzers (des IPP-Attributs requesting-user-name), der diesen Auftrag zum Druck eingereicht hat.

Das Feld Auftrags-ID enthÀlt die Auftragsnummer der im Druck befindlichen Seite.

Das Feld Datum-Uhrzeit enthÀlt das Datum und die Uhrzeit, zu dem der Druck der Seite begonnen wurde. Das Format dieses Feldes ist identisch zu dem Datum-Uhrzeit-Feld in der Datei access_log .

Das Feld Anzahl-BlĂ€tter stellt die Gesamtzahl an Seiten (BlĂ€ttern) bereit, auf die fĂŒr den Auftrag gedruckt wurde.

Das Feld Auftrags-Abrechnung enthÀlt eine Kopie der mit den IPP-Create-Job- oder -Print-Job-Anfragen bereitgestellten Attribute »job-billing« oder »job-account-id« oder »-«, falls keines der beiden bereitgestellt wurde.

Das Feld Auftrags-erstellender-Rechnername enthÀlt den Rechnernamen oder die IP-Adresse des Clients, der den Auftrag gedruckt hat.

Das Feld Auftragsname enthÀlt eine Kopie des mit der IPP-Anfrage »Create-Job« oder »Print-Job« bereitgestellten Attributes »job-name« oder »-«, falls keines bereitgestellt wurde.

Das Feld Medium enthÀlt eine Kopie des mit der IPP-Anfrage »Create-Job« oder »Print-Job« bereitgestellten Attribute »media« oder »media-col/media-size« oder »-«, falls keines der beiden bereitgestellt wurde.

Das Feld Seiten enthÀlt eine Kopie des mit der IPP-Anfrage »Create-Job« oder »Print-Job« bereitgestellten Attributs »sides« oder »-«, falls keines bereitgestellt wurde.

SIEHE AUCH

cupsd (8), cupsd.conf (5), cups-files.conf (5), CUPS-Online-Hilfe (http://localhost:631/help)

COPYRIGHT

Copyright © 2020-2024 by OpenPrinting.