]> git.ipfire.org Git - thirdparty/cups.git/blame - man/cancel.man
Merge changes from CUPS 1.4svn-r7696.
[thirdparty/cups.git] / man / cancel.man
CommitLineData
bd7854cb 1.\"
75bd9771 2.\" "$Id: cancel.man 7600 2008-05-20 21:06:23Z mike $"
bd7854cb 3.\"
4.\" cancel man page for the Common UNIX Printing System (CUPS).
5.\"
bc44d920 6.\" Copyright 2007 by Apple Inc.
bd7854cb 7.\" Copyright 1997-2006 by Easy Software Products.
8.\"
9.\" These coded instructions, statements, and computer programs are the
bc44d920 10.\" property of Apple Inc. and are protected by Federal copyright
11.\" law. Distribution and use rights are outlined in the file "LICENSE.txt"
12.\" which should have been included with this file. If this file is
13.\" file is missing or damaged, see the license at "http://www.cups.org/".
bd7854cb 14.\"
bc44d920 15.TH cancel 1 "Common UNIX Printing System" "20 March 2006" "Apple Inc."
bd7854cb 16.SH NAME
17cancel - cancel jobs
18.SH SYNOPSIS
19.B cancel
20[ -E ] [ -U
21.I username
22] [ -a ] [ -h
23.I hostname[:port]
24] [ -u
25.I username
26] [
27.I id
28] [
29.I destination
30] [
31.I destination-id
32]
33.SH DESCRIPTION
34\fIcancel\fR cancels existing print jobs. The \fI-a\fR option will remove
35all jobs from the specified destination.
36.SH OPTIONS
e1d6a774 37The following options are recognized by \fIcancel\fR:
bd7854cb 38.TP 5
39-E
40.br
41Forces encryption when connecting to the server.
42.TP 5
43-U username
44.br
45Specifies the username to use when connecting to the server.
46.TP 5
47-a
48.br
49Cancel all jobs on the named destination, or all jobs on all
50destinations if none is provided.
51.TP 5
52-h hostname[:port]
53.br
54Chooses an alternate server.
55.TP 5
56-u username
57.br
58Cancels jobs owned by \fIusername\fR.
59.SH COMPATIBILITY
60Unlike the System V printing system, CUPS allows printer names to
61contain any printable character except SPACE, TAB, "/", or "#".
62Also, printer and class names are \fInot\fR case-sensitive.
63.SH NOTES
64Administrators wishing to prevent unauthorized cancellation of
65jobs via the \fI-u\fR option should require authentication for
66Cancel-Jobs operations in \fIcupsd.conf(5)\fR.
67.SH SEE ALSO
68\fIlp(1)\fR, \fIlpmove(8)\fR, \fIlpstat(1)\fR,
69.br
70http://localhost:631/help
71.SH COPYRIGHT
bc44d920 72Copyright 2007 by Apple Inc.
bd7854cb 73.\"
75bd9771 74.\" End of "$Id: cancel.man 7600 2008-05-20 21:06:23Z mike $".
bd7854cb 75.\"