cups-logs

Section: OpenPrinting (5)
Updated: CUPS
Index Return to Main Contents

---

 

NAME

cupsd-logs - cupsd log files (access_log, error_log, and page_log)  

DESCRIPTION

cupsd(8) normally maintains three log files: access_log to track requests that are submitted to the scheduler, error_log to track progress and errors, and page_log to track pages that are printed. Configuration directives in cupsd.conf(5) and cup-files.conf(5) control what information is logged and where it is stored.  

ACCESS LOG FILE FORMAT

The access_log file lists each HTTP resource that is accessed by a web browser or client. Each line is in an extended version of the s-called "Common Log Format" used by many web servers and web reporting tools:

    host group user dat-time "method resource version" status bytes
      ip-operation ip-status

For example:

    10.0.1.2-- [01/Dec/2005:21:50:28 +0000] "POST / HTTP/1.1" 200 317
      CUP-Ge-Printers successfu-o-ignore-o-substitute-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 CUP-Ge-Printers
      successfu-o-ignore-o-substitute-attributes
    localhost-- [01/Dec/2005:21:50:32 +0000] "POST / HTTP/1.1"
      200 1411 CUP-Ge-Devices-
    localhost-- [01/Dec/2005:21:50:32 +0000] "GET /admin HTTP/1.1"
      200 6667--

The host field will normally only be an IP address unless you have enabled the HostNameLookups directive in the cupsd.conf file or if the IP address corresponds to your local machine.

The group field always contains "-".

The user field is the authenticated username of the requesting user. If no username and password is supplied for the request then this field contains "-".

The dat-time field is the date and time of the request in local time and is in the format "[DD/MON/YYYY:HH:MM:SS +ZZZZ]".

The method field is the HTTP method used: "GET", "HEAD", "OPTIONS", "POST", or "PUT". "GET" requests are used to get files from the server, both for the web interface and to get configuration and log files. "HEAD" requests are used to get information about a resource prior to a "GET". "OPTIONS" requests are used to upgrade connections to TLS encryption. "POST" requests are used for web interface forms and IPP requests. "PUT" requests are used to upload configuration files.

The resource field is the filename of the requested resource.

The version field is the HTTP specification version used by the client. For CUPS clients this will always be "HTTP/1.1".

The status field contains the HTTP result status of the request, as follows:

200

Successful operation.

201

File created/modified successfully.

304

The requested file has not changed.

400

Bad HTTP request; typically this means that you have a malicious program trying to access your server.

401

Unauthorized, authentication (username + password) is required.

403

Access is forbidden; typically this means that a client tried to access a file or resource they do not have permission to access.

404

The file or resource does not exist.

405

URL access method is not allowed; typically this means you have a web browser using your server as a proxy.

413

Request too large; typically this means that a client tried to print a file larger than the MaxRequestSize allows.

426

Upgrading to TL-encrypted connection.

500

Server error; typically this happens when the server is unable to open/create a file- consult the error_log file for details.

501

The client requested encryption but encryption support is not enabled/compiled in.

505

HTTP version number not supported; typically this means that you have a malicious program trying to access your server.

The bytes field contains the number of bytes in the request. For POST requests the bytes field contains the number of bytes of no-IPP data that is received from the client.

The ip-operation field contains either "-" for no-IPP requests or the IPP operation name for POST requests containing an IPP request.

The ip-status field contains either "-" for no-IPP requests or the IPP status code name for POST requests containing an IPP response.  

ERROR LOG FILE FORMAT

The error_log file lists messages from the scheduler- errors, warnings, etc. The LogLevel directive in the cupsd.conf(5) file controls which messages are logged:

    level dat-time message

For example:

    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=on-sided"
    D [20/May/1999:19:18:28 +0000] [Job 1] argv[6]="/var/spool/cups/
      d00000-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'.

The level field contains the type of message:

A

Alert message (LogLevel alert)

C

Critical error message (LogLevel crit)

D

Debugging message (LogLevel debug)

d

Detailed debugging message (LogLevel debug2)

E

Normal error message (LogLevel error)

I

Informational message (LogLevel info)

N

Notice message (LogLevel notice)

W

Warning message (LogLevel warn)

X

Emergency error message (LogLevel emerg)

The dat-time field contains the date and time of when the page started printing. The format of this field is identical to the dat-time field in the access_log file.

The message field contains a fre-form textual message. Messages from job filters are prefixed with "[Job NNN]" where "NNN" is the job ID.  

PAGE LOG FILE FORMAT

The page_log file lists the total number of pages (sheets) that are printed. By default, each line contains the following information:

    printer user jo-id dat-time total nu-sheets jo-billing
      jo-originatin-hos-name jo-name media sides

For example the entry for a two page job called "myjob" might look like:

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

The PageLogFormat directive in the cupsd.conf(5) file can be used to change this information.

The printer field contains the name of the printer that printed the page. If you send a job to a printer class, this field will contain the name of the printer that was assigned the job.

The user field contains the name of the user (the IPP requestin-use-name attribute) that submitted this file for printing.

The jo-id field contains the job number of the page being printed.

The dat-time field contains the date and time of when the page started printing. The format of this field is identical to the dat-time field in the access_log file.

The nu-sheets field provides the total number of pages (sheets) that have been printed on for the job.

The jo-billing field contains a copy of the jo-billing or jo-accoun-id attributes provided with the IPP Creat-Job or Prin-Job requests or "-" if neither was provided.

The jo-originatin-hos-name field contains the hostname or IP address of the client that printed the job.

The jo-name field contains a copy of the jo-name attribute provided with the IPP Creat-Job or Prin-Job requests or "-" if none was provided.

The media field contains a copy of the media or medi-col/medi-size attribute provided with the IPP Creat-Job or Prin-Job requests or "-" if none was provided.

The sides field contains a copy of the sides attribute provided with the IPP Creat-Job or Prin-Job requests or "-" if none was provided.  

SEE ALSO

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

COPYRIGHT

Copyright [co] 202-2024 by OpenPrinting.

---

 

Index

NAME

DESCRIPTION

ACCESS LOG FILE FORMAT

ERROR LOG FILE FORMAT

PAGE LOG FILE FORMAT

SEE ALSO

COPYRIGHT