man/lprm.man

   1 .\"
   2 .\" lprm man page for CUPS.
   3 .\"
   4 .\" Copyright 2007-2014 by Apple Inc.
   5 .\" Copyright 1997-2006 by Easy Software Products.
   6 .\"
   7 .\" These coded instructions, statements, and computer programs are the
   8 .\" property of Apple Inc. and are protected by Federal copyright
   9 .\" law.  Distribution and use rights are outlined in the file "LICENSE.txt"
  10 .\" which should have been included with this file.  If this file is
  11 .\" file is missing or damaged, see the license at "http://www.cups.org/".
  12 .\"
  13 .TH lprm 1 "CUPS" "22 May 2014" "Apple Inc."
  14 .SH NAME
  15 lprm \- cancel print jobs
  16 .SH SYNOPSIS
  17 .B lprm
  18 [
  19 .B \-E
  20 ] [
  21 .B \-U
  22 .I username
  23 ] [
  24 .B \-h
  25 .IR server [ :port ]
  26 ] [
  27 .B \-P
  28 .IR destination [ /instance ]
  29 ] [
  30 .B \-
  31 ] [
  32 .I job-id(s)
  33 ]
  34 .SH DESCRIPTION
  35 .B lprm
  36 cancels print jobs that have been queued for printing.
  37 If no arguments are supplied, the current job on the default destination is canceled.
  38 You can specify one or more job ID numbers to cancel those jobs or use the \fI\-\fR option to cancel all jobs.
  39 .SH OPTIONS
  40 The
  41 .B lprm
  42 command supports the following options:
  43 .TP 5
  44 .B \-E
  45 Forces encryption when connecting to the server.
  46 .TP 5
  47 \fB\-P \fIdestination\fR[\fI/instance\fR]
  48 Specifies the destination printer or class.
  49 .TP 5
  50 \fB\-U \fIusername\fR
  51 Specifies an alternate username.
  52 .TP 5
  53 \fB\-h \fIserver\fR[\fI:port\fR]
  54 Specifies an alternate server.
  55 .SH CONFORMING TO
  56 The CUPS version of
  57 .B lprm
  58 is compatible with the standard Berkeley command of the same name.
  59 .SH EXAMPLES
  60 Cancel the current job on the default printer:
  61 .nf
  62
  63     lprm
  64
  65 .fi
  66 Cancel job 1234:
  67 .nf
  68
  69     lprm 1234
  70
  71 .fi
  72 Cancel all jobs:
  73 .nf
  74
  75     lprm \-
  76 .fi
  77 .SH SEE ALSO
  78 .BR cancel (1),
  79 .BR lp (1),
  80 .BR lpq (1),
  81 .BR lpr (1),
  82 .BR lpstat (1),
  83 CUPS Online Help (http://localhost:631/help)
  84 .SH COPYRIGHT
  85 Copyright \[co] 2007-2015 by Apple Inc.