Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Wednesday, February 9, 2022
 
 

cancel (1)

Name

cancel - cancel jobs

Synopsis

cancel  [ -E ] [ -U username ] [ -a ] [ -h hostname[:port] ] [ -u user-
name ] [ -x ] [ id ] [ destination ] [ destination-id ]

Description

cancel(1)                         Apple Inc.                         cancel(1)



NAME
       cancel - cancel jobs

SYNOPSIS
       cancel  [ -E ] [ -U username ] [ -a ] [ -h hostname[:port] ] [ -u user-
       name ] [ -x ] [ id ] [ destination ] [ destination-id ]

DESCRIPTION
       The cancel command cancels print jobs.  If  no  destination  or  id  is
       specified,  the  currently  printing  job on the default destination is
       canceled.

OPTIONS
       The following options are recognized by cancel:

       -a   Cancel all jobs on the named destination, or all jobs on all  des-
            tinations if none is provided.

       -E   Forces encryption when connecting to the server.

       -h hostname[:port]
            Specifies an alternate server.

       -U username
            Specifies the username to use when connecting to the server.

       -u username
            Cancels jobs owned by username.

       -x   Deletes job data files in addition to canceling.

CONFORMING TO
       Unlike  the System V printing system, CUPS allows printer names to con-
       tain any printable character except SPACE,  TAB,  "/",  or  "#".  Also,
       printer and class names are not case-sensitive.

EXAMPLES
       Cancel the current print job:

           cancel

       Cancel job "myprinter-42":

           cancel myprinter-42

       Cancel all jobs:

           cancel -a


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | print/cups       |
       +---------------+------------------+
       |Stability      | Volatile         |
       +---------------+------------------+

NOTES
       Administrators wishing to prevent unauthorized cancellation of jobs via
       the -u option should require authentication for Cancel-Jobs  operations
       in cupsd.conf(5).

       Source  code  for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This     software     was    built    from    source    available    at
       https://github.com/oracle/solaris-userland.   The  original   community
       source    was    downloaded   from    https://github.com/apple/cups/ar-
       chive/v2.3.3.zip.

       Further information about this software can be found on the open source
       community website at http://www.cups.org/.

SEE ALSO
       cupsd.conf(5),   lp(1),   lpmove(8),   lpstat(1),   CUPS   Online  Help
       (http://localhost:631/help)

COPYRIGHT
       Copyright (C) 2007-2019 by Apple Inc.




26 April 2019                        CUPS                            cancel(1)