TCBMTTEST
Section: Tokyo Cabinet (1)
Updated: 2009-09-04
Index
Return to Main Contents
 
NAME
tcbmttest - test cases of the B+ tree database API
 
DESCRIPTION
The command `tcbmttest' 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.  `tnum' specifies the number of running threads.  `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.
- 
 tcbmttest write [-tl] [-td|-tb|-tt|-tx] [-xm num] [-df num] [-nl|-nb] [-rnd] path tnum rnum [lmemb [nmemb [bnum [apow [fpow]]]]]- 
Store records with keys of 8 bytes.  They change as `00000001', `00000002'...
 
 tcbmttest read [-xm num] [-df num] [-nl|-nb] [-wb] [-rnd] path tnum- 
Retrieve all records of the database above.
 
 tcbmttest remove [-xm num] [-df num] [-nl|-nb] [-rnd] path tnum- 
Remove all records of the database above.
 
 tcbmttest wicked [-tl] [-td|-tb|-tt|-tx] [-nl|-nb] [-nc] path tnum rnum- 
Perform updating operations selected at random.
 
 tcbmttest typical [-tl] [-td|-tb|-tt|-tx] [-xm num] [-df num] [-nl|-nb] [-nc] [-rr num] path tnum rnum [lmemb [nmemb [bnum [apow [fpow]]]]]- 
Perform typical operations selected at random.
 
 tcbmttest race [-tl] [-td|-tb|-tt|-tx] [-xm num] [-df num] [-nl|-nb] path tnum rnum [lmemb [nmemb [bnum [apow [fpow]]]]]- 
Perform race condition test.
 
Options feature the following.
- 
-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'.
 -xm num : specify the size of the extra mapped memory.
 -df num : specify the unit step number of auto defragmentation.
 -nl : enable the option `BDBNOLCK'.
 -nb : enable the option `BDBLCKNB'.
 -rnd : select keys at random.
 -wb : use the function `tchdbget3' instead of `tchdbget'.
 -nc : omit the comparison test.
 -rr num : specify the ratio of reading operation by percentage.
 
This command returns 0 on success, another on failure.
 
SEE ALSO
tcbtest(1),
tcbmgr(1),
tcbdb(3),
tokyocabinet(3)