|
Packit Service |
4ae4ad |
.\"
|
|
Packit Service |
4ae4ad |
.\" cupsd-logs man page for CUPS.
|
|
Packit Service |
4ae4ad |
.\"
|
|
Packit Service |
4ae4ad |
.\" Copyright 2007-2014 by Apple Inc.
|
|
Packit Service |
4ae4ad |
.\" Copyright 1997-2006 by Easy Software Products.
|
|
Packit Service |
4ae4ad |
.\"
|
|
Packit Service |
4ae4ad |
.\" These coded instructions, statements, and computer programs are the
|
|
Packit Service |
4ae4ad |
.\" property of Apple Inc. and are protected by Federal copyright
|
|
Packit Service |
4ae4ad |
.\" law. Distribution and use rights are outlined in the file "LICENSE.txt"
|
|
Packit Service |
4ae4ad |
.\" which should have been included with this file. If this file is
|
|
Packit Service |
4ae4ad |
.\" file is missing or damaged, see the license at "http://www.cups.org/".
|
|
Packit Service |
4ae4ad |
.\"
|
|
Packit Service |
4ae4ad |
.TH cupsd-logs 5 "CUPS" "11 June 2014" "Apple Inc."
|
|
Packit Service |
4ae4ad |
.SH NAME
|
|
Packit Service |
4ae4ad |
cupsd\-logs \- cupsd log files (access_log, error_log, and page_log)
|
|
Packit Service |
4ae4ad |
.SH DESCRIPTION
|
|
Packit Service |
4ae4ad |
.BR cupsd (8)
|
|
Packit Service |
4ae4ad |
normally maintains three log files: \fIaccess_log\fR to track requests that are submitted to the scheduler, \fIerror_log\fR to track progress and errors, and \fIpage_log\fR to track pages that are printed.
|
|
Packit Service |
4ae4ad |
Configuration directives in
|
|
Packit Service |
4ae4ad |
.BR cupsd.conf (5)
|
|
Packit Service |
4ae4ad |
and
|
|
Packit Service |
4ae4ad |
.BR cups-files.conf (5)
|
|
Packit Service |
4ae4ad |
control what information is logged and where it is stored.
|
|
Packit Service |
4ae4ad |
.SS ACCESS LOG FILE FORMAT
|
|
Packit Service |
4ae4ad |
The \fIaccess_log\fR file lists each HTTP resource that is accessed by a web browser or client.
|
|
Packit Service |
4ae4ad |
Each line is in an extended version of the so-called "Common Log Format" used by many web servers and web reporting tools:
|
|
Packit Service |
4ae4ad |
.nf
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
\fIhost group user date-time \fR"\fImethod resource version\fR" \fIstatus bytes
|
|
Packit Service |
4ae4ad |
ipp-operation ipp-status\fR
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
.fi
|
|
Packit Service |
4ae4ad |
For example:
|
|
Packit Service |
4ae4ad |
.nf
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
10.0.1.2 - - [01/Dec/2005:21:50:28 +0000] "POST / HTTP/1.1" 200 317
|
|
Packit Service |
4ae4ad |
CUPS-Get-Printers successful-ok-ignored-or-substituted-attributes
|
|
Packit Service |
4ae4ad |
localhost - - [01/Dec/2005:21:50:32 +0000] "GET /admin HTTP/1.1"
|
|
Packit Service |
4ae4ad |
200 0 - -
|
|
Packit Service |
4ae4ad |
localhost - - [01/Dec/2005:21:50:32 +0000] "POST / HTTP/1.1"
|
|
Packit Service |
4ae4ad |
200 157 CUPS-Get-Printers
|
|
Packit Service |
4ae4ad |
successful-ok-ignored-or-substituted-attributes
|
|
Packit Service |
4ae4ad |
localhost - - [01/Dec/2005:21:50:32 +0000] "POST / HTTP/1.1"
|
|
Packit Service |
4ae4ad |
200 1411 CUPS-Get-Devices -
|
|
Packit Service |
4ae4ad |
localhost - - [01/Dec/2005:21:50:32 +0000] "GET /admin HTTP/1.1"
|
|
Packit Service |
4ae4ad |
200 6667 - -
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
.fi
|
|
Packit Service |
4ae4ad |
The \fIhost\fR field will normally only be an IP address unless you have enabled the HostNameLookups directive in the \fIcupsd.conf\fR file or if the IP address corresponds to your local machine.
|
|
Packit Service |
4ae4ad |
.LP
|
|
Packit Service |
4ae4ad |
The \fIgroup\fR field always contains "-".
|
|
Packit Service |
4ae4ad |
.LP
|
|
Packit Service |
4ae4ad |
The \fIuser\fR field is the authenticated username of the requesting user.
|
|
Packit Service |
4ae4ad |
If no username and password is supplied for the request then this field contains "-".
|
|
Packit Service |
4ae4ad |
.LP
|
|
Packit Service |
4ae4ad |
The \fIdate-time\fR field is the date and time of the request in local time and is in the format "[DD/MON/YYYY:HH:MM:SS +ZZZZ]".
|
|
Packit Service |
4ae4ad |
.LP
|
|
Packit Service |
4ae4ad |
The \fImethod\fR field is the HTTP method used: "GET", "HEAD", "OPTIONS", "POST", or "PUT".
|
|
Packit Service |
4ae4ad |
"GET" requests are used to get files from the server, both for the web interface and to get configuration and log files.
|
|
Packit Service |
4ae4ad |
"HEAD" requests are used to get information about a resource prior to a "GET".
|
|
Packit Service |
4ae4ad |
"OPTIONS" requests are used to upgrade connections to TLS encryption.
|
|
Packit Service |
4ae4ad |
"POST" requests are used for web interface forms and IPP requests.
|
|
Packit Service |
4ae4ad |
"PUT" requests are used to upload configuration files.
|
|
Packit Service |
4ae4ad |
.LP
|
|
Packit Service |
4ae4ad |
The \fIresource\fR field is the filename of the requested resource.
|
|
Packit Service |
4ae4ad |
.LP
|
|
Packit Service |
4ae4ad |
The \fIversion\fR field is the HTTP specification version used by the client.
|
|
Packit Service |
4ae4ad |
For CUPS clients this will always be "HTTP/1.1".
|
|
Packit Service |
4ae4ad |
.LP
|
|
Packit Service |
4ae4ad |
The \fIstatus\fR field contains the HTTP result status of the request, as follows:
|
|
Packit Service |
4ae4ad |
.RS 5
|
|
Packit Service |
4ae4ad |
.TP 5
|
|
Packit Service |
4ae4ad |
200
|
|
Packit Service |
4ae4ad |
Successful operation.
|
|
Packit Service |
4ae4ad |
.TP 5
|
|
Packit Service |
4ae4ad |
201
|
|
Packit Service |
4ae4ad |
File created/modified successfully.
|
|
Packit Service |
4ae4ad |
.TP 5
|
|
Packit Service |
4ae4ad |
304
|
|
Packit Service |
4ae4ad |
The requested file has not changed.
|
|
Packit Service |
4ae4ad |
.TP 5
|
|
Packit Service |
4ae4ad |
400
|
|
Packit Service |
4ae4ad |
Bad HTTP request; typically this means that you have a malicious program trying to access your server.
|
|
Packit Service |
4ae4ad |
.TP 5
|
|
Packit Service |
4ae4ad |
401
|
|
Packit Service |
4ae4ad |
Unauthorized, authentication (username + password) is required.
|
|
Packit Service |
4ae4ad |
.TP 5
|
|
Packit Service |
4ae4ad |
403
|
|
Packit Service |
4ae4ad |
Access is forbidden; typically this means that a client tried to access a file or resource they do not have permission to access.
|
|
Packit Service |
4ae4ad |
.TP 5
|
|
Packit Service |
4ae4ad |
404
|
|
Packit Service |
4ae4ad |
The file or resource does not exist.
|
|
Packit Service |
4ae4ad |
.TP 5
|
|
Packit Service |
4ae4ad |
405
|
|
Packit Service |
4ae4ad |
URL access method is not allowed; typically this means you have a web browser using your server as a proxy.
|
|
Packit Service |
4ae4ad |
.TP 5
|
|
Packit Service |
4ae4ad |
413
|
|
Packit Service |
4ae4ad |
Request too large; typically this means that a client tried to print a file larger than the MaxRequestSize allows.
|
|
Packit Service |
4ae4ad |
.TP 5
|
|
Packit Service |
4ae4ad |
426
|
|
Packit Service |
4ae4ad |
Upgrading to TLS-encrypted connection.
|
|
Packit Service |
4ae4ad |
.TP 5
|
|
Packit Service |
4ae4ad |
500
|
|
Packit Service |
4ae4ad |
Server error; typically this happens when the server is unable to open/create a file - consult the error_log file for details.
|
|
Packit Service |
4ae4ad |
.TP 5
|
|
Packit Service |
4ae4ad |
501
|
|
Packit Service |
4ae4ad |
The client requested encryption but encryption support is not enabled/compiled in.
|
|
Packit Service |
4ae4ad |
.TP 5
|
|
Packit Service |
4ae4ad |
505
|
|
Packit Service |
4ae4ad |
HTTP version number not supported; typically this means that you have a malicious program trying to access your server.
|
|
Packit Service |
4ae4ad |
.RE
|
|
Packit Service |
4ae4ad |
.LP
|
|
Packit Service |
4ae4ad |
The \fIbytes\fR field contains the number of bytes in the request.
|
|
Packit Service |
4ae4ad |
For POST requests the bytes field contains the number of bytes of non-IPP data that is received from the client.
|
|
Packit Service |
4ae4ad |
.LP
|
|
Packit Service |
4ae4ad |
The \fIipp-operation\fR field contains either "-" for non-IPP requests or the IPP operation name for POST requests containing an IPP request.
|
|
Packit Service |
4ae4ad |
.LP
|
|
Packit Service |
4ae4ad |
The \fIipp-status\fR field contains either "-" for non-IPP requests or the IPP status code name for POST requests containing an IPP response.
|
|
Packit Service |
4ae4ad |
.SS ERROR LOG FILE FORMAT
|
|
Packit Service |
4ae4ad |
The \fIerror_log\fR file lists messages from the scheduler - errors, warnings, etc. The LogLevel directive in the
|
|
Packit Service |
4ae4ad |
.BR cupsd.conf (5)
|
|
Packit Service |
4ae4ad |
file controls which messages are logged:
|
|
Packit Service |
4ae4ad |
.nf
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
level date-time message
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
.fi
|
|
Packit Service |
4ae4ad |
For example:
|
|
Packit Service |
4ae4ad |
.nf
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
I [20/May/1999:19:18:28 +0000] [Job 1] Queued on 'DeskJet' by 'mike'.
|
|
Packit Service |
4ae4ad |
D [20/May/1999:19:18:28 +0000] [Job 1] argv[0]="DeskJet"
|
|
Packit Service |
4ae4ad |
D [20/May/1999:19:18:28 +0000] [Job 1] argv[1]="1"
|
|
Packit Service |
4ae4ad |
D [20/May/1999:19:18:28 +0000] [Job 1] argv[2]="mike"
|
|
Packit Service |
4ae4ad |
D [20/May/1999:19:18:28 +0000] [Job 1] argv[3]="myjob"
|
|
Packit Service |
4ae4ad |
D [20/May/1999:19:18:28 +0000] [Job 1] argv[4]="1"
|
|
Packit Service |
4ae4ad |
D [20/May/1999:19:18:28 +0000] [Job 1] argv[5]="media=
|
|
Packit Service |
4ae4ad |
na_letter_8.5x11in sides=one-sided"
|
|
Packit Service |
4ae4ad |
D [20/May/1999:19:18:28 +0000] [Job 1] argv[6]="/var/spool/cups/
|
|
Packit Service |
4ae4ad |
d000001-001"
|
|
Packit Service |
4ae4ad |
I [20/May/1999:19:21:02 +0000] [Job 2] Queued on 'DeskJet' by 'mike'.
|
|
Packit Service |
4ae4ad |
I [20/May/1999:19:22:24 +0000] [Job 2] Canceled by 'mike'.
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
.fi
|
|
Packit Service |
4ae4ad |
The \fIlevel\fR field contains the type of message:
|
|
Packit Service |
4ae4ad |
.TP 5
|
|
Packit Service |
4ae4ad |
A
|
|
Packit Service |
4ae4ad |
Alert message (LogLevel alert)
|
|
Packit Service |
4ae4ad |
.TP 5
|
|
Packit Service |
4ae4ad |
C
|
|
Packit Service |
4ae4ad |
Critical error message (LogLevel crit)
|
|
Packit Service |
4ae4ad |
.TP 5
|
|
Packit Service |
4ae4ad |
D
|
|
Packit Service |
4ae4ad |
Debugging message (LogLevel debug)
|
|
Packit Service |
4ae4ad |
.TP 5
|
|
Packit Service |
4ae4ad |
d
|
|
Packit Service |
4ae4ad |
Detailed debugging message (LogLevel debug2)
|
|
Packit Service |
4ae4ad |
.TP 5
|
|
Packit Service |
4ae4ad |
E
|
|
Packit Service |
4ae4ad |
Normal error message (LogLevel error)
|
|
Packit Service |
4ae4ad |
.TP 5
|
|
Packit Service |
4ae4ad |
I
|
|
Packit Service |
4ae4ad |
Informational message (LogLevel info)
|
|
Packit Service |
4ae4ad |
.TP 5
|
|
Packit Service |
4ae4ad |
N
|
|
Packit Service |
4ae4ad |
Notice message (LogLevel notice)
|
|
Packit Service |
4ae4ad |
.TP 5
|
|
Packit Service |
4ae4ad |
W
|
|
Packit Service |
4ae4ad |
Warning message (LogLevel warn)
|
|
Packit Service |
4ae4ad |
.TP 5
|
|
Packit Service |
4ae4ad |
X
|
|
Packit Service |
4ae4ad |
Emergency error message (LogLevel emerg)
|
|
Packit Service |
4ae4ad |
.LP
|
|
Packit Service |
4ae4ad |
The \fIdate-time\fR field contains the date and time of when the page started printing. The format of this field is identical to the data-time field in the \fIaccess_log\fR file.
|
|
Packit Service |
4ae4ad |
.LP
|
|
Packit Service |
4ae4ad |
The \fImessage\fR field contains a free-form textual message.
|
|
Packit Service |
4ae4ad |
Messages from job filters are prefixed with "[Job NNN]" where "NNN" is the job ID.
|
|
Packit Service |
4ae4ad |
.SS PAGE LOG FILE FORMAT
|
|
Packit Service |
4ae4ad |
The \fIpage_log\fR file lists each page or group of pages that are sent to a printer.
|
|
Packit Service |
4ae4ad |
By default, each line contains the following information:
|
|
Packit Service |
4ae4ad |
.nf
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
\fIprinter user job-id date-time page-number num-copies job-billing
|
|
Packit Service |
4ae4ad |
job-originating-host-name job-name media sides\fR
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
\fIprinter user job-id date-time \fBtotal \fInum-impressions job-billing
|
|
Packit Service |
4ae4ad |
job-originating-host-name job-name media sides\fR
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
.fi
|
|
Packit Service |
4ae4ad |
For example the entries for a two page job called "myjob" might look like:
|
|
Packit Service |
4ae4ad |
.nf
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
DeskJet root 1 [20/May/1999:19:21:05 +0000] 1 1 acme-123
|
|
Packit Service |
4ae4ad |
localhost myjob na_letter_8.5x11in one-sided
|
|
Packit Service |
4ae4ad |
DeskJet root 1 [20/May/1999:19:21:05 +0000] 2 1 acme-123
|
|
Packit Service |
4ae4ad |
localhost myjob na_letter_8.5x11in one-sided
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
DeskJet root 1 [20/May/1999:19:21:06 +0000] total 2 acme-123
|
|
Packit Service |
4ae4ad |
localhost myjob na_letter_8.5x11in one-sided
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
.fi
|
|
Packit Service |
4ae4ad |
The PageLogFormat directive in the
|
|
Packit Service |
4ae4ad |
.BR cupsd.conf (5)
|
|
Packit Service |
4ae4ad |
file can be used to change this information.
|
|
Packit Service |
4ae4ad |
.LP
|
|
Packit Service |
4ae4ad |
The \fIprinter\fR field contains the name of the printer that printed the page.
|
|
Packit Service |
4ae4ad |
If you send a job to a printer class, this field will contain the name of the printer that was assigned the job.
|
|
Packit Service |
4ae4ad |
.LP
|
|
Packit Service |
4ae4ad |
The \fIuser\fR field contains the name of the user (the IPP requesting-user-name attribute) that submitted this file for printing.
|
|
Packit Service |
4ae4ad |
.LP
|
|
Packit Service |
4ae4ad |
The \fIjob-id\fR field contains the job number of the page being printed.
|
|
Packit Service |
4ae4ad |
.LP
|
|
Packit Service |
4ae4ad |
The \fIdate-time\fR field contains the date and time of when the page started printing.
|
|
Packit Service |
4ae4ad |
The format of this field is identical to the data-time field in the \fIaccess_log\fR file.
|
|
Packit Service |
4ae4ad |
.LP
|
|
Packit Service |
4ae4ad |
The \fIpage-number\fR and \fInum-copies\fR fields contain the page number and number of copies being printed of that page.
|
|
Packit Service |
4ae4ad |
For printers that cannot produce copies on their own, the num-copies field will always be 1.
|
|
Packit Service |
4ae4ad |
.LP
|
|
Packit Service |
4ae4ad |
Lines containing the keyword "total" have a \fInum-impressions\fR field instead which provides the total number of impressions (sides) that have been printed on for the job.
|
|
Packit Service |
4ae4ad |
.LP
|
|
Packit Service |
4ae4ad |
The \fIjob-billing\fR field contains a copy of the job-billing or job-account-id attributes provided with the IPP Create-Job or Print-Job requests or "-" if neither was provided.
|
|
Packit Service |
4ae4ad |
.LP
|
|
Packit Service |
4ae4ad |
The \fIjob-originating-host-name\fR field contains the hostname or IP address of the client that printed the job.
|
|
Packit Service |
4ae4ad |
.LP
|
|
Packit Service |
4ae4ad |
The \fIjob-name\fR field contains a copy of the job-name attribute provided with the IPP Create-Job or Print-Job requests or "-" if none was provided.
|
|
Packit Service |
4ae4ad |
.LP
|
|
Packit Service |
4ae4ad |
The \fImedia\fR field contains a copy of the media or media-col/media-size attribute provided with the IPP Create-Job or Print-Job requests or "-" if none was provided.
|
|
Packit Service |
4ae4ad |
.LP
|
|
Packit Service |
4ae4ad |
The \fIsides\fR field contains a copy of the sides attribute provided with the IPP Create-Job or Print-Job requests or "-" if none was provided.
|
|
Packit Service |
4ae4ad |
.SH SEE ALSO
|
|
Packit Service |
4ae4ad |
.BR cupsd (8),
|
|
Packit Service |
4ae4ad |
.BR cupsd.conf (5),
|
|
Packit Service |
4ae4ad |
.BR cups-files.conf (5),
|
|
Packit Service |
4ae4ad |
CUPS Online Help (http://localhost:631/help)
|
|
Packit Service |
4ae4ad |
.SH COPYRIGHT
|
|
Packit Service |
4ae4ad |
Copyright \[co] 2007-2017 by Apple Inc.
|