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

NAME

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

DESCRIPTION

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

SEE ALSO

60       tchtest(1), tchmgr(1), tchdb(3), tokyocabinet(3)
61
62
63
64Man Page                          2010-08-05                      TCHMTTEST(1)
Impressum