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)