[thirdparty/cups.git] / doc / help / ref-page_log.html

<HTML>
<!-- SECTION: References -->
<HEAD>
	<TITLE>page_log</TITLE>
</HEAD>
<BODY>

<P>The <VAR>page_log</VAR> file lists each page that is sent to a
printer. Each line contains the following information:</P>

<P CLASS="command">

printer user job-id date-time page-number num-copies job-billing<BR>

<BR>

DeskJet root 2 [20/May/1999:19:21:05 +0000] 1 1 acme-123<BR>

DeskJet root 2 [20/May/1999:19:21:05 +0000] 2 1 acme-123<BR>

</P>

<P>The <I>printer</I> 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.</P>

<P>The <I>user</I> field contains the name of the user (the IPP
<CODE>requesting-user-name</CODE> attribute) that submitted this
file for printing.</P>

<P>The <I>job-id</I> field contains the job number of the page
being printed. Job numbers are reset to 1 whenever the spool
directory (<VAR>/var/spool/cups</VAR>) is cleared, so don't
depend on this number being unique!</P>

<P>The <I>date-time</I> field contains the date and time of when
the page started printing. The format of this field is identical
to the <I>data-time</I> field in the <VAR>access_log</VAR>
file.</P>

<P>The <I>page-number</I> and <I>num-pages</I> fields contain the
page number and number of copies being printed of that page. For
printers that cannot produce copies on their own, the
<I>num-pages</I> field will always be 1.</P>

<P>The <I>job-billing</I> field contains a copy of the
<CODE>job-billing</CODE> attribute provided with the IPP
<CODE>Create-Job</CODE> or <CODE>Print-Job</CODE> requests or "-"
if none was provided.

</BODY>
</HTML>
Commit	Line	Data
ef416fc2	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>