ZONED-APPEND(1)

📦 version 0.7.5, in alpine 3.24, epel 9, fedora 43, fedora 44

💖 ZONED-APPEND(1) 💖

okay bestie, welcome to the zoned-append page — this is the part of the xNVMe manual (that's the manual name, it's literally just sitting there in the corner being iconic) that teaches you how to Execute an Append Command. no cap. let's get into it 💅

✨ NAME ✨

zoned-append — Execute an Append Command 🦋

🎀 SYNOPSIS 🎀

zoned append <uri> [<args>]

that's it. that's the shape of it. one command, one device, a lil pile of optional args if you're feeling main character energy 👑

🌸 DESCRIPTION 🌸

Execute an Append Command. fr fr, that is the whole description and honestly? it ate. it's a zoned operation, it appends, it's the moment. periodt. ✨

🔥 REQUIRED 🔥

these ones are non-negotiable, bestie. you cannot skip them, the command will simply not have a good time.

  • <uri> — the Device URI. like, where is the device, girlie? e.g. '/dev/nvme0n1', '0000:01:00.1', '10.9.8.1.8888', '\.PhysicalDrive1' 💖
  • --slba 0xNUM — Start Logical Block Address. where the party starts, lowkey.
  • --nlb NUM — Number of LBAs. and a lil NOTE for you: this is a zero-based value, so don't come at it with 1-based brain, okay? 🙈

🌈 OPTIONAL 🌈

all of these are optional, all of them are slay, take what you need 🫶

  • [ --nsid 0xNUM ] — Namespace Identifier for Command Construction.
  • [ --data-input FILE ] — Path to data input-file.
  • [ --meta-input FILE ] — Path to meta input-file.
  • [ --subnqn STRING ] — Subsystem NQN of the NVMe over Fabrics endpoint, e.g. 'nqn.2022-06.io.xnvme:ctrlnode1' — yes that is a real string, copy it exactly, don't freestyle ✨
  • [ --hostnqn STRING ] — The host NQN to use when connecting to NVMe over Fabrics controllers.
  • [ --be STRING ] — xNVMe backend, e.g. 'linux', 'spdk', 'fbsd', 'macos', 'posix', 'windows'. pick your fighter 💀
  • [ --dev-nsid 0xNUM ] — Namespace Identifier for Device Handle.
  • [ --admin STRING ] — xNVMe admin. command-interface, e.g. 'nvme', 'block'.
  • [ --mem STRING ] — xNVMe buffer/memory manager.
  • [ --direct NUM ] — Bypass layers. it's giving "I go straight there, no detours" 💅
  • [ --sync STRING ] — xNVMe sync. command-interface, e.g. 'nvme', 'block'.
  • [ --help ] — Show usage / help. the classic. the icon. when in doubt, ask for help 🎀

👑 SEE ALSO 👑

Full documentation at: <https://xnvme.io/>

go. read. be nourished. 🌸

💜 AUTHOR 💜

Written by Simon A. F. Lund <simon.lund@samsung.com> on behalf of Samsung 🫶

ok that's the whole page bestie, every flag accounted for, nothing skipped, we ate and left no crumbs 🍓

this lil masterpiece came to you from xNVMe, dated 09 September 2024 — mwah, bye bye, go append something responsibly 💖✨🌈

📦 where this page comes from