KCDIRTEST(1)

💖 KCDIRTEST(1) 💖

okay bestie, so this is kcdirtest from the Kyoto Cabinet manual (section 1, she's official). Sit down, grab a boba, because this little icon runs the facility test and the performance test for the directory hash database. Yeah. She's the whole vibe.

🌸 NAME 🌸

kcdirtest — the command line interface to test the directory hash database. literally just that. no cap. 🎀

✨ DESCRIPTION ✨

So like, the command kcdirtest is a utility for facility test and performance test of the directory hash database. She's not here to be cute, she's here to test. 💅

You run her in the following format, okay? Listen up:

• path specifies the path of a database file. 📁
• rnum specifies the number of iterations. 🔁

kcdirtest order [-th num] [-rnd] [-set|-get|-getw|-rem|-etc]
[-tran] [-oat|-onl|-onl|-otl|-onr] [-tc] [-lv] path rnum
       Performs in-order tests.
kcdirtest queue [-th num] [-it num] [-rnd]
[-oat|-onl|-onl|-otl|-onr] [-tc] [-lv] path rnum
       Performs queuing operations.
kcdirtest wicked [-th num] [-it num] [-oat|-onl|-onl|-otl|-onr]
[-tc] [-lv] path rnum
       Performs mixed operations selected at random.
kcdirtest tran [-th num] [-it num] [-hard]
[-oat|-onl|-onl|-otl|-onr] [-tc] [-lv] path rnum
       Performs test of transaction.

(and yes, -onl|-onl really is in there twice in that synopsis, i'm not gaslighting you, that's just what the page says 🙈)

So the four modes are giving very different energies:

• order — Performs in-order tests. Methodical queen. 👑
• queue — Performs queuing operations. Line up, besties. 🚶♀️
• wicked — Performs mixed operations selected at random. Chaos mode, honestly iconic. 🔥
• tran — Performs test of transaction. Commitment issues? Not her. 💖

🎀 the options, aka the main characters 🎀

Options feature the following:

• -th num : specifies the number of worker threads.
• -rnd : performs random test.
• -set : performs setting operation only.
• -get : performs getting operation only.
• -getw : performs getting with a buffer operation only.
• -rem : performs removing operation only.
• -etc : performs miscellaneous operations.
• -tran : performs transaction.
• -oat : opens the database with the auto transaction option.
• -oas : opens the database with the auto synchronization option.
• -onl : opens the database with the no locking option.
• -otl : opens the database with the try locking option.
• -onr : opens the database with the no auto repair option.
• -tc : tunes the database with the compression option.
• -lv : reports all errors.
• -it num : specifies the number of repetition.
• -hard : performs physical synchronization.

💜 and the exit status 💜

This command returns 0 on success, another on failure. That's it. That's the whole tea. 🍓

lowkey important: -set, -get, -getw, -rem, -etc and -tran only show up in the order synopsis, -it num only shows up for queue, wicked and tran, and -hard is a tran-only thing. so don't come for me when you mix and match, bestie. ✨

🦋 SEE ALSO 🦋

• kcdirmgr(1) — go say hi to her sister. 💕

okay that's the whole page!! this came from the Kyoto Cabinet source, dated 2012-05-24, and it was page 1 of the man pages — love that for her. mwah, go run some tests, you got this 🫶✨💅