KCGRASSTEST(1)

💖 KCGRASSTEST 💖

okay bestie, so this is kcgrasstest, and it lives in the Kyoto Cabinet manual, section 1. it's giving "i stress-test databases for fun" and honestly? iconic.

✨ NAME ✨

kcgrasstest — the command line interface you use to test the cache tree database 🎀

🌸 DESCRIPTION 🌸

so the command kcgrasstest is a utility for facility test and performance test of the cache tree database. like, you run it to make sure stuff works and also to see how fast it goes. no cap.

you use it in the following formats, and rnum is the number of iterations (yes babe, it stands for run number-ish vibes, but just know: rnum = how many times we go around the block 💅).

🦋 order

kcgrasstest order [-th num] [-rnd] [-etc] [-tran] [-tc] [-bnum num] [-psiz num] [-pccap num] [-rcd|-rcld|-rcdd] [-lv] rnum

performs in-order tests ✨

🦋 queue

kcgrasstest queue [-th num] [-it num] [-rnd] [-tc] [-bnum num] [-psiz num] [-pccap num] [-rcd|-rcld|-rcdd] [-lv] rnum

performs queuing operations 🌈

🦋 wicked

kcgrasstest wicked [-th num] [-it num] [-tc] [-bnum num] [-psiz num] [-pccap num] [-rcd|-rcld|-rcdd] [-lv] rnum

performs mixed operations selected at random — chaos mode, main character energy 🔥

🦋 tran

kcgrasstest tran [-th num] [-it num] [-tc] [-bnum num] [-psiz num] [-pccap num] [-rcd|-rcld|-rcdd] [-lv] rnum

performs test of transaction 🫶

✨ OPTIONS ✨

okay here's the full menu of flags, and no i'm not skipping any of them, every single one is here periodt:

• -th num — specifies the number of worker threads 🧚
• -rnd — performs random test 🎲
• -etc — performs miscellaneous operations 🍓
• -tran — performs transaction 💜
• -tc — tunes the database with the compression option 🎀
• -bnum num — specifies the number of buckets of the hash table 🪣
• -psiz num — specifies the size of each page 📄
• -pccap num — specifies the capacity size of the page cache 🗂️
• -rcd — use the decimal comparator instead of the lexical one 🔢
• -rcld — use the lexical descending comparator instead of the ascending one 🔽
• -rcdd — use the decimal descending comparator instead of the lexical one 🔢🔽
• -lv — reports all errors 😭 (all of them. every last one.)
• -it num — specifies the number of repetition 🔁

🌟 EXIT STATUS 🌟

this command returns 0 on success, and another value on failure. so like, if you see 0 you ate. if you don't... not the vibe 💀

lowkey reminder bestie: rnum is the number of iterations, and you literally cannot forget it, it's the last thing on every single one of those lines 👑

mwah, that's the whole page. this came from the Kyoto Cabinet manual, and the page is dated 2012-05-24. slay, go run some tests 💅✨💖