doc/help/ref-page_log.html

   1 <HTML>
   2 <!-- SECTION: References -->
   3 <HEAD>
   4         <TITLE>page_log</TITLE>
   5         <LINK REL="STYLESHEET" TYPE="text/css" HREF="../cups-printable.css">
   6 </HEAD>
   7 <BODY>
   8
   9 <H1 CLASS="title">page_log</H1>
  10
  11 <P>The <VAR>page_log</VAR> file lists each page that is sent to a
  12 printer. By default, each line contains the following information:</P>
  13
  14 <P CLASS="command">
  15
  16 printer user job-id date-time page-number num-copies job-billing job-originating-host-name job-name media sides<BR>
  17
  18 <BR>
  19
  20 DeskJet root 2 [20/May/1999:19:21:05 +0000] 1 1 acme-123 localhost myjob letter one-sided<BR>
  21
  22 DeskJet root 2 [20/May/1999:19:21:05 +0000] 2 1 acme-123 localhost myjob letter one-sided<BR>
  23
  24 </P>
  25
  26 <p>The <a href="ref-cupsd_conf.html#PageLogFormat"><code>PageLogFormat</code></a>
  27 directive can be used to change this information.</p>
  28
  29 <P>The <I>printer</I> field contains the name of the printer that
  30 printed the page. If you send a job to a printer class, this
  31 field will contain the name of the printer that was assigned the
  32 job.</P>
  33
  34 <P>The <I>user</I> field contains the name of the user (the IPP
  35 <CODE>requesting-user-name</CODE> attribute) that submitted this
  36 file for printing.</P>
  37
  38 <P>The <I>job-id</I> field contains the job number of the page
  39 being printed. Job numbers are reset to 1 whenever the spool
  40 directory (<VAR>/var/spool/cups</VAR>) is cleared, so don't
  41 depend on this number being unique!</P>
  42
  43 <P>The <I>date-time</I> field contains the date and time of when
  44 the page started printing. The format of this field is identical
  45 to the <I>data-time</I> field in the <VAR>access_log</VAR>
  46 file.</P>
  47
  48 <P>The <I>page-number</I> and <I>num-pages</I> fields contain the
  49 page number and number of copies being printed of that page. For
  50 printers that cannot produce copies on their own, the
  51 <I>num-pages</I> field will always be 1.</P>
  52
  53 <P>The <I>job-billing</I> field contains a copy of the
  54 <CODE>job-billing</CODE> attribute provided with the IPP
  55 <CODE>Create-Job</CODE> or <CODE>Print-Job</CODE> requests or "-"
  56 if none was provided.
  57
  58 <P>The <I>job-originating-host-name</I> field contains the hostname or IP
  59 address of the client that printed the job.</P>
  60
  61 <P>The <I>job-name</I> field contains a copy of the
  62 <CODE>job-name</CODE> attribute provided with the IPP
  63 <CODE>Create-Job</CODE> or <CODE>Print-Job</CODE> requests or "-"
  64 if none was provided.
  65
  66 <P>The <I>media</I> field contains a copy of the
  67 <CODE>media</CODE> attribute provided with the IPP
  68 <CODE>Create-Job</CODE> or <CODE>Print-Job</CODE> requests or "-"
  69 if none was provided.
  70
  71 <P>The <I>sides</I> field contains a copy of the
  72 <CODE>sides</CODE> attribute provided with the IPP
  73 <CODE>Create-Job</CODE> or <CODE>Print-Job</CODE> requests or "-"
  74 if none was provided.
  75
  76 </BODY>
  77 </HTML>