KCFORESTTEST(1)

💖 NAME 💖

okay so bestie, meet kcforesttest — the command line interface to test the directory tree database. she's manual page one, section one, and she is here to stress-test your database and report back. 💅

🌸 DESCRIPTION 🌸

kcforesttest is a utility for facility test and performance test of the directory tree database. literally her whole job. 🔥

you call her like this: path is the path of a database file, and rnum is the number of iterations. so like, how many times do we go around the block. got it? got it. ✨

here are the four modes she serves, and yes you're picking one:

kcforesttest order [-th num] [-rnd] [-set|-get|-getw|-rem|-etc] [-tran] [-oat|-onl|-onl|-otl|-onr] [-tc] [-bnum num] [-psiz num] [-pccap num] [-rcd|-rcld|-rcdd] [-lv] path rnum

• Performs in-order tests. — she goes through it all in order, no chaos, very demure.

kcforesttest queue [-th num] [-it num] [-rnd] [-oat|-onl|-onl|-otl|-onr] [-tc] [-bnum num] [-psiz num] [-pccap num] [-rcd|-rcld|-rcdd] [-lv] path rnum

• Performs queuing operations. — queue behavior, first in first out energy. 🎀

kcforesttest wicked [-th num] [-it num] [-oat|-onl|-onl|-otl|-onr] [-tc] [-bnum num] [-psiz num] [-pccap num] [-rcd|-rcld|-rcdd] [-lv] path rnum

• Performs mixed operations selected at random. — pure chaos mode, she picks operations at random and honestly? iconic. 🦋

kcforesttest tran [-th num] [-it num] [-hard] [-oat|-onl|-onl|-otl|-onr] [-tc] [-bnum num] [-psiz num] [-pccap num] [-rcd|-rcld|-rcdd] [-lv] path rnum

• Performs test of transaction. — transaction testing, the serious one. periodt. 👑

✨ OPTIONS ✨

okay the options, bestie, she has so many. take a sip of water. 🍓

• -th num — specifies the number of worker threads. bring friends! 👯
• -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. the grab bag. 🙈
• -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.
• -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. she tells you EVERYTHING, no secrets. 💀
• -it num — specifies the number of repetition.
• -hard — performs physical synchronization.

heads up: the synopsis lines spell out -oat|-onl|-onl|-otl|-onr exactly like that, so yeah, -onl shows up twice in there. copying the queen verbatim, not my business. 💖

🫶 EXIT STATUS 🫶

This command returns 0 on success, another on failure. so 0 = slay, anything else = not slay. 🌈

👀 SEE ALSO 👀

• kcforestmgr(1) — her manager. go say hi.

and that's the whole page, bestie!! this one's from Kyoto Cabinet, dated 2012-05-24, and it lives in the manual as KCFORESTTEST(1). go forth and test that directory tree database, you absolute main character. 💜✨