TCTTEST(1)

💖 NAME 💖

okay so bestie, listen — tcttest is the test-cases queen of the Tokyo Cabinet table database API. she's here to run facility tests and performance tests and she does not play. 👑

✨ DESCRIPTION ✨

so the command tcttest is a utility for facility test and performance test. she's used in the following formats, and before we go any further, let's get the vocabulary straight because it's giving vocabulary quiz:

• path — the path of a database file. 📁
• rnum — the number of iterations. 🔁
• bnum — the number of buckets. 🪣
• apow — the power of the alignment. 📐
• fpow — the power of the free block pool. 🏊

and here are all the formats she rolls with, fr fr:

tcttest write [-mt] [-tl] [-td|-tb|-tt|-tx] [-rc num] [-lc num]
[-nc num] [-xm num] [-df num] [-ip] [-is] [-in] [-it] [-if] [-ix]
[-nl|-nb] [-rnd] path rnum [bnum [apow [fpow]]]

store records with columns "str", "num", "type", and "flag". 💾

tcttest read [-mt] [-rc num] [-lc num] [-nc num] [-xm num] [-df
num] [-nl|-nb] [-rnd] path

retrieve all records of the database above. 👀

tcttest remove [-mt] [-rc num] [-lc num] [-nc num] [-xm num] [-df
num] [-nl|-nb] [-rnd] path

remove all records of the database above. 🧹 (bye bestie 💀)

tcttest rcat [-mt] [-tl] [-td|-tb|-tt|-tx] [-rc num] [-lc num]
[-nc num] [-xm num] [-df num] [-ip] [-is] [-in] [-it] [-if] [-ix]
[-nl|-nb] [-pn num] [-dai|-dad|-rl|-ru] path rnum [bnum [apow
[fpow]]]

store records with partway duplicated keys using concatenate mode. 🧬

tcttest misc [-mt] [-tl] [-td|-tb|-tt|-tx] [-nl|-nb] path rnum

perform miscellaneous test of various operations. 🎲

tcttest wicked [-mt] [-tl] [-td|-tb|-tt|-tx] [-nl|-nb] path rnum

perform updating operations selected at random. 😈 (she's called wicked for a reason)

🎀 OPTIONS 🎀

options feature the following, and yes we're doing all of them, no skips, no shortcuts, we eat the whole plate 💅

• -mt — call the function tctdbsetmutex. 🔒
• -tl — enable the option TDBTLARGE.
• -td — enable the option TDBTDEFLATE.
• -tb — enable the option TDBTBZIP.
• -tt — enable the option TDBTTCBS.
• -tx — enable the option TDBTEXCODEC.
• -rc num — specify the number of cached records. 🗃️
• -lc num — specify the number of cached leaf pages. 🍃
• -nc num — specify the number of cached non-leaf pages. 🌿
• -xm num — specify the size of the extra mapped memory. 🧠
• -df num — specify the unit step number of auto defragmentation. 🧩
• -ip — create the number index for the primary key. 🔑
• -is — create the string index for the column "str".
• -in — create the number index for the column "num".
• -it — create the string index for the column "type".
• -if — create the token inverted index for the column "flag". 🚩
• -ix — create the q-gram inverted index for the column "text".
• -nl — enable the option TDBNOLCK.
• -nb — enable the option TDBLCKNB.
• -rnd — select keys at random. 🎰
• -pn num — specify the number of patterns.
• -dai — use the function tctdbaddint instead of tctdbputcat.
• -dad — use the function tctdbadddouble instead of tctdbputcat.
• -rl — set the length of values at random. 📏
• -ru — select update operations at random. 🎲

this command returns 0 on success, another on failure. (so if you get a zero, that's the slay. anything else? that's a vibe check that failed bestie 😭)

🦋 SEE ALSO 🦋

• tctmttest(1)
• tctmgr(1)
• tctdb(3)
• tokyocabinet(3)

k bye, this was the TCTTEST(1) page from the Tokyo Cabinet manual, dated 2012-08-18, footer said "Man Page" and honestly? she ate. 🫶✨🌸 go run your tests, bestie, and remember: no cap, 0 means success. periodt. 💖👑🎀