DTN2ADMIN(1)

📦 version 3.2.1, in ubuntu jammy

💖 DTN2ADMIN 💖

okay bestie, sit down, hydrate, because we're talking about dtn2admin — the baseline "dtn" scheme administration interface, straight out of the BP executables collection. she's a manual page girlie and she's serving iconic ✨

✨ SYNOPSIS ✨

dtn2admin [ commands_filename ]

that's it. that's the whole vibe. one optional file argument and she's ready 💅

🌸 DESCRIPTION 🌸

so basically, dtn2admin is the girl who configures the local ION node's routing of bundles to endpoints whose IDs are all about that dtn endpoint ID scheme life. and before you ask — no, dtn is not CBHE-conformant. she's a rebel. she doesn't follow the rules. periodt.

ngl, the structure of dtn endpoint IDs is somewhat in flux at the time of this writing — like, the lore is still being written, bestie. but historically?? endpoint IDs in the dtn scheme have been strings shaped like this:

dtn://node_name[/demux_token]

where node_name is normally the thing that identifies a computer somewhere on the network 🌐 and demux_token is normally the thing that identifies a specific application processing point 🎯. yes, they're doing different jobs. no, you can't swap them. moving on.

and yeah, lowkey, the dtn endpoint ID scheme imposes more transmission overhead than the ipn scheme — like she's a little extra, we know — but ION still provides support for dtn endpoint IDs, and the whole reason is to enable interoperation with other implementations of Bundle Protocol. networking with the other girlies, we love to see it 🫶

so how does she actually work?? dtn2admin operates in response to dtn scheme configuration commands found in the file commands_filename — if provided. if it's NOT provided, she just prints a simple prompt:

:

and lets you type commands directly into standard input. direct line to the queen 👑

you can query the format of commands for commands_filename right from dtn2admin using the h or ? commands at the prompt. the full command documentation lives in dtn2rc(5). iykyk.

💀 EXIT STATUS 💀

  • "0" — Successful completion of "dtn" scheme administration. she ate and left no crumbs 🔥
  • "1" — Unsuccessful completion of "dtn" scheme administration, due to inability to attach to the Bundle Protocol system or to initialize the "dtn" scheme. she did NOT eat. she is crying in the club 😭

🎀 EXAMPLES 🎀

  • dtn2admin — Enter interactive "dtn" scheme configuration command entry mode. just you, her, and the : prompt. main character energy fr fr.
  • dtn2admin host1.dtn2rc — Execute all configuration commands in host1.dtn2rc, then terminate immediately. she reads, she executes, she leaves. no small talk, no goodbyes. iconic behavior tbh 💅

🦋 FILES 🦋

See dtn2rc(5) for details of the DTN scheme configuration commands. that's where the actual lore is kept, bestie, go read it 📖

🧚 ENVIRONMENT 🧚

No environment variables apply.

(yes really. nothing. she doesn't need your environment. she's self-sufficient like that 💜)

😭 DIAGNOSTICS 😭

Note: all ION administration utilities expect source file input to be lines of ASCII text that are NL-delimited.

so if you edit the dtn2rc file on a Windows machine, please please PLEASE be sure to use dos2unix to convert it to Unix text format before presenting it to dtn2admin. otherwise she will detect syntax errors and will not function satisfactorily. she will simply be going through it. don't do that to her 🙈

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) first. she's not being dramatic, she literally cannot reach him 📞
  • dtn2admin can't initialize routing database. — There is no SDR data store for dtn2admin to use. please run ionadmin(1) to start the local ION node. give the girl somewhere to live 😭
  • Can't open command file... — The commands_filename specified in the command line doesn't exist. she looked. it wasn't there. 💀
  • 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) for details. like she's fine, she's just side-eyeing you a little.

🌈 BUGS 🌈

Report bugs to <ion-bugs@korgano.eecs.ohiou.edu>. she wants to hear about it. constructive criticism only tho, be nice 🫶

⭐ SEE ALSO ⭐

and that's the whole page, bestie!! this was perl v5.24.1, dated 2016-07-07, filed under DTN2ADMIN(1). she's an older queen but she still runs the game 👑✨ mwah, go configure some bundles 💖

📦 where this page comes from