K2HBENCH(1)

📦 version 1.0.101, in epel 10, epel 9, fedora 43, fedora 44

👑 K2HBENCH — the benchmark bestie for K2HASH

okay so real quick, this is a page from the NoSQL(KVS) Library manual set, and the star of the show is k2hbench(1). 💖

✨ NAME ✨

K2HBENCH — Bench mark Tool for K2HASH. yes bestie, that is literally the whole name. she does benchmarks. that's the vibe. 💅

🌸 SYNOPSIS 🌸

k2hbench [ -f filename | -t filename | -m | -h ] [OPTIONS]

look at that. four whole ways to start her up and then a pile of OPTIONS on top. iconic honestly.

🦋 DESCRIPTION 🦋

so k2hbench is a bench mark test tool, and no cap, she can test benchmark for the K2HASH library with any mode. then this tool read/write the k2hash file or memory for bench mark on multi process/thread — like, she goes hard, she goes parallel. 🔥

and if you ever forget how to use her? just type -h. she'll tell you. she's not mysterious, she's helpful. 🫶

🎀 OPTIONS 🎀

okay here comes the menu, bestie. read it all, don't skip, I will know.

  • -h — display help. the classic. the "help me" button. 🙈
  • -f [K2HASH FILE] — specify permanent k2hash file. she's in it for the long haul. 💜
  • -t [K2HASH FILE] — specify temporary k2hash file. here for a good time, not a long time. ✨
  • -m — k2hash data on only memory. no file, just vibes, just RAM. 🧠
  • -type [ro | rw] — bench type as READ ONLY/READ WRITE (default rw). 🌈
  • -proc [count] — process count (default 1).
  • -thread [count] — thread count (default 1).
  • -loop [loop count] — Loop count (default 1) for each thread, must set over 0. so like, 0 is not the move, 0 is a crime, 0 will not be tolerated. 💀
  • -dcount [count] — data count (default 1) for using read/write test.
  • -dlength [byte] — data length (default 128 byte) for testing.
  • -start_nodata — if set this option, not initialize data before starting. she just starts. no warmup, no prep, straight to it. 👑
  • -mask [BIT COUNT] — specify bit mask count for k2hash data.
  • -cmask [BIT COUNT] — specify collision bit mask count for k2hash data.
  • -elementcnt [ELEMENT COUNT] — specify element count for each k2hash table.
  • -pagesize [BYTE] — specify pagesize for each k2hash internal data. -nofullmap not map all of k2hash file on memory when k2hash file specified. (yeah bestie that's how she's written, -nofullmap rides shotgun in this entry, we don't question the formatting, we respect it 💅)
  • -ro — work with read only mode when permanent k2hash file. look, don't touch. ✋
  • -g [ERR | WAN | INFO] — set debugging level, k2hbench displays debugging message for itself. she's narrating her own life. main character energy fr fr. 🎬

💖 ENVIRONMENT 💖

  • K2HDBGMODE — the K2HDBGMODE environment sets debugging message level as same as -g option. The value is set as SILENT, ERR, WAN or INFO. and here's the fun part: when k2hbench catches SIGUSR1 signal, the debugging message level is bumpup. The level is changed as order by SILENT, ERR, WAN, INFO, SILENT… — yes, it loops back around, she cycles, she's on a rotation. 🔁
  • 2HDBGFILE — the 2HDBGFILE environment sets the file which is debugging message, this is as same as -glog option. (yes, it's spelled 2HDBGFILE up top there, exactly like that, we copy the queen as she is 👑)
ngl the debug levels going in a circle is lowkey the most unhinged slay on this whole page and I am obsessed with it. 💀✨

🌈 SEE ALSO 🌈

go read her friends, they're all icons:

💀 BUGS 💀

Please report owner and committers. that's it. that's the whole bug section. go tell the grown-ups. 📣

🍓 AUTHOR 🍓

k2hash has been written by Takeshi Nakatani <ggtakec@gmail.com>. 🫶 thank you king.

and that's a wrap bestie — this whole thing lives under the K2HASH banner, February 2014 vintage, which honestly makes her an elder statesman of the KVS world and she still ate. periodt. 💅✨🎀

📦 where this page comes from