DTPCADMIN(1)

📦 version 3.2.1, in ubuntu jammy

👑 DTPCADMIN(1) — DTPC executables ✨

okay bestie, gather round, because we're talking about dtpcadmin from the DTPC executables set 💖 (yes that's the manual name, that's the whole vibe, it's giving "the boss of DTPC on your local ION node")

🌸 NAME 🌸

dtpcadmin — the Delay-Tolerant Payload Conditioning (DTPC) administration interface 🎀

like, it's literally the front desk for DTPC. it handles everything. periodt.

✨ SYNOPSIS ✨

dtpcadmin [ commands_filename | . ]

💅 DESCRIPTION 💅

so what does dtpcadmin actually do, you ask? it configures, starts, manages, and stops DTPC operations for the local ION node. main character energy, honestly. 👑

it operates in response to DTPC configuration commands found in the file commands_filename, if provided. and if you don't provide one? it just prints a lil simple prompt (:) so you can type commands directly into standard input, like a little conversation with your terminal 🫶

and now the plot twist: if commands_filename is a period (.), the effect is the same as if a command file containing the single command x were passed to dtpcadmin — which is to say, the ION node's dtpcclock task and dtpcd task are stopped. bye bestie, shutdown szn. 💀

wanna know the format of the commands for commands_filename? you can literally just ask — use the h or ? commands at the prompt 😌 and all the deets on the commands themselves live in dtpcrc(5). iykyk.

🌈 EXIT STATUS 🌈

  • 0 — successful completion of DTPC administration 🎉

that's it. that's the list. we love a zero.

🦋 EXAMPLES 🦋

okay here's the part where it gets cute and practical:

  • dtpcadmin — enter interactive DTPC configuration command entry mode. it's giving "let's chat" 💬
  • dtpcadmin host1.dtpc — execute all configuration commands in host1.dtpc, then terminate immediately. no lingering, no goodbyes, just ✨efficiency✨
  • dtpcadmin . — stop all DTPC operations on the local node. the full shutdown, the grand finale 🎬

🍓 FILES 🍓

see dtpcrc(5) for details of the DTPC configuration commands. that's where the lore lives 📖

🧚 ENVIRONMENT 🧚

no environment variables apply. nothing. zero. the environment is not involved in this relationship 🙈

🔥 DIAGNOSTICS 🔥

note bestie, this one's important: all ION administration utilities expect source file input to be lines of ASCII text that are NL-delimited. so if you edit the dtpcrc file on a Windows machine, be sure to use dos2unix to convert it to Unix text format before presenting it to dtpcadmin. otherwise dtpcadmin will detect syntax errors and will not function satisfactorily. like, it will simply not slay. 😭

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

  • dtpcadmin can't attach to ION. — there is no SDR data store for dtpcadmin to use. you should run ionadmin(1) first, to set up an SDR data store for ION. do the setup step first, bestie, it's not optional 🫠
  • Can't open command file... — the commands_filename specified in the command line doesn't exist. it's not there. it never was. ghosted. 👻

various errors that don't cause dtpcadmin 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 dtpcrc(5) for details. (translation: it's fine, but also read the docs, fr fr.)

💀 BUGS 💀

report bugs to <ion-bugs@korgano.eecs.ohiou.edu> 📧 (yes, email. old school but iconic.)

⭐ SEE ALSO ⭐

  • dtpcrc(5) — the whole command dictionary, go read it 💜

and that's the whole page, bestie 🎀 this was written by perl v5.24.1, dated 2016-07-07 — yeah she's been around a minute but she still ate 💅✨

📦 where this page comes from