Update .gitignore to ignore compressed man pages.
[thirdparty/cups.git] / 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 .\" Licensed under Apache License v2.0.  See the file "LICENSE" for more information.
8 .\"
9 .TH lprm 1 "CUPS" "22 May 2014" "Apple Inc."
10 .SH NAME
11 lprm \- cancel print jobs
12 .SH SYNOPSIS
13 .B lprm
14 [
15 .B \-E
16 ] [
17 .B \-U
18 .I username
19 ] [
20 .B \-h
21 .IR server [ :port ]
22 ] [
23 .B \-P
24 .IR destination [ /instance ]
25 ] [
26 .B \-
27 ] [
28 .I job-id(s)
29 ]
30 .SH DESCRIPTION
31 .B lprm
32 cancels print jobs that have been queued for printing.
33 If no arguments are supplied, the current job on the default destination is canceled.
34 You can specify one or more job ID numbers to cancel those jobs or use the \fI\-\fR option to cancel all jobs.
35 .SH OPTIONS
36 The
37 .B lprm
38 command supports the following options:
39 .TP 5
40 .B \-E
41 Forces encryption when connecting to the server.
42 .TP 5
43 \fB\-P \fIdestination\fR[\fI/instance\fR]
44 Specifies the destination printer or class.
45 .TP 5
46 \fB\-U \fIusername\fR
47 Specifies an alternate username.
48 .TP 5
49 \fB\-h \fIserver\fR[\fI:port\fR]
50 Specifies an alternate server.
51 .SH CONFORMING TO
52 The CUPS version of
53 .B lprm
54 is compatible with the standard Berkeley command of the same name.
55 .SH EXAMPLES
56 Cancel the current job on the default printer:
57 .nf
58
59     lprm
60
61 .fi
62 Cancel job 1234:
63 .nf
64
65     lprm 1234
66
67 .fi
68 Cancel all jobs:
69 .nf
70
71     lprm \-
72 .fi
73 .SH SEE ALSO
74 .BR cancel (1),
75 .BR lp (1),
76 .BR lpq (1),
77 .BR lpr (1),
78 .BR lpstat (1),
79 CUPS Online Help (http://localhost:631/help)
80 .SH COPYRIGHT
81 Copyright \[co] 2007-2018 by Apple Inc.