TKRZW_FILE_PERF(1)

💖 TKRZW_FILE_PERF(1) 💖

okay bestie, you found the man page for tkrzw_file_perf from User Commands, and it's literally the file-implementation gym rat of the Tkrzw world. version 1.0.32, no cap. let's get into it 🫶

---

✨ NAME ✨

tkrzw_file_perf — manual page for tkrzw_file_perf 1.0.32

---

🌸 DESCRIPTION 🌸

so tkrzw_file_perf is the performance checker of file implementations of Tkrzw. it's giving benchmark-girlboss energy. it does NOT play. 💅

---

🎀 Usage 🎀

here's how you run her:

tkrzw_file_perf sequence [options] path

: Checks writing/reading performance in sequence.

tkrzw_file_perf wicked [options] path

: Checks consistency with various operations.

---

🌈 Common options 🌈

these apply to both subcommands, bestie, so read up 📖

• --file impl — the name of a file implementation: std, mmap-para, mmap-atom, pos-para, pos-atom. (default: mmap-para) — five flavors, pick your fighter 🥊
• --iter num — the number of iterations. (default: 10000)
• --size num — the size of each record. (default: 100)
• --threads num — the number of threads. (default: 1) — bump this if you want her to work 👑
• --random_seed num — the random seed or nagative for real RNG. (default: 0)
• --alloc_init num — the initial allocation size. (default: 1048576)
• --alloc_inc num — the allocation increment factor. (default: 2.0)
• --block_size num — the block size of the positional access file. (default: 1)
• --head_buffer num — the head buffer size of the positional access file. (default: 0)
• --direct_io — enables the direct I/O option of the positional access file. no middleman, straight to the disk 🦋
• --sync_io — enables the synchronous I/O option of the positional access file.
• --padding — enables padding at the end of the file. extra room at the end, she's comfy 😌
• --pagecache — enables the mini page cache in the process. tiny cache, big heart 🧚

---

🔥 Options for the sequence subcommand 🔥

these only hit different when you're running sequence:

• --random — uses random offsets rather than pre-defined ones. chaos mode, love that for you 🌪️
• --append — uses appending offsets rather than pre-defined ones. just keep tacking stuff on the end, periodt ➕
• --write_only — does only writing. no reading, she's just yapping ✍️
• --read_only — does only reading. no writing, she's just listening 👂

---

heads up bestie: every option above defaults to exactly what's listed — don't come for me if you forget to pass --iter and she runs 10000 times. that's on the default, not on me 💀

---

and that's the whole page, fr fr. this was tkrzw_file_perf 1.0.32, dated January 2025, living its best life under User Commands. mwah, go benchmark something iconic 💋✨💖