man/lp.man

   1 .\"
   2 .\" "$Id: lp.man 5010 2006-01-27 19:53:55Z mike $"
   3 .\"
   4 .\"   lp/cancel man page for the Common UNIX Printing System (CUPS).
   5 .\"
   6 .\"   Copyright 1997-2006 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" "18 January 2006" "Easy Software Products"
  25 .SH NAME
  26 lp \- print files
  27 .br
  28 cancel \- cancel jobs
  29 .SH SYNOPSIS
  30 .B lp
  31 [ -E ] [ -U
  32 .I username
  33 ] [ \-c ] [ \-d
  34 .I destination
  35 ] [ \-h
  36 .I hostname[:port]
  37 ] [ \-m ] [ \-n
  38 .I num-copies
  39 [ \-o
  40 .I option
  41 ] [ \-q
  42 .I priority
  43 ] [ \-s ] [ \-t
  44 .I title
  45 ] [ \-H
  46 .I handling
  47 ] [ \-P
  48 .I page-list
  49 ] [
  50 .I file(s)
  51 ]
  52 .br
  53 .B lp
  54 [ -E ] [ -U
  55 .I username
  56 ] [ \-c ] [ \-h
  57 .I hostname[:port]
  58 ] [ \-i
  59 .I job-id
  60 ] [ \-n
  61 .I num-copies
  62 [ \-o
  63 .I option
  64 ] [ \-q
  65 .I priority
  66 ] [ \-t
  67 .I title
  68 ] [ \-H
  69 .I handling
  70 ] [ \-P
  71 .I page-list
  72 ]
  73 .br
  74 .B cancel
  75 [ -E ] [ -U
  76 .I username
  77 ] [ \-a ] [ -h
  78 .I hostname:port
  79 ] [ -u
  80 .I username
  81 ] [
  82 .I id
  83 ] [
  84 .I destination
  85 ] [
  86 .I destination-id
  87 ]
  88 .SH DESCRIPTION
  89 \fBlp\fR submits files for printing or alters a pending job. Use
  90 a filename of "-" to force printing from the standard input.
  91 .LP
  92 \fBcancel\fR cancels existing print jobs. The \fI-a\fR option will remove
  93 all jobs from the specified destination.
  94 .SH OPTIONS
  95 The following options are recognized by \fBlp\fR:
  96 .TP 5
  97 \-E
  98 .br
  99 Forces encryption when connecting to the server.
 100 .TP 5
 101 \-U
 102 .br
 103 Specifies the username to use when connecting to the server.
 104 .TP 5
 105 \-c
 106 .br
 107 This option is provided for backwards-compatibility only. On
 108 systems that support it, this option forces the print file to be
 109 copied to the spool directory before printing. In CUPS, print
 110 files are always sent to the scheduler via IPP which has the
 111 same effect.
 112 .TP 5
 113 \-d \fIdestination\fR
 114 .br
 115 Prints files to the named printer.
 116 .TP 5
 117 \-h \fIhostname\fR
 118 .br
 119 Specifies the print server hostname. The default is "localhost" or the value
 120 of the CUPS_SERVER environment variable.
 121 .TP 5
 122 \-i \fIjob-id\fR
 123 .br
 124 Specifies an existing job to modify.
 125 .TP 5
 126 \-m
 127 .TP 5
 128 \-p
 129 .TP 5
 130 \-w
 131 .br
 132 Send email when the job is completed.
 133 .TP 5
 134 \-n \fIcopies\fR
 135 .br
 136 Sets the number of copies to print from 1 to 100.
 137 .TP 5
 138 \-o \fIoption\fR
 139 .br
 140 Sets a job option.
 141 .TP 5
 142 \-q \fIpriority\fR
 143 .br
 144 Sets the job priority from 1 (lowest) to 100 (highest). The
 145 default priority is 50.
 146 .TP 5
 147 \-s
 148 .br
 149 Do not report the resulting job IDs (silent mode.)
 150 .TP 5
 151 \-t \fIname\fR
 152 .br
 153 Sets the job name.
 154 .TP 5
 155 \-u \fIusername\fR
 156 .br
 157 Cancels jobs owned by \fIusername\fR.
 158 .TP 5
 159 \-H \fIhandling\fR
 160 .br
 161 Specifies when the job should be printed. A value of
 162 \fIimmediate\fR will print the file immediately, a value of
 163 \fIhold\fR will hold the job indefinitely, and a time value
 164 (HH:MM) will hold the job until the specified time. Use a value
 165 of \fIresume\fR with the \fI-i\fR option to resume a held job.
 166 Use a value of \fIrestart\fR with the \fI-i\fR option to restart
 167 a completed job.
 168 .TP 5
 169 \-P \fIpage-list\fR
 170 .br
 171 Specifies which pages to print in the document. The list can contain a
 172 list of numbers and ranges (#-#) separated by commas (e.g. 1,3-5,16).
 173 .SH COMPATIBILITY
 174 Unlike the System V printing system, CUPS allows printer names to contain
 175 any printable character except SPACE and TAB. Also, printer and class names are
 176 \fBnot\fR case-sensitive.
 177 .LP
 178 The "q" option accepts a different range of values than the
 179 Solaris lp command, matching the IPP job priority values (1-100, 100 is
 180 highest priority) instead of the Solaris values (0-39, 0 is highest
 181 priority).
 182 .SH NOTES
 183 Administrators wishing to prevent unauthorized cancellation of
 184 jobs via the \fI-u\fR option should require authentication for
 185 Cancel-Jobs operations in \fIcupsd.conf(5)\fR.
 186 .SH SEE ALSO
 187 lpstat(1),
 188 .br
 189 http://localhost:631/help
 190 .SH COPYRIGHT
 191 Copyright 1993-2006 by Easy Software Products, All Rights Reserved.
 192 .\"
 193 .\" End of "$Id: lp.man 5010 2006-01-27 19:53:55Z mike $".
 194 .\"