1TCHMTTEST(1) Tokyo Cabinet TCHMTTEST(1)
2
3
4
6 tchmttest - test cases of the hash database API
7
8
10 The command `tchmttest' is a utility for facility test under
11 multi-thread situation. This command is used in the following format.
12 `path' specifies the path of a database file. `tnum' specifies the
13 number of running threads. `rnum' specifies the number of iterations.
14 `bnum' specifies the number of buckets. `apow' specifies the power of
15 the alignment. `fpow' specifies the power of the free block pool.
16
17 tchmttest write [-tl] [-td|-tb|-tt|-tx] [-rc num] [-xm num] [-df
18 num] [-nl|-nb] [-as] [-rnd] path tnum rnum [bnum [apow [fpow]]]
19 Store records with keys of 8 bytes. They change as
20 `00000001', `00000002'...
21 tchmttest read [-rc num] [-xm num] [-df num] [-nl|-nb] [-wb]
22 [-rnd] path tnum
23 Retrieve all records of the database above.
24 tchmttest remove [-rc num] [-xm num] [-df num] [-nl|-nb] [-rnd]
25 path tnum
26 Remove all records of the database above.
27 tchmttest wicked [-tl] [-td|-tb|-tt|-tx] [-nl|-nb] [-nc] path
28 tnum rnum
29 Perform updating operations selected at random.
30 tchmttest typical [-tl] [-td|-tb|-tt|-tx] [-rc num] [-xm num]
31 [-df num] [-nl|-nb] [-nc] [-rr num] path tnum rnum [bnum [apow
32 [fpow]]
33 Perform typical operations selected at random.
34 tchmttest race [-tl] [-td|-tb|-tt|-tx] [-xm num] [-df num]
35 [-nl|-nb] path tnum rnum [bnum [apow [fpow]]
36 Perform race condition test.
37
38 Options feature the following.
39
40 -tl : enable the option `HDBTLARGE'.
41 -td : enable the option `HDBTDEFLATE'.
42 -tb : enable the option `HDBTBZIP'.
43 -tt : enable the option `HDBTTCBS'.
44 -tx : enable the option `HDBTEXCODEC'.
45 -rc num : specify the number of cached records.
46 -xm num : specify the size of the extra mapped memory.
47 -df num : specify the unit step number of auto defragmentation.
48 -nl : enable the option `HDBNOLCK'.
49 -nb : enable the option `HDBLCKNB'.
50 -as : use the function `tchdbputasync' instead of `tchdbput'.
51 -rnd : select keys at random.
52 -wb : use the function `tchdbget3' instead of `tchdbget'.
53 -nc : omit the comparison test.
54 -rr num : specify the ratio of reading operation by percentage.
55
56 This command returns 0 on success, another on failure.
57
58
60 tchtest(1), tchmgr(1), tchdb(3), tokyocabinet(3)
61
62
63
64Man Page 2012-08-18 TCHMTTEST(1)