Penguin
Recent Changes
Annotated edit history of cancel(1) version 1, including all changes. View license author blame.
Rev Author # Line
1 perry 1 CANCEL
2 !!!CANCEL
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 OPTIONS
7 OPERANDS
8 ENVIRONMENT
9 EXIT STATUS
10 SEE ALSO
11 DIAGNOSTICS
12 HISTORY
13 AUTHOR
14 ----
15 !!NAME
16
17
18 cancel - send cancel requests to an LPRng print service
19 !!SYNOPSIS
20
21
22 __cancel__ [[ __-P__ ''printer'' ] [[ __-D__
23 ''debug-options'' ] [[ ''request-ID''... ]
24 !!DESCRIPTION
25
26
27 The LPRng __lprm__ client supports an __cancel__
28 interface when invoked with an __cancel__ program name.
29 This is similar to the ex(1) and vi(1)
30 programs. The supported form of the __cancel__ command
31 arranges for the named ''jobs'' to be removed from the
32 specified print queues. The action is identical to that of
33 lprm(1)__,__ including the options, with the
34 difference that the last argument on the command line can be
35 an optional printer name. If the name does not appear in the
36 LPRng printcap database, then the name is assumed to be a
37 job identifier.
38
39
40 The format of ''request-ID'' should be either the
41 identifier field value or the job number reported by
42 LPQ.
43 !!OPTIONS
44
45
46 __-P__ ''printer''
47
48
49 printer name. The destination printer is taken from the
50 command line __-P__ ''printer'' value, then the
51 environment variables PRINTER, LPDEST, NPRINTER, NGPRINTER,
52 then first entry in the printcap information, and and
53 finally the default_printer entry from the configuration
54 file, and then the compile time default.
55
56
57 __-D__ ''debug-options''
58
59
60 Debug options for the program.
61 !!OPERANDS
62
63
64 The following operands are supported by
65 __cancel__:
66
67
68 ''ID'' A request ''ID'', as returned by __lp__.
69 Specifying a request ''ID'' cancels the associated
70 request even if it is currently printing.
71
72
73 ''printer'' A printer name (for a complete list of
74 printer names, use __lpq__). This method may not be
75 supported on all systems, and the __-P__ ''printer''
76 form should be used instead.
77 !!ENVIRONMENT
78
79
80 By default, the destination printer is taken from the
81 command line ''printer'' value, then the environment
82 variables PRINTER, LPDEST, NPRINTER, NGPRINTER, then first
83 entry in the printcap information, and and finally the
84 default_printer entry from the configuration file, and then
85 the compile time default.
86 !!EXIT STATUS
87
88
89 The following exit values are returned:
90
91
92 __zero (0)__
93
94
95 Successful completion.
96
97
98 __non-zero (!=0)__
99
100
101 An error occurred.
102 !!SEE ALSO
103
104
105 lpd.conf(5), lpc(8), lpd(8), checkpc(8), lpr(1), lpq(1),
106 lprm(1), printcap(5), lpd.perms(5), pr(1).
107 !!DIAGNOSTICS
108
109
110 Most of the diagnostics are self explanatory.
111 If you are puzzled over the exact cause of failure,
112 set the debugging level on (-D5) and run again.
113 The debugging information will
114 help you to pinpoint the exact cause of failure.
115 !!HISTORY
116
117
118 LPRng is a enhanced printer spooler system with
119 functionality similar to the Berkeley LPR software. The
120 LPRng mailing list is lprng@lprng.com; subscribe by sending
121 mail to lprng-request@lprng.com with the word subscribe in
122 the body. The software is available from
123 ftp://ftp.lprng.com/pub/LPRng.
124 !!AUTHOR
125
126
127 Patrick Powell
128 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.