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)