XNVME_TESTS_BU...VIRT_ALLOC_FREE(1)

📦 version 0.7.5, in alpine 3.24

💅 xnvme_tests_buf-buf_virt_alloc_free 💅

okay so this is a page from the xNVMe manual set, and honestly? it's a little cutie. it's a test binary that just… allocates a buffer and frees it, over and over, while the size keeps doubling. like a gym routine for your memory manager. no cap. 🏋️‍♀️

✨ NAME ✨

xnvme_tests_buf-buf_virt_alloc_free — allocate and free a buffer count times, with size going from [1, 2^count], bestie 💖

✨ SYNOPSIS ✨

xnvme_tests_buf buf_virt_alloc_free <uri> [<args>]

✨ DESCRIPTION ✨

so basically 🫶 it allocates and frees a buffer count times, and the size range is [1, 2^count]. that's it. that's the whole vibe. it's a stress-y little loop for your buffer/memory manager and it's lowkey iconic for it. 🌸

✨ REQUIRED ✨

like, you literally cannot skip these. main character requirements only. 👑

  • <uri> — the Device URI, e.g. '/dev/nvme0n1', '0000:01:00.1', '10.9.8.1.8888', '\.PhysicalDrive1'. this is your "where's the device at" moment 🦋
  • --count NUM — use the NUM you give it as the count. she said count, so you give her a count. periodt ✨

✨ OPTIONAL ✨

these are the lil extras, the accessories if you will 💅 all optional, all valid:

  • [ --subnqn STRING ] — Subsystem NQN of the NVMe over Fabrics endpoint, e.g. 'nqn.2022-06.io.xnvme:ctrlnode1' 🧚
  • [ --hostnqn STRING ] — the host NQN to use when you're connecting to NVMe over Fabrics controllers 🌈
  • [ --be STRING ] — the xNVMe backend, e.g. 'linux', 'spdk', 'fbsd', 'macos', 'posix', 'windows' — pick your fighter 🔥
  • [ --dev-nsid 0xNUM ] — Namespace Identifier for the Device Handle 🎀
  • [ --admin STRING ] — the xNVMe admin. command-interface, e.g. 'nvme', 'block' ⭐
  • [ --mem STRING ] — the xNVMe buffer/memory manager. yes this one. the one this whole test is about. obsessed 💜
  • [ --direct NUM ] — bypass layers 🫶
  • [ --help ] — shows usage / help. say it with me: when in doubt, --help it out 😭

✨ SEE ALSO ✨

Full documentation at: https://xnvme.io/ — go read it, she ate 💖

✨ AUTHOR ✨

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

aaaand that's the whole page bestie, every flag accounted for, nothing skipped, no details lost, iykyk 💅

xNVMe 🌸 · version/date tag: 09 September · that's the sign-off, mwah, go allocate responsibly 🎀✨💖

📦 where this page comes from