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

# dtn2admin(1)

baseline "dtn" scheme administration interface

## NAME

dtn2admin - baseline "dtn" scheme administration interface

## SYNOPSIS

**dtn2admin** \[ *commands\_filename* \]

## DESCRIPTION

**dtn2admin** configures the local ION node's routing of bundles to endpoints whose IDs conform to the *dtn* endpoint ID scheme.  *dtn* is a non-CBHE-conformant scheme.  The structure of *dtn* endpoint IDs remains somewhat in flux at the time of this writing, but endpoint IDs in the *dtn* scheme historically have been strings of the form "dtn://*node\_name*\[/*demux\_token*\]", where *node\_name* normally identifies a computer somewhere on the network and *demux\_token* normally identifies a specific application processing point.  Although the *dtn* endpoint ID scheme imposes more transmission overhead than the *ipn* scheme, ION provides support for *dtn* endpoint IDs to enable interoperation with other implementations of Bundle Protocol.

**dtn2admin** operates in response to "dtn" scheme configuration commands found in the file *commands\_filename*, if provided; if not, **dtn2admin** prints a simple prompt (:) so that the user may type commands directly into standard input.

The format of commands for *commands\_filename* can be queried from **dtn2admin** with the 'h' or '?' commands at the prompt.  The commands are documented in [*dtn2rc*(5)](/dtn2rc/5.md).

## EXIT STATUS

- "0" Successful completion of "dtn" scheme administration.

  - "1" Unsuccessful completion of "dtn" scheme administration, due to inability to attach to the Bundle Protocol system or to initialize the "dtn" scheme.

  ## EXAMPLES

- dtn2admin

  Enter interactive "dtn" scheme configuration command entry mode.

- dtn2admin host1.dtn2rc

  Execute all configuration commands in *host1.dtn2rc*, then terminate immediately.

## FILES

See [*dtn2rc*(5)](/dtn2rc/5.md) for details of the DTN scheme configuration commands.

## ENVIRONMENT

No environment variables apply.

## DIAGNOSTICS

**Note**: all ION administration utilities expect source file input to be lines of ASCII text that are NL-delimited.  If you edit the dtn2rc file on a Windows machine, be sure to **use dos2unix to convert it to Unix text format** before presenting it to **dtn2admin**.  Otherwise **dtn2admin** will detect syntax errors and will not function satisfactorily.

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

- dtn2admin can't attach to BP.

  Bundle Protocol has not been initialized on this computer.  You need to run [*bpadmin*(1)](/bpadmin/1.md) first.

- dtn2admin can't initialize routing database.

  There is no SDR data store for *dtn2admin* to use.  Please run [*ionadmin*(1)](/ionadmin/1.md) to start the local ION node.

- Can't open command file...

  The *commands\_filename* specified in the command line doesn't exist.

Various errors that don't cause **dtn2admin** to fail but are noted in the **ion.log** log file may be caused by improperly formatted commands given at the prompt or in the *commands\_filename* file. Please see [*dtn2rc*(5)](/dtn2rc/5.md) for details.

## BUGS

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

## SEE ALSO

[*dtn2rc*(5)](/dtn2rc/5.md)