TCHMTTEST(1) Tokyo Cabinet TCHMTTEST(1)
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)
Man Page 2012-08-18 TCHMTTEST(1)