cancel(1) OpenPrinting cancel(1)

# [NAME](#NAME)

cancel - cancel jobs

# [SYNOPSIS](#SYNOPSIS)

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

# [DESCRIPTION](#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](#OPTIONS)

The following options are recognized by **cancel**:

[**-a**](#a)

Cancel all jobs on the named destination, or all jobs on all destinations if none is provided.

[**-E**](#E)

Forces encryption when connecting to the server.

[**-h hostname**\[*:port*\]](#h)

Specifies an alternate server. Note: This option must occur before all others.

[**-U username**](#U)

Specifies the username to use when connecting to the server.

[**-u username**](#u)

Cancels jobs owned by *username*.

[**-x**](#x)

Deletes job data files in addition to canceling.

# [CONFORMING TO](#CONFORMING_TO)

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

# [EXAMPLES](#EXAMPLES)

Cancel the current print job:

```


    cancel
```

Cancel job "myprinter-42":

```


    cancel myprinter-42
```

Cancel all jobs:

```


    cancel -a
```

# [NOTES](#NOTES)

The **-a** and **-u username** options require administrative access. These restrictions are part of the operation policies defined in the [**cupsd.conf**(5)](/man/os/cups/cupsd.conf.5) file for the "Cancel-Jobs" and "Cancel-My-Jobs" operations, respectively.

# [SEE ALSO](#SEE_ALSO)

[**cupsd.conf**(5)](/man/os/cups/cupsd.conf.5), [**lp**(1)](/man/os/cups/lp.1), [**lpmove**(8)](/man/os/cups/lpmove.8), [**lpstat**(1)](/man/os/cups/lpstat.1), CUPS Online Help (http://localhost:631/help)

# [COPYRIGHT](#COPYRIGHT)

Copyright © 2020-2024 by OpenPrinting.

CUPS 2026-03-06

---

Document: cancel(1) from cups 2.4.19-r3 (Chainguard OS)
Source: https://github.com/OpenPrinting/cups