NAME

       tchmttest - test cases of the hash database API

DESCRIPTION

       The  command  `tchmttest'  is  a utility for facility test under multi-thread situation.  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.  `bnum' specifies the number of buckets.
       `apow' specifies the power of the alignment.  `fpow' specifies the power of the free block pool.

              tchmttest write [-tl] [-td|-tb|-tt|-tx] [-rc num] [-xm num] [-df num] [-nl|-nb] [-as] [-rnd]  path
              tnum rnum [bnum [apow [fpow]]]
                     Store records with keys of 8 bytes.  They change as `00000001', `00000002'...
              tchmttest read [-rc num] [-xm num] [-df num] [-nl|-nb] [-wb] [-rnd] path tnum
                     Retrieve all records of the database above.
              tchmttest remove [-rc num] [-xm num] [-df num] [-nl|-nb] [-rnd] path tnum
                     Remove all records of the database above.
              tchmttest wicked [-tl] [-td|-tb|-tt|-tx] [-nl|-nb] [-nc] path tnum rnum
                     Perform updating operations selected at random.
              tchmttest  typical [-tl] [-td|-tb|-tt|-tx] [-rc num] [-xm num] [-df num] [-nl|-nb] [-nc] [-rr num]
              path tnum rnum [bnum [apow [fpow]]
                     Perform typical operations selected at random.
              tchmttest race [-tl] [-td|-tb|-tt|-tx] [-xm num] [-df num] [-nl|-nb] path tnum  rnum  [bnum  [apow
              [fpow]]
                     Perform race condition test.

       Options feature the following.

              -tl : enable the option `HDBTLARGE'.
              -td : enable the option `HDBTDEFLATE'.
              -tb : enable the option `HDBTBZIP'.
              -tt : enable the option `HDBTTCBS'.
              -tx : enable the option `HDBTEXCODEC'.
              -rc num : specify the number of cached records.
              -xm num : specify the size of the extra mapped memory.
              -df num : specify the unit step number of auto defragmentation.
              -nl : enable the option `HDBNOLCK'.
              -nb : enable the option `HDBLCKNB'.
              -as : use the function `tchdbputasync' instead of `tchdbput'.
              -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

       tchtest(1), tchmgr(1), tchdb(3), tokyocabinet(3)