.\" .\" cupsd-logs man page for CUPS. .\" .\" Copyright © 2021-2023 by OpenPrinting. .\" Copyright © 2007-2019 by Apple Inc. .\" Copyright © 1997-2006 by Easy Software Products. .\" .\" Licensed under Apache License v2.0. See the file "LICENSE" for more .\" information. .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH cupsd\-logs 5 CUPS 2021\-02\-28 OpenPrinting .SH NAME cupsd\-logs \- Cupsd\-Protokolldateien (access_log, error_log und page_log) .SH BESCHREIBUNG \fBcupsd\fP(8) verwaltet normalerweise drei Protokolldateien: \fIaccess_log\fP, um Anfragen, die an den Auftragsplaner eingereicht wurden, nachzuverfolgen, \fIerror_log\fP, um den Fortgang und Fehler nachzuverfolgen und \fIpage_log\fP, um gedruckte Seiten nachzuverfolgen. Konfigurationsdirektiven in \fBcupsd.conf\fP(5) und \fBcups\-files.conf\fP(5) regeln, welche Informationen protokolliert und wo sie gespeichert werden. .SS ZUGRIFFSPROTOKOLL\-DATEIFORMAT Die Datei \fIaccess_log\fP 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: .nf \fIRechner Gruppe Benutzer Datum\-Zeit \fP"\fIMethode Ressource Version\fP" \fIStatus Bytes Ipp\-Vorgang Ipp\-Status\fP .fi Zum Beispiel: .nf 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 \- \- .fi Das Feld \fIRechner\fP enthält normalerweise nur eine IP\-Adresse, es sei denn, Sie haben die Direktive HostNameLookups in der Datei \fIcupsd.conf\fP aktiviert oder die IP\-Adresse entspricht Ihrem lokalen Rechner. .LP Das Feld \fIGruppe\fP enthält immer »\-«. .LP Das Feld \fIBenutzer\fP enthält den authentifizierten Benutzernamen des anfragenden Benutzers. Falls kein Benutzername und Passwort für die Anfrage bereitgestellt wurde, enthält dieses Feld »\-«. .LP Das Feld \fIDatum\-Zeit\fP enthält das Datum und die Uhrzeit der Anfrage in lokaler Zeit und im Format »[TT/MON/JJJJ:HH:MM:SS +ZZZZ]«. .LP Das Feld \fIMethode\fP 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. .LP Das Feld \fIRessource\fP ist der Dateiname der angefragten Ressource. .LP Das Feld \fIVersion\fP ist die vom Client verwandte HTTP\-Spezifikationsversion. Für CUPS\-Clients wird sie stets »HTTP/1.1« sein. .LP Das Feld \fIStatus\fP enthält den HTTP\-Ergebnisstatus der Anfrage, wie folgt: .RS 5 .TP 5 200 Vorgang erfolgreich .TP 5 201 Datei erfolgreich erstellt/verändert .TP 5 304 Die angeforderte Datei hat sich nicht geändert. .TP 5 400 Fehlerhafte HTTP\-Anfrage. Typischerweise bedeutet dies, dass ein Schadprogramm einen Zugriff auf Ihren Server versucht. .TP 5 401 Unauthorisiert, Authentifizierung (Benutzername + Passwort) wird benötigt. .TP 5 403 Zugriff verboten; typischerweise bedeutet dies, dass ein Client versucht, auf eine Datei oder Ressource zuzugreifen, für den sie keine Zugriffsrechte hat. .TP 5 404 Die Datei oder Ressource existiert nicht. .TP 5 405 URL\-Zugriffsmethode ist nicht erlaubt. Typischerweise bedeutet dies, dass ein Web\-Browser Ihren Server als Proxy verwendet. .TP 5 413 Anfrage zu groß. Typischerweise bedeutet dies, dass ein Client versuchte, eine Datei zu drucken, die größer ist als MaxRequestSize erlaubt. .TP 5 426 Hochstufen auf TLS\-verschlüsselte Verbindung .TP 5 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. .TP 5 501 Der Client erbat Verschlüsselung aber die Unterstützung dafür ist nicht aktiviert/einkompiliert. .TP 5 505 HTTP\-Versionsnummer wird nicht unterstützt. Typischerweise bedeutet dies, dass ein Schadprogramm versucht, auf Ihren Server zuzugreifen. .RE .LP Das Feld \fIBytes\fP 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. .LP Das Feld \fIIpp\-Vorgang\fP enthält entweder »\-« für nicht IPP\-Anfragen oder den IPP\-Vorgangsnamen für POST\-Anfragen, die eine IPP\-Anfrage enthalten. .LP Das Feld \fIIpp\-Status\fP enthält entweder »\-« für nicht IPP\-Anfragen oder den IPP\-Status\-Codenamen für POST\-Anfragen, die eine IPP\-Antwort enthalten. .SS FEHLERPROTOKOLL\-DATEIFORMAT Die Datei \fIerror_log\fP listet Nachrichten vom Auftragsplaner auf \- Fehler, Warnungen usw. Die Direktive LogLevel in der Datei \fBcupsd.conf\fP(5) steuert, welche Nachrichten protokolliert werden: .nf Stufe Datum\-Uhrzeit Nachricht .fi Zum Beispiel: .nf 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'. .fi Das Feld \fIStufe\fP enthält den Typ der Nachricht: .TP 5 A Warnungsnachricht (LogLevel alert) .TP 5 C Kritische Fehlernachricht (LogLevel crit) .TP 5 D Fehlersuchnachricht (LogLevel debug) .TP 5 d Detaillierte Fehlersuchnachricht (LogLevel debug2) .TP 5 E Normale Fehlernachricht (LogLevel error) .TP 5 I Informative Nachricht (LogLevel info) .TP 5 N Hinweisnachricht (LogLevel notice) .TP 5 W Warnungsnachricht (LogLevel warn) .TP 5 X Notfallfehlernachricht (LogLevel emerg) .LP Das Feld \fIDatum\-Zeit\fP 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 \fIaccess_log\fP. .LP Das Feld \fINachricht\fP enthält eine formlose Textnachricht. Nachrichten von Auftragsfiltern haben den Präfix »[Job NNN]«, wobei »NNN« die Auftrags\-ID ist. .SS SEITENPROTOKOLL\-DATEIFORMAT Die Datei \fIpage_log\fP listet die Gesamtzahl an gedruckten Seiten (Blättern) auf. Standardmäßig enthält jede Zeile die folgenden Informationen: .nf \fIDrucker Benutzer Auftrags\-ID Datum\-Uhrzeit \fP\fBtotal \fP\fIAnzahl\-Blätter Auftrags\-Abrechnung Auftrags\-erstellender\-Rechnername Auftragsname Medium Seiten\fP .fi Beispielsweise könnte der Eintrag für einen zweiseitigen Auftrag namens »meinAuftrag« wie folgt aussehen: .nf DeskJet root 1 [20/May/1999:19:21:06 +0000] total 2 acme\-123 localhost meinAuftrag na_letter_8.5x11in one\-sided .fi Die Direktive PageLogFormat in der Datei \fBcupsd.conf\fP(5) kann zum Ändern der Information verwandt werden. .LP Das Feld \fIDrucker\fP 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. .LP Das Feld \fIBenutzer\fP enthält den Namen des Benutzers (des IPP\-Attributs requesting\-user\-name), der diesen Auftrag zum Druck eingereicht hat. .LP Das Feld \fIAuftrags\-ID\fP enthält die Auftragsnummer der im Druck befindlichen Seite. .LP Das Feld \fIDatum\-Uhrzeit\fP 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 \fIaccess_log\fP. .LP Das Feld \fIAnzahl\-Blätter\fP stellt die Gesamtzahl an Seiten (Blättern) bereit, auf die für den Auftrag gedruckt wurde. .LP Das Feld \fIAuftrags\-Abrechnung\fP 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. .LP Das Feld \fIAuftrags\-erstellender\-Rechnername\fP enthält den Rechnernamen oder die IP\-Adresse des Clients, der den Auftrag gedruckt hat. .LP Das Feld \fIAuftragsname\fP enthält eine Kopie des mit der IPP\-Anfrage »Create\-Job« oder »Print\-Job« bereitgestellten Attributes »job\-name« oder »\-«, falls keines bereitgestellt wurde. .LP Das Feld \fIMedium\fP 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. .LP Das Feld \fISeiten\fP enthält eine Kopie des mit der IPP\-Anfrage »Create\-Job« oder »Print\-Job« bereitgestellten Attributs »sides« oder »\-«, falls keines bereitgestellt wurde. .SH "SIEHE AUCH" \fBcupsd\fP(8), \fBcupsd.conf\fP(5), \fBcups\-files.conf\fP(5), CUPS\-Online\-Hilfe (http://localhost:631/help) .SH COPYRIGHT Copyright \[co] 2021\-2023 by OpenPrinting.