man-pages/man1/cancel.1.html
2021-03-31 01:06:50 +01:00

153 lines
3.3 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of cancel</TITLE>
</HEAD><BODY>
<H1>cancel</H1>
Section: Apple Inc. (1)<BR>Updated: CUPS<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
cancel - cancel jobs
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>cancel</B>
[
<B>-E</B>
] [
<B>-U</B>
<I>username</I>
] [
<B>-a</B>
] [
<B>-h</B>
<I>hostname[:port]</I>
] [
<B>-u</B>
<I>username</I>
] [
<B>-x</B>
] [
<I>id</I>
] [
<I>destination</I>
] [
<I>destination-id</I>
]
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
The <B>cancel</B> command cancels print jobs.
If no <I>destination</I> or <I>id</I> is specified, the currently printing job on the default destination is canceled.
<A NAME="lbAE">&nbsp;</A>
<H2>OPTIONS</H2>
The following options are recognized by <B>cancel</B>:
<DL COMPACT>
<DT id="1"><B>-a</B>
<DD>
Cancel all jobs on the named destination, or all jobs on all
destinations if none is provided.
<DT id="2"><B>-E</B>
<DD>
Forces encryption when connecting to the server.
<DT id="3"><B>-h </B><I>hostname</I>[<I>:port</I>]<DD>
Specifies an alternate server.
<DT id="4"><B>-U </B><I>username</I><DD>
Specifies the username to use when connecting to the server.
<DT id="5"><B>-u </B><I>username</I><DD>
Cancels jobs owned by <I>username</I>.
<DT id="6"><B>-x</B>
<DD>
Deletes job data files in addition to canceling.
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>CONFORMING TO</H2>
Unlike the System V printing system, CUPS allows printer names to contain any printable character except SPACE, TAB, &quot;/&quot;, or &quot;#&quot;. Also, printer and class names are <I>not</I> case-sensitive.
<A NAME="lbAG">&nbsp;</A>
<H2>EXAMPLES</H2>
Cancel the current print job:
<PRE>
cancel
</PRE>
Cancel job &quot;myprinter-42&quot;:
<PRE>
cancel myprinter-42
</PRE>
Cancel all jobs:
<PRE>
cancel -a
</PRE>
<A NAME="lbAH">&nbsp;</A>
<H2>NOTES</H2>
Administrators wishing to prevent unauthorized cancellation of jobs via the <I>-u</I> option should require authentication for Cancel-Jobs operations in
<B><A HREF="/cgi-bin/man/man2html?5+cupsd.conf">cupsd.conf</A></B>(5).
<A NAME="lbAI">&nbsp;</A>
<H2>SEE ALSO</H2>
<B><A HREF="/cgi-bin/man/man2html?5+cupsd.conf">cupsd.conf</A></B>(5),
<B><A HREF="/cgi-bin/man/man2html?1+lp">lp</A></B>(1),
<B><A HREF="/cgi-bin/man/man2html?8+lpmove">lpmove</A></B>(8),
<B><A HREF="/cgi-bin/man/man2html?1+lpstat">lpstat</A></B>(1),
CUPS Online Help (<A HREF="http://localhost:631/help)">http://localhost:631/help)</A>
<A NAME="lbAJ">&nbsp;</A>
<H2>COPYRIGHT</H2>
Copyright &#169; 2007-2019 by Apple Inc.
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="7"><A HREF="#lbAB">NAME</A><DD>
<DT id="8"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="9"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="10"><A HREF="#lbAE">OPTIONS</A><DD>
<DT id="11"><A HREF="#lbAF">CONFORMING TO</A><DD>
<DT id="12"><A HREF="#lbAG">EXAMPLES</A><DD>
<DT id="13"><A HREF="#lbAH">NOTES</A><DD>
<DT id="14"><A HREF="#lbAI">SEE ALSO</A><DD>
<DT id="15"><A HREF="#lbAJ">COPYRIGHT</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:05:08 GMT, March 31, 2021
</BODY>
</HTML>