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

# udpbso(1)

UDP-based best-effort link service output task for BSSP

## NAME

udpbso - UDP-based best-effort link service output task for BSSP

## SYNOPSIS

**udpbso** {*remote\_engine\_hostname* \| @}\[:*remote\_port\_nbr*\] *txbps* *remote\_engine\_nbr*

## DESCRIPTION

**udpbso** is a background "daemon" task that extracts BSSP segments from the queue of segments bound for the indicated remote BSSP engine, encapsulates them in UDP datagrams, and sends those datagrams to the indicated UDP port on the indicated host.  If not specified, port number defaults to 6001.

UDP congestion can be controlled by setting udpbso's rate of UDP datagram transmission *txbps* (transmission rate in bits per second) to the value that is supported by the underlying network.

Each "span" of BSSP data interchange between the local BSSP engine and a neighboring BSSP engine requires its own best-effort and reliable link service output tasks. All link service output tasks are spawned automatically by **bsspadmin** in response to the 's' command that starts operation of the BSSP protocol, and they are all terminated by **bsspadmin** in response to an 'x' (STOP) command.

## EXIT STATUS

- "0"

  **udpbso** terminated normally, for reasons noted in the **ion.log** file.  If this termination was not commanded, investigate and solve the problem identified in the log file and use **bsspadmin** to restart **udpbso**.

- "1"

  **udpbso** terminated abnormally, for reasons noted in the **ion.log** file. Investigate and solve the problem identified in the log file, then use **bsspadmin** to restart **udpbso**.

## FILES

No configuration files are needed.

## ENVIRONMENT

No environment variables apply.

## DIAGNOSTICS

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

- udpbso can't initialize BSSP.

  **bsspadmin** has not yet initialized BSSP protocol operations.

- No such engine in database.

  *remote\_engine\_nbr* is invalid, or the applicable span has not yet been added to the BSSP database by **bsspadmin**.

- BE-BSO task is already started for this engine.

  Redundant initiation of **udpbso**.

- BE-BSO can't open UDP socket

  Operating system error.  Check errtext, correct problem, and restart **udpbso**.

- BE-BSO can't bind UDP socket

  Operating system error.  Check errtext, correct problem, and restart **udpbso**.

- Segment is too big for UDP BSO.

  Configuration error: segments that are too large for UDP transmission (i.e., larger than 65535 bytes) are being enqueued for **udpbso**.  Use **bsspadmin** to change maximum segment size for this span.

## BUGS

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

## SEE ABSO

[*bsspadmin*(1)](/bsspadmin/1.md), [*tcpbso*(1)](/tcpbso/1.md), [*udpbsi*(1)](/udpbsi/1.md)