'\" te
.\" This -*- nroff -*- source file is part of foomatic.
.\"
.TH FOOMATIC-PRINTJOB 1 "2001-01-06" "Foomatic Project"
.SH NAME
foomatic-printjob \- manage printer jobs in a spooler-independent fashion
.SH SYNOPSIS
.B foomatic-printjob [ -s spooler ] [ -P queuename ] 
.B [ -o option1=value1 -o option2 ... ] [ -i ] 
.B [ file1 file2 ... ]

.B foomatic-printjob -Q [ -s spooler ] [ -P queuename ] [ -i ] [ -a ]
.B [ user1 user2 ... ]

.B foomatic-printjob -R [ -s spooler ] [ -P queuename ] [ -i ] 
.B [ \- | jobid1 jobid2 ... ]

.B foomatic-printjob -C [ -s spooler ] [ -i ] command [ arguments ]

.B foomatic-printjob -S [ -s spooler ] [ -i ]

.B foomatic-printjob -h [ -s spooler ] [ -P queuename ] [ -i ]

.SH DESCRIPTION
.B foomatic-printjob
provides a spooler-independent interface to creating and managing
printer jobs and print queues.  Note that the first argument changes
the mode of the command, as it combines the functionality of several
System V-style printing commands.

.SS OPTIONS
.TP 10
.BI \-s spooler
Explicit spooler type.

.TP 10
.BI \-P queuename
Any commands specified should apply to this queue instead of the default.

.TP 10
.BI \-o option=value
Set option to value

.TP 10
.BI \-o option
Set the switch option

.TP 10
.BI \-# n
Print n copies

.TP 10
.BI file1\ \ file2\ \ ...
Files to be printed, when no file is given, standard input will be printed

.TP 10
.BI \-Q
Query the jobs in a queue.  If a list of users is specified, only
those users' jobs will be queried.

.TP 10
.BI \-Q\ \-a
Query the jobs in all queues.  If a list of users is specified, only
those users' jobs will be queried.

.TP 10
.BI \-R\ [\ \-\ |\ jobid1\ jobid2\ ...\ ]
Remove a job from a queue.  Using \fI-\fR will remove all jobs.

.TP 10
.BI \-C\ command\ [\ arguments\ ]
Execute control commands for queue/job manipulation.  The commands are
the ones of the BSD "lpc" utility. Use the control command "help" to
get a list of supported commands. Note: the amount of commands varies
with the spooler, but the same commands given under different spoolers
do the same thing.

.TP 10
.BI \-i
Interactive mode: You will be asked if foomatic-printjob is in doubt
about something. Otherwise foomatic-printjob uses auto-detection or
quits with an error.

.TP 10
.BI \-S
Save the chosen spooler as the default spooler

.TP 10
.BI \-h
Show this message or show a list of available options if a queue is specified


.\" Oracle has added the ARC stability level to this manual page
.SH ATTRIBUTES
See
.BR attributes (5)
for descriptions of the following attributes:
.sp
.TS
box;
cbp-1 | cbp-1
l | l .
ATTRIBUTE TYPE	ATTRIBUTE VALUE 
=
Availability	print/cups/filter/foomatic-db-engine
=
Stability	Volatile
.TE 
.PP
.SH SEE ALSO
foomatic-configure(1) and the documentation for your print spooler.

.SH AUTHOR
Manfred Wassmann <\fImanolo@NCC-1701.B.Shuttle.de\fR> and Chris
Lawrence <\fIlawrencc@debian.org\fR> for the foomatic project using
output from the associated binary.

.SH BUGS
This manpage still needs some editing.


.SH NOTES

.\" Oracle has added source availability information to this manual page
This software was built from source available at https://java.net/projects/solaris-userland.  The original community source was downloaded from  /foomatic-db-engine-3.0-20080903.tar.gz

Further information about this software can be found on the open source community website at http://www.linuxfoundation.org/collaborate/workgroups/openprinting/database/foomatic/.