doc/help/page_log-reference.html

   1 <HTML>
   2 <!-- SECTION: References -->
   3 <HEAD>
   4         <TITLE>page_log</TITLE>
   5 </HEAD>
   6 <BODY>
   7
   8 <P>The <VAR>page_log</VAR> file lists each page that is sent to a
   9 printer. Each line contains the following information:</P>
  10
  11 <P CLASS="command">
  12
  13 printer user job-id date-time page-number num-copies job-billing<BR>
  14
  15 <BR>
  16
  17 DeskJet root 2 [20/May/1999:19:21:05 +0000] 1 1 acme-123<BR>
  18
  19 DeskJet root 2 [20/May/1999:19:21:05 +0000] 2 1 acme-123<BR>
  20
  21 </P>
  22
  23 <P>The <I>printer</I> field contains the name of the printer that
  24 printed the page. If you send a job to a printer class, this
  25 field will contain the name of the printer that was assigned the
  26 job.</P>
  27
  28 <P>The <I>user</I> field contains the name of the user (the IPP
  29 <CODE>requesting-user-name</CODE> attribute) that submitted this
  30 file for printing.</P>
  31
  32 <P>The <I>job-id</I> field contains the job number of the page
  33 being printed. Job numbers are reset to 1 whenever the spool
  34 directory (<VAR>/var/spool/cups</VAR>) is cleared, so don't
  35 depend on this number being unique!</P>
  36
  37 <P>The <I>date-time</I> field contains the date and time of when
  38 the page started printing. The format of this field is identical
  39 to the <I>data-time</I> field in the <VAR>access_log</VAR>
  40 file.</P>
  41
  42 <P>The <I>page-number</I> and <I>num-pages</I> fields contain the
  43 page number and number of copies being printed of that page. For
  44 printers that cannot produce copies on their own, the
  45 <I>num-pages</I> field will always be 1.</P>
  46
  47 <P>The <I>job-billing</I> field contains a copy of the
  48 <CODE>job-billing</CODE> attribute provided with the IPP
  49 <CODE>Create-Job</CODE> or <CODE>Print-Job</CODE> requests or "-"
  50 if none was provided.
  51
  52 </BODY>
  53 </HTML>