man/lp.man

   1 .\"
   2 .\" "$Id: lp.man 4493 2005-02-18 02:09:53Z mike $"
   3 .\"
   4 .\"   lp/cancel man page for the Common UNIX Printing System (CUPS).
   5 .\"
   6 .\"   Copyright 1997-2005 by Easy Software Products.
   7 .\"
   8 .\"   These coded instructions, statements, and computer programs are the
   9 .\"   property of Easy Software Products and are protected by Federal
  10 .\"   copyright law.  Distribution and use rights are outlined in the file
  11 .\"   "LICENSE.txt" which should have been included with this file.  If this
  12 .\"   file is missing or damaged please contact Easy Software Products
  13 .\"   at:
  14 .\"
  15 .\"       Attn: CUPS Licensing Information
  16 .\"       Easy Software Products
  17 .\"       44141 Airport View Drive, Suite 204
  18 .\"       Hollywood, Maryland 20636 USA
  19 .\"
  20 .\"       Voice: (301) 373-9600
  21 .\"       EMail: cups-info@cups.org
  22 .\"         WWW: http://www.cups.org
  23 .\"
  24 .TH lp 1 "Common UNIX Printing System" "1 May 2003" "Easy Software Products"
  25 .SH NAME
  26 lp \- print files
  27 .br
  28 cancel \- cancel jobs
  29 .SH SYNOPSIS
  30 .B lp
  31 [ -E ] [ \-c ] [ \-d
  32 .I destination
  33 ] [ \-h
  34 .I server
  35 ] [ \-m ] [ \-n
  36 .I num-copies
  37 [ \-o
  38 .I option
  39 ] [ \-q
  40 .I priority
  41 ] [ \-s ] [ \-t
  42 .I title
  43 ] [ \-H
  44 .I handling
  45 ] [ \-P
  46 .I page-list
  47 ] [
  48 .I file(s)
  49 ]
  50 .br
  51 .B lp
  52 [ -E ] [ \-c ] [ \-h
  53 .I server
  54 ] [ \-i
  55 .I job-id
  56 ] [ \-n
  57 .I num-copies
  58 [ \-o
  59 .I option
  60 ] [ \-q
  61 .I priority
  62 ] [ \-t
  63 .I title
  64 ] [ \-H
  65 .I handling
  66 ] [ \-P
  67 .I page-list
  68 ]
  69 .br
  70 .B cancel
  71 [ \-a ] [ -h
  72 .I server
  73 ] [ -u
  74 .I username
  75 ] [
  76 .I id
  77 ] [
  78 .I destination
  79 ] [
  80 .I destination-id
  81 ]
  82 .SH DESCRIPTION
  83 \fBlp\fR submits files for printing or alters a pending job. Use
  84 a filename of "-" to force printing from the standard input.
  85 .LP
  86 \fBcancel\fR cancels existing print jobs. The \fI-a\fR option will remove
  87 all jobs from the specified destination.
  88 .SH OPTIONS
  89 The following options are recognized by \fBlp\fR:
  90 .TP 5
  91 \-E
  92 .br
  93 Forces encryption when connecting to the server.
  94 .TP 5
  95 \-c
  96 .br
  97 This option is provided for backwards-compatibility only. On
  98 systems that support it, this option forces the print file to be
  99 copied to the spool directory before printing. In CUPS, print
 100 files are always sent to the scheduler via IPP which has the
 101 same effect.
 102 .TP 5
 103 \-d \fIdestination\fR
 104 .br
 105 Prints files to the named printer.
 106 .TP 5
 107 \-h \fIhostname\fR
 108 .br
 109 Specifies the print server hostname. The default is "localhost" or the value
 110 of the CUPS_SERVER environment variable.
 111 .TP 5
 112 \-i \fIjob-id\fR
 113 .br
 114 Specifies an existing job to modify.
 115 .TP 5
 116 \-m
 117 .br
 118 Send email when the job is completed (not supported CUPS 1.1.)
 119 .TP 5
 120 \-n \fIcopies\fR
 121 .br
 122 Sets the number of copies to print from 1 to 100.
 123 .TP 5
 124 \-o \fIoption\fR
 125 .br
 126 Sets a job option.
 127 .TP 5
 128 \-q \fIpriority\fR
 129 .br
 130 Sets the job priority from 1 (lowest) to 100 (highest). The
 131 default priority is 50.
 132 .TP 5
 133 \-s
 134 .br
 135 Do not report the resulting job IDs (silent mode.)
 136 .TP 5
 137 \-t \fIname\fR
 138 .br
 139 Sets the job name.
 140 .TP 5
 141 \-u \fIusername\fR
 142 .br
 143 Cancels jobs owned by \fIusername\fR.
 144 .TP 5
 145 \-H \fIhandling\fR
 146 .br
 147 Specifies when the job should be printed. A value of
 148 \fIimmediate\fR will print the file immediately, a value of
 149 \fIhold\fR will hold the job indefinitely, and a time value
 150 (HH:MM) will hold the job until the specified time. Use a value
 151 of \fIresume\fR with the \fI-i\fR option to resume a held job.
 152 Use a value of \fIrestart\fR with the \fI-i\fR option to restart
 153 a completed job.
 154 .TP 5
 155 \-P \fIpage-list\fR
 156 .br
 157 Specifies which pages to print in the document. The list can contain a
 158 list of numbers and ranges (#-#) separated by commas (e.g. 1,3-5,16).
 159 .SH COMPATIBILITY
 160 Unlike the System V printing system, CUPS allows printer names to contain
 161 any printable character except SPACE and TAB. Also, printer and class names are
 162 \fBnot\fR case-sensitive.
 163 .LP
 164 The "m" option is not functional in CUPS 1.1.
 165 .LP
 166 The "q" option accepts a different range of values than the
 167 Solaris lp command, matching the IPP job priority values (1-100)
 168 instead of the Solaris values (0-39).
 169 .SH NOTES
 170 Administrators wishing to prevent unauthorized cancellation of
 171 jobs via the \fI-u\fR option should password-protect the /jobs
 172 location in \fIcupsd.conf(5)\fR.
 173 .SH SEE ALSO
 174 lpstat(1),
 175 CUPS Software Users Manual,
 176 http://localhost:631/documentation.html
 177 .SH COPYRIGHT
 178 Copyright 1993-2005 by Easy Software Products, All Rights Reserved.
 179 .\"
 180 .\" End of "$Id: lp.man 4493 2005-02-18 02:09:53Z mike $".
 181 .\"