Scroll to navigation

TCBTEST(1) Tokyo Cabinet TCBTEST(1)

NAME

tcbtest - test cases of the B+ tree database API

DESCRIPTION

The command ` tcbtest' is a utility for facility test and performance test. This command is used in the following format. ` path' specifies the path of a database file. ` rnum' specifies the number of iterations. ` 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.
 
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.
-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.

SEE ALSO

tcbmttest(1), tcbmgr(1), tcbdb(3), tokyocabinet(3)
2012-08-18 Man Page