man/lp.man

   1 .\"
   2 .\" "$Id: lp.man,v 1.6 2001/03/09 14:26:54 mike Exp $"
   3 .\"
   4 .\"   lp/cancel man page for the Common UNIX Printing System (CUPS).
   5 .\"
   6 .\"   Copyright 1997-2001 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-3111 USA
  19 .\"
  20 .\"       Voice: (301) 373-9603
  21 .\"       EMail: cups-info@cups.org
  22 .\"         WWW: http://www.cups.org
  23 .\"
  24 .TH lp 1 "Common UNIX Printing System" "23 January 2001" "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 ] [ \-p/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 ] [ \-p/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 ] [
  74 .I id
  75 ] [
  76 .I destination
  77 ] [
  78 .I destination-id
  79 ]
  80 .SH DESCRIPTION
  81 \fBlp\fR submits files for printing or alters a pending job.
  82 .LP
  83 \fBcancel\fR cancels existing print jobs. The \fI-a\fR option will remove
  84 all jobs from the specified destination.
  85 .SH OPTIONS
  86 The following options are recognized by \fBlp\fR:
  87 .TP 5
  88 \-E
  89 .br
  90 Forces encryption when connecting to the server.
  91 .TP 5
  92 \-d \fIdestination\fR
  93 .br
  94 Prints files to the named printer.
  95 .TP 5
  96 \-h \fIhostname\fR
  97 .br
  98 Specifies the print server hostname. The default is "localhost" or the value
  99 of the CUPS_SERVER environment variable.
 100 .TP 5
 101 \-i \fIjob-id\fR
 102 .br
 103 Specifies an existing job to modify.
 104 .TP 5
 105 \-m
 106 .br
 107 Send email when the job is completed (not supported CUPS 1.1.)
 108 .TP 5
 109 \-n \fIcopies\fR
 110 .br
 111 Sets the number of copies to print from 1 to 100.
 112 .TP 5
 113 \-o \fIoption\fR
 114 .br
 115 Sets a job option.
 116 .TP 5
 117 \-p/q \fIpriority\fR
 118 .br
 119 Sets the job priority from 1 (lowest) to 100 (highest). The default priority
 120 is 50.
 121 .TP 5
 122 \-s
 123 .br
 124 Do not report the resulting job IDs (silent mode.)
 125 .TP 5
 126 \-t \fIname\fR
 127 .br
 128 Sets the job name.
 129 .TP 5
 130 \-H \fIhandling\fR
 131 .br
 132 Specifies when the job should be printed. A value of
 133 \fIimmediate\fR will print the file immediately, a value of
 134 \fIhold\fR will hold the job indefinitely, and a time value
 135 (HH:MM) will hold the job until the specified time. Use a value
 136 of \fIresume\fR with the \fI-i\fR option to resume a held job.
 137 .TP 5
 138 \-P \fIpage-list\fR
 139 .br
 140 Specifies which pages to print in the document. The list can contain a
 141 list of numbers and ranges (#-#) separated by commas (e.g. 1,3-5,16).
 142 .SH COMPATIBILITY
 143 Unlike the System V printing system, CUPS allows printer names to contain
 144 any printable character except SPACE and TAB. Also, printer and class names are
 145 \fBnot\fR case-sensitive.
 146 .LP
 147 The "m" option is not functional in CUPS 1.1.
 148 .SH SEE ALSO
 149 lpstat(1),
 150 CUPS Software Users Manual,
 151 http://localhost:631/documentation.html
 152 .SH COPYRIGHT
 153 Copyright 1993-2001 by Easy Software Products, All Rights Reserved.
 154 .\"
 155 .\" End of "$Id: lp.man,v 1.6 2001/03/09 14:26:54 mike Exp $".
 156 .\"