---
name: "bpcancel"
section: "1"
platform: "linux"
package: "ion"
version: "3.2.1+dfsg-1.1"
release: "Debian 9 (Stretch)"
platforms: ["linux"]
url: "https://new.carta.tech/bpcancel"
---

# bpcancel(1)

Bundle Protocol (BP) bundle cancellation utility

## NAME

bpcancel - Bundle Protocol (BP) bundle cancellation utility

## SYNOPSIS

**bpcancel** *source\_EID* *creation\_seconds* \[*creation\_count* \[*fragment\_offset* \[*fragment\_length*\]\]\]

## DESCRIPTION

**bpcancel** locates the bundle identified by the command-line parameter values and destroys it, by simulating an immediate time-to-live expiration.

## EXIT STATUS

- "0"

  **bpcancel** has terminated.

## FILES

No configuration files are needed.

## ENVIRONMENT

No environment variables apply.

## DIAGNOSTICS

The following diagnostics may be issued to the **ion.log** log file:

- Can't attach to BP.

  **bpadmin** has not yet initialized BP operations.

- bpcancel failed finding bundle.

  No bundle identified by the command-line parameter values is present in the "timeline" list for the local bundle agent.

- bpcancel failed destroying bundle.

  Probably an unrecoverable database error, in which case the local ION node must be terminated and re-initialized.

- bpcancel failed.

  Probably an unrecoverable database error, in which case the local ION node must be terminated and re-initialized.

## BUGS

Report bugs to \<ion-bugs@korgano.eecs.ohiou.edu\>

## SEE ALSO

[*bplist*(1)](/bplist/1.md)