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

# bping(1)

Send and receive Bundle Protocol echo bundles.

## NAME

bping - Send and receive Bundle Protocol echo bundles.

## SYNOPSIS

**bping** \[**-c** *count*\] \[**-i** *interval*\] \[**-p** *priority*\] \[**-q** *wait*\] \[**-r** *flags*\] \[**-t** *ttl*\] *srcEID* *destEID* \[*reporttoEID*\]

## DESCRIPTION

**bping** sends bundles from *srcEID* to *destEID*.  If the *destEID* echoes the bundles back (for instance, it is a bpecho endpoint), **bping** will print the round-trip time.  When complete, bping will print statistics before exiting.  It is very similar to ping, except it works with the bundle protocol.

**bping** terminates when one of the following happens: it receives the SIGINT signal (Ctrl+C), it receives responses to all of the bundles it sent, or it has sent all *count* of its bundles and waited *wait* seconds.

## EXIT STATUS

These exit statuses are taken from ping.

- "0"

  **bping** has terminated normally, and received responses to all the packets it sent.

- "1"

  **bping** has terminated normally, but it did not receive responses to all the packets it sent.

- "2"

  **bping** has terminated due to an error.  Details should be noted in the **ion.log** log file.

## FILES

No configuration files are needed.

## ENVIRONMENT

No environment variables apply.

## DIAGNOSTICS

Diagnostic messages produced by **bping** are written to the ION log file *ion.log* and printed to standard error.  Diagnostic messages that don't cause **bping** to terminate indicate a failure parsing an echo response bundle.  This means that *destEID* isn't an echo endpoint: it's responding with some other bundle message of an unexpected format.

- Can't attach to BP.

  **bpadmin** has not yet initialized Bundle Protocol operations.

- Can't open own endpoint.

  Another application has already opened *ownEndpointId*.  Terminate that application and rerun.

- bping bundle reception failed.

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

- 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.

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

- bping can't send echo bundle.

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

## BUGS

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

## SEE ALSO

[*bpecho*(1)](/bpecho/1.md), [*bptrace*(1)](/bptrace/1.md), [*bpadmin*(1)](/bpadmin/1.md), [*bp*(3)](/bp/3.md), [*ping*(8)](/ping/8.md)