KCPOLYTEST(1)

✨ NAME ✨

kcpolytest — the command line interface to test the polymorphic database 💖

🌸 DESCRIPTION 🌸

okay bestie, gather round 🫶 kcpolytest is the little utility you use for facility testing and performance testing of the polymorphic database. it's giving "i stress-test databases for fun" and honestly? iconic behavior. 👑

you call it in the formats below, and here's the tea you need first: path specifies the path of a database file, and rnum specifies the number of iterations. every single mode wants those two, so keep them in your pocket 💅

🎀 the formats 🎀

order — performs in-order tests ✨

kcpolytest order [-th num] [-rnd] [-set|-get|-getw|-rem|-etc]
[-tran] [-oat|-onl|-onl|-otl|-onr] [-lv] path rnum

queue — performs queuing operations 🧚

kcpolytest queue [-th num] [-it num] [-rnd]
[-oat|-onl|-onl|-otl|-onr] [-lv] path rnum

wicked — performs mixed operations selected at random 😈 (yes that's the real name, and yes it's the fun one)

kcpolytest wicked [-th num] [-it num] [-oat|-onl|-onl|-otl|-onr]
[-lv] path rnum

tran — performs test of transaction 💸

kcpolytest tran [-th num] [-it num] [-hard]
[-oat|-onl|-onl|-otl|-onr] [-lv] path rnum

mapred — performs MapReduce operations 🌈

kcpolytest mapred [-rnd] [-ru] [-oat|-onl|-onl|-otl|-onr] [-lv]
[-tmp str] [-dbnum num] [-clim num] [-cbnum num] [-xnl] [-xpm]
[-xpr] [-xpf] [-xnc] path rnum

index — performs indexing operations 🔍

kcpolytest index [-th num] [-rnd] [-set|-get|-rem|-etc] [-tran]
[-oat|-onl|-onl|-otl|-onr] [-lv] path rnum

misc — performs miscellaneous tests 🙈 (no rnum here bestie, just the path, that's the whole vibe)

kcpolytest misc path

not me pointing out that the synopsis literally writes -onl twice in the option group — that is character-for-character what the page says, i'm not fixing it, i'm just the messenger 💀

💖 the options 💖

options feature the following, so let's go through every single one, no skips, no cap:

• -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
• -lv — reports all errors 📢
• -it num — specifies the number of repetition
• -hard — performs physical synchronization
• -ru — reuses the existing database ♻️
• -tmp str — specifies the path of a directory for temporary storage
• -dbnum num — specifies the number of temporary databases
• -clim num — specifies the limit size of cache memory
• -cbnum num — specifies the bucket number of cache memory
• -xnl — executes with the no locking option
• -xpm — executes with the parallel mapper option
• -xpr — executes with the parallel reducer option
• -xpf — executes with the parallel flusher option
• -xnc — executes with the no compression option

⭐ exit status ⭐

this command returns 0 on success, and another value on failure 😭 so bestie, check that return code, it's literally the whole plot twist.

👑 SEE ALSO 👑

• kcpolymgr(1)
• kclangctest(1)

mwah 💋 this page came straight out of the <strong>Kyoto Cabinet</strong> manual, dated <strong>2012-05-24</strong>, and it's the one and only <strong>KCPOLYTEST(1)</strong>. go forth and test your polymorphic database, you gorgeous nerd 🦋✨