1TCHTEST(1) Tokyo Cabinet TCHTEST(1)
2
6 tchtest - test cases of the hash database API
7
10 To use the hash database API easily, the commands `tchtest',
11 `tchmttest', and `tchmgr' are provided.
12 The command `tchtest' is a utility for facility test and performance
14 test. This command is used in the following format. `path' specifies
15 the path of a database file. `rnum' specifies the number of itera‐
16 tions. `bnum' specifies the number of buckets. `apow' specifies the
17 power of the alignment. `fpow' specifies the power of the free block
18 pool.
19 tchtest write [-mt] [-tl] [-td|-tb|-tt|-tx] [-rc num] [-xm num]
21 [-df num] [-nl|-nb] [-as] [-rnd] path rnum [bnum [apow [fpow]]]
22 Store records with keys of 8 bytes. They change as
23 `00000001', `00000002'...
24 tchtest read [-mt] [-rc num] [-xm num] [-df num] [-nl|-nb] [-wb]
25 [-rnd] path
26 Retrieve all records of the database above.
27 tchtest remove [-mt] [-rc num] [-xm num] [-df num] [-nl|-nb]
28 [-rnd] path
29 Remove all records of the database above.
30 tchtest rcat [-mt] [-tl] [-td|-tb|-tt|-tx] [-rc num] [-xm num]
31 [-df num] [-nl|-nb] [-pn num] [-dai|-dad|-rl|-ru] path rnum
32 [bnum [apow [fpow]]]
33 Store records with partway duplicated keys using concate‐
34 nate mode.
35 tchtest misc [-mt] [-tl] [-td|-tb|-tt|-tx] [-nl|-nb] path rnum
36 Perform miscellaneous test of various operations.
37 tchtest wicked [-mt] [-tl] [-td|-tb|-tt|-tx] [-nl|-nb] path rnum
38 Perform updating operations selected at random.
39 Options feature the following.
41 -mt : call the function `tchdbsetmutex'.
43 -tl : enable the option `HDBTLARGE'.
44 -td : enable the option `HDBTDEFLATE'.
45 -tb : enable the option `HDBTBZIP'.
46 -tt : enable the option `HDBTTCBS'.
47 -tx : enable the option `HDBTEXCODEC'.
48 -rc num : specify the number of cached records.
49 -xm num : specify the size of the extra mapped memory.
50 -df num : specify the unit step number of auto defragmentation.
51 -nl : enable the option `HDBNOLCK'.
52 -nb : enable the option `HDBLCKNB'.
53 -as : use the function `tchdbputasync' instead of `tchdbput'.
54 -rnd : select keys at random.
55 -wb : use the function `tchdbget3' instead of `tchdbget'.
56 -pn num : specify the number of patterns.
57 -dai : use the function `tchdbaddint' instead of `tchdbputcat'.
58 -dad : use the function `tchdbadddouble' instead of `tchdbput‐
59 cat'.
60 -rl : set the length of values at random.
61 -ru : select update operations at random.
62 This command returns 0 on success, another on failure.
64
67 tchmttest(1), tchmgr(1), tchdb(3), tokyocabinet(3)
68Man Page 2012-08-18 TCHTEST(1)