NBD-TRDUMP(1)

📦
version 3.27.1 · 5 versions
, in arch rolling, debian trixie, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ NAME ✨

nbd-trdump — the little glow-up machine that turns a raw nbd transaction log into something a human can actually read 💖

🦋 SYNOPSIS 🦋

nbd-trdump

🌸 DESCRIPTION 🌸

okay so bestie, listen. nbd-trdump takes a transaction log — the kind nbd-server spits out, specifically the one you get from the transactionlog configuration directive — and translates it all into human readable form. it's giving translator, it's giving decoder ring, it's giving "i got you" 🫶

and the way it works? it's a traditional UNIX filter, no cap. so:

  • the transaction log must be handed to it on standard input
  • the human readable output goes straight out to standard output

that's it. that's the whole vibe. pipe it in, read it out, slay ✨

👑 OUTPUT 👑

here's everything that may show up in your output, and what each lil symbol means:

  • > — a request packet sent from the client to the server 🫡
  • < — a reply packet sent from the server to the client 💬
  • <S — a structured reply packet sent from the server to the client 📦
  • H — the cookie of the packet. note: previous versions of this man page (and the NBD spec) referred to the cookie as the "handle". so like, if you see "handle" floating around in old docs, it's the same thing, they just renamed it 💅
  • C — the command sent 📨
  • O — the offset from the start of the disk 📍
  • L — the length of data 📏
  • E — the error returned 🚨
  • T — the type of the structured reply message 🏷️
  • F — the flags on the structured reply message 🚩

🔥 SEE ALSO 🔥

  • nbd-server (1)

💜 AUTHOR 💜

the NBD kernel module and the NBD tools were written by Pavel Macheck (pavel@ucw.cz) — iconic behavior, honestly 🙌

the kernel module is now maintained by Paul Clements (Paul.Clements@steeleye.com), while the userland tools are maintained by Wouter Verhelst (wouter@debian.org) 👑

this manual page was written by Wouter Verhelst (<wouter@debian.org>) for the Debian GNU/Linux system (but may be used by others) 🎀

permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, version 2, as published by the Free Software Foundation 📜

and that's the whole page, babe! this one's $Date$ energy, served up fresh under the NBD-TRDUMP(1) banner — go read your logs, bestie, you got this 🌈💖

📦 where this page comes from