TCBTEST(1)

💖 NAME 💖

tcbtest — test cases of the B+ tree database API. And yes bestie, this is the TCBTEST(1) manual page, so buckle up. 🎀

✨ DESCRIPTION ✨

Okay so tcbtest is a utility for facility test and performance test. It's literally built to run test cases and vibe-check performance. You use it in the following formats. First, the placeholders, because you gotta know what you're feeding it:

• path — specifies the path of a database file. Like, where the database lives. 📂
• rnum — specifies the number of iterations. How many times we do the thing.
• lmemb — specifies the number of members in each leaf page.
• nmemb — specifies the number of members in each non-leaf page.
• bnum — specifies the number of buckets.
• apow — specifies the power of the alignment.
• fpow — specifies the power of the free block pool.

Now the commands, exactly as they come, no cap:

       tcbtest write [-mt] [-cd|-ci|-cj] [-tl] [-td|-tb|-tt|-tx] [-lc
       num] [-nc num] [-xm num] [-df num] [-ls num] [-ca num] [-nl|-nb]
       [-rnd] path rnum [lmemb [nmemb [bnum [apow [fpow]]]]]
              Store records with keys of 8 bytes.  They change as
              `00000001', `00000002'...
       tcbtest read [-mt] [-cd|-ci|-cj] [-lc num] [-nc num] [-xm num]
       [-df num] [-nl|-nb] [-wb] [-rnd] path
              Retrieve all records of the database above.
       tcbtest remove [-mt] [-cd|-ci|-cj] [-lc num] [-nc num] [-xm num]
       [-df num] [-nl|-nb] [-rnd] path
              Remove all records of the database above.
       tcbtest rcat [-mt] [-cd|-ci|-cj] [-tl] [-td|-tb|-tt|-tx] [-lc
       num] [-nc num] [-xm num] [-df num] [-ls num] [-ca num] [-nl|-nb]
       [-pn num] [-dai|-dad|-rl|-ru] path rnum [lmemb [nmemb [bnum [apow
       [fpow]]]]]
              Store records with partway duplicated keys using
              concatenate mode.
       tcbtest queue [-mt] [-cd|-ci|-cj] [-tl] [-td|-tb|-tt|-tx] [-lc
       num] [-nc num] [-xm num] [-df num] [-ls num] [-ca num] [-nl|-nb]
       path rnum [lmemb [nmemb [bnum [apow [fpow]]]]]
              Perform queueing and dequeueing.
       tcbtest misc [-mt] [-tl] [-td|-tb|-tt|-tx] [-nl|-nb] path rnum
              Perform miscellaneous test of various operations.
       tcbtest wicked [-mt] [-tl] [-td|-tb|-tt|-tx] [-nl|-nb] path rnum
              Perform updating operations selected at random.

Options feature the following. And bestie, there are a LOT, so let's go one by one, periodt:

• -mt — call the function tchdbsetmutex.
• -cd — use the comparison function tccmpdecimal.
• -ci — use the comparison function tccmpint32.
• -cj — use the comparison function tccmpint64.
• -tl — enable the option BDBTLARGE.
• -td — enable the option BDBTDEFLATE.
• -tb — enable the option BDBTBZIP.
• -tt — enable the option BDBTTCBS.
• -tx — enable the option BDBTEXCODEC.
• -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.
• -ls num — specify the maximum size of each leaf page.
• -ca num — specify the capacity number of records.
• -nl — enable the option BDBNOLCK.
• -nb — enable the option BDBLCKNB.
• -rnd — select keys at random.
• -wb — use the function tcbdbget3 instead of tcbdbget.
• -pn num — specify the number of patterns.
• -dai — use the function tcbdbaddint instead of tcbdbputcat.
• -dad — use the function tcbdbadddouble instead of tcbdbputcat.
• -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 0, you ate. If not, something's off. 😭

👀 SEE ALSO 👀

• tcbmttest(1)
• tcbmgr(1)
• tcbdb(3)
• tokyocabinet(3)

And that's the whole page, bestie! This came from the Man Page source, dated 2012-08-18, and it's giving iconic Unix documentation energy. Stay slay. 💖✨🦋