KVS-STORE(1)

πŸ“¦ version 0.7.5, in alpine 3.24, epel 9, fedora 43, fedora 44

πŸ’… kvs-store β€” bestie edition ✨

okay so this is a page from the xNVMe manual, section 1, and it's literally about executing a KV Store Command. grab a strawberry πŸ“ and let's get into it.


✨ NAME ✨

kvs-store β€” Execute a KV Store Command πŸŽ€

yeah. that's the whole vibe. it stores key-value pairs. iconic behavior fr fr.


πŸ¦‹ SYNOPSIS πŸ¦‹

kvs store <uri> [<args>]

that's it. that's the shape of it. a <uri>, then whatever <args> you feel like bringing along. main character energy πŸ‘‘


🌸 DESCRIPTION 🌸

Execute a KV Store Command πŸ’–

like, genuinely that's the description. it's a tool that runs a KV Store command for you. no notes. periodt.


πŸ’œ REQUIRED πŸ’œ

these are not optional, bestie. you need these or the whole thing is a no:

  • <uri> β€” the Device URI. for example '/dev/nvme0n1', '0000:01:00.1', '10.9.8.1.8888', '\.PhysicalDrive1' β€” pick the one that matches where your device actually lives, iykyk.
  • --key STRING β€” the KV Pair Key πŸ”‘ like, the name of the thing.
  • --value STRING β€” the KV Pair Value ✨ the actual content of the thing. key + value = the whole point of this exercise.

🧚 OPTIONAL 🧚

these ones you can skip if you want, no pressure, but they're all kinda cute:

  • [ --nsid 0xNUM ] β€” Namespace Identifier for Command Construction. it's the nsid the command gets built with.
  • [ --only-update ] β€” KV Store Option to only update existing. so if it's not already there, it's not happening. no new entries allowed 🚫
  • [ --only-add ] β€” KV Store Option to only add new KV-Pairs. the opposite energy: brand new only, no touching what already exists πŸ’…
  • [ --compress ] β€” KV Store Option to compress value on device. squeeze it, on the device itself πŸ—œοΈ
  • [ --dev-nsid 0xNUM ] β€” Namespace Identifier for Device Handle. note this is a different nsid from the one above β€” this one's for the device handle, not the command construction. don't mix them up bestie 😭
  • [ --be STRING ] β€” the xNVMe backend, e.g. 'linux', 'spdk', 'fbsd', 'macos', 'posix', 'windows'.
  • [ --admin STRING ] β€” the xNVMe admin. command-interface, e.g. 'nvme', 'block'.
  • [ --sync STRING ] β€” the xNVMe sync. command-interface, e.g. 'nvme', 'block'.
  • [ --help ] β€” Show usage / help 🫢 when you're lost, this is your girl.

🌈 SEE ALSO 🌈

Full documentation at: <https://xnvme.io/> β€” go look, it's right there πŸ‘€


πŸ‘‘ AUTHOR πŸ‘‘

Written by Simon A. F. Lund <simon.lund@samsung.com> on behalf of Samsung. absolute legend, we love to see it πŸ’–


that's the whole page bestie, you ate it. this was xNVMe, dated 09 September 2024, manual page KVS-STORE(1) β€” no cap, go store some key-value pairs πŸ¦‹βœ¨

πŸ“¦ where this page comes from