CUPS Printed File Name Files

cups-printedfilename README

joan carles pineda <joan.carles.pineda@upc.edu>

cups-printedfilename is free software. Please see the file COPYING for details.
For building and installation instructions please see the INSTALL file.

What's cups-printedfilename ?
-----------------------------
cups-printedfilename is a console tool to display the printed file name and size (in KB) of the CUPS (Common Unix Printing System -- Copyright Apple Inc) print jobs.

cups-printedfilename extracts the printed file name and size from CUPS control files.


What is required ?
------------------
cups-printedfilename needs:

* CUPS print system


How does it work ?
------------------
You have to run the program with a jobid like a parameter and after that, it displays the printed file name and size corresponding to the job.

The program returns code execution errors:
        0 => execution OK
        1 => execution errors (problems with parameters, CUPS control files, etc.)

VERY IMPORTANT: You have to run cups-printerfilename like a superuser, because it needs to access to the CUPS control files.

Example 1
---------
We run the program directly from the root console to view the printed file name and size of the job 234:

	./cups-printedfilename 234
	evince-print 321KB

printed file name = evince-print
printed file size = 321KB

Example 2
---------
We run the program from non-superuser console to view the printed file name and size of the job 69:

	sudo ./cups-printedfilename 69
	[sudo] password for user: 
	logonXPdominiSAMBA.txt 1819KB

printed file name = logonXPdominiSAMBA.txt
printed file size = 1819KB

Example 3
---------
We run the program from non-superuser console to view the printed file name and size of the job 543:

	su -c "./cups-printedfilename 543"
	Password:
	smbprn.00000001 N0081604[1].pdf 378KB

printed file name = smbprn.00000001 N0081604[1].pdf
printed file size = 378KB