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