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

# bpstats2(1)

Bundle Protocol (BP) processing statistics query utility via bundles

## NAME

bpstats2 - Bundle Protocol (BP) processing statistics query utility via bundles

## SYNOPSIS

**bpstats2** *sourceEID* \[*default destEID*\] \[ct\]

## DESCRIPTION

**bpstats2** creates bundles containing the current values of all BP processing statistics accumulators.  It creates these bundles when:

- •

  an interrogation bundle is delivered to *sourceEID*: the contents of the bundle are discarded, a new statistics bundle is generated and sent to the source of the interrogation bundle.  The format of the interrogation bundle is irrelevant.

- •

  a SIGUSR1 signal is delivered to the **bpstats2** application: a new statistics bundle is generated and sent to *default destEID*.

## EXIT STATUS

- "0"

  **bpstats2** has terminated. Any problems encountered during operation will be noted in the **ion.log** log file.

- "1"

  **bpstats2** failed to start up or receive bundles.  Diagnose the issue  reported in the **ion.log** file and try again.

## OPTIONS

- \[ct\]

  If the string "ct" is appended as the last argument, then statistics bundles will be sent with custody transfer requested.

## FILES

No configuration files are needed.

## ENVIRONMENT

No environment variables apply.

## DIAGNOSTICS

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

- bpstats2 can't *bp\_attach()*.

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

- bpstats2 can't open own endpoint.

  Another BP application has opened that endpoint; close it and try again.

- No space for ZCO extent.

  ION system error.  Check for earlier diagnostic messages describing the cause of the error; correct problem and rerun.

- Can't create ZCO extent.

  ION system error.  Check for earlier diagnostic messages describing the cause of the error; correct problem and rerun.

- bpstats2 can't send stats bundle.

  Bundle Protocol service to the remote endpoint has been stopped.

- Can't send stats: bad dest EID (dest EID)

  The destination EID printed is an invalid destination EID.  The destination EID may be specified in *default destEID* or the source EID of the interrogation bundle.  Ensure that *default destEID* is an EID that  is valid for ION, and that the interrogator is a source EID that is also a valid destination EID.  Note that "dtn:none" is not a valid destination EID, but is a valid source EID.

## NOTES

A very simple interrogator is bpchat which can repeatedly interrogate **bpstats2** by just striking the enter key.

## BUGS

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

## SEE ALSO

[*bpstats*(1)](/bpstats/1.md), [*bpchat*(1)](/bpchat/1.md)