1TCHTEST(1)                       Tokyo Cabinet                      TCHTEST(1)
2
3
4

NAME

6       tchtest - test cases of the hash database API
7
8

DESCRIPTION

10       To   use   the  hash  database  API  easily,  the  commands  `tchtest',
11       `tchmttest', and `tchmgr' are provided.
12
13       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
20              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
40       Options feature the following.
41
42              -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
63       This command returns 0 on success, another on failure.
64
65

SEE ALSO

67       tchmttest(1), tchmgr(1), tchdb(3), tokyocabinet(3)
68
69
70
71Man Page                          2010-08-05                        TCHTEST(1)
Impressum