TCHMTTEST(1)

💖 TCHMTTEST — bestie's guide to the hash database API test cases 💖

okay so this is tchmttest, straight out of the Tokyo Cabinet manual (section 1, obvi) 💅 and she is not a normal everyday tool — she's a facility test utility that runs under multi-thread situations. Basically she stress-tests your hash database so you don't have to find out the hard way 🙈

✨ NAME ✨

tchmttest — test cases of the hash database API 🎀

🌸 DESCRIPTION 🌸

The command tchmttest is a utility for facility test under multi-thread situation. Periodt. She's used in the following format, and bestie there are a lot of little knobs to turn 🫶

Here's the vibe of the arguments:

• path — specifies the path of a database file 📁
• tnum — specifies the number of running threads 🧵
• rnum — specifies the number of iterations 🔁
• bnum — specifies the number of buckets 🪣
• apow — specifies the power of the alignment 📐
• fpow — specifies the power of the free block pool 🆓

And here are the actual modes, in all their glory ⭐

tchmttest write [-tl] [-td|-tb|-tt|-tx] [-rc num] [-xm num] [-df num] [-nl|-nb] [-as] [-rnd] path tnum rnum [bnum [apow [fpow]]]

• Store records with keys of 8 bytes. They change as 00000001, 00000002... ✍️

tchmttest read [-rc num] [-xm num] [-df num] [-nl|-nb] [-wb] [-rnd] path tnum

• Retrieve all records of the database above. 👀

tchmttest remove [-rc num] [-xm num] [-df num] [-nl|-nb] [-rnd] path tnum

• Remove all records of the database above. 🗑️

tchmttest wicked [-tl] [-td|-tb|-tt|-tx] [-nl|-nb] [-nc] path tnum rnum

• Perform updating operations selected at random. 🎲 (yes she's called wicked, she earned it 💀)

tchmttest typical [-tl] [-td|-tb|-tt|-tx] [-rc num] [-xm num] [-df num] [-nl|-nb] [-nc] [-rr num] path tnum rnum [bnum [apow [fpow]]]

• Perform typical operations selected at random. 🌈

tchmttest race [-tl] [-td|-tb|-tt|-tx] [-xm num] [-df num] [-nl|-nb] path tnum rnum [bnum [apow [fpow]]]

• Perform race condition test. 🏁

💅 OPTIONS 💅

Options feature the following. Not a single one is skippable, bestie — she kept all of them 😌

• -tl — enable the option HDBTLARGE. 🫧
• -td — enable the option HDBTDEFLATE. 🗜️
• -tb — enable the option HDBTBZIP. 🧊
• -tt — enable the option HDBTTCBS. 🎛️
• -tx — enable the option HDBTEXCODEC. 🧬
• -rc num — specify the number of cached records. 🗂️
• -xm num — specify the size of the extra mapped memory. 🧠
• -df num — specify the unit step number of auto defragmentation. 🧹
• -nl — enable the option HDBNOLCK. 🔓
• -nb — enable the option HDBLCKNB. 🚫🔒
• -as — use the function tchdbputasync instead of tchdbput. ⚡
• -rnd — select keys at random. 🎰
• -wb — use the function tchdbget3 instead of tchdbget. 🔍
• -nc — omit the comparison test. 🙈
• -rr num — specify the ratio of reading operation by percentage. 📊

fr fr: this command returns 0 on success, another on failure. That's the whole exit-status story, no cap. 💯

🦋 SEE ALSO 🦋

• tchtest(1)
• tchmgr(1)
• tchdb(3)
• tokyocabinet(3)

and that's the whole page, bestie 🥹 go forth and thread-safely test your hash database, you absolute icon 👑

mwah 💖 — this was the Tokyo Cabinet man page, dated 2012-08-18, filed under TCHMTTEST(1). slay ✨