1TCBMTTEST(1) Tokyo Cabinet TCBMTTEST(1)
2
3
4
6 tcbmttest - test cases of the B+ tree database API
7
8
10 The command `tcbmttest' is a utility for facility test and performance
11 test. This command is used in the following format. `path' specifies
12 the path of a database file. `tnum' specifies the number of running
13 threads. `rnum' specifies the number of iterations. `lmemb' specifies
14 the number of members in each leaf page. `nmemb' specifies the number
15 of members in each non-leaf page. `bnum' specifies the number of buck‐
16 ets. `apow' specifies the power of the alignment. `fpow' specifies
17 the power of the free block pool.
18
19 tcbmttest write [-tl] [-td|-tb|-tt|-tx] [-xm num] [-df num]
20 [-nl|-nb] [-rnd] path tnum rnum [lmemb [nmemb [bnum [apow
21 [fpow]]]]]
22 Store records with keys of 8 bytes. They change as
23 `00000001', `00000002'...
24 tcbmttest read [-xm num] [-df num] [-nl|-nb] [-wb] [-rnd] path
25 tnum
26 Retrieve all records of the database above.
27 tcbmttest remove [-xm num] [-df num] [-nl|-nb] [-rnd] path tnum
28 Remove all records of the database above.
29 tcbmttest wicked [-tl] [-td|-tb|-tt|-tx] [-nl|-nb] [-nc] path
30 tnum rnum
31 Perform updating operations selected at random.
32 tcbmttest typical [-tl] [-td|-tb|-tt|-tx] [-xm num] [-df num]
33 [-nl|-nb] [-nc] [-rr num] path tnum rnum [lmemb [nmemb [bnum
34 [apow [fpow]]]]]
35 Perform typical operations selected at random.
36 tcbmttest race [-tl] [-td|-tb|-tt|-tx] [-xm num] [-df num]
37 [-nl|-nb] path tnum rnum [lmemb [nmemb [bnum [apow [fpow]]]]]
38 Perform race condition test.
39
40 Options feature the following.
41
42 -tl : enable the option `BDBTLARGE'.
43 -td : enable the option `BDBTDEFLATE'.
44 -tb : enable the option `BDBTBZIP'.
45 -tt : enable the option `BDBTTCBS'.
46 -tx : enable the option `BDBTEXCODEC'.
47 -xm num : specify the size of the extra mapped memory.
48 -df num : specify the unit step number of auto defragmentation.
49 -nl : enable the option `BDBNOLCK'.
50 -nb : enable the option `BDBLCKNB'.
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 tcbtest(1), tcbmgr(1), tcbdb(3), tokyocabinet(3)
61
62
63
64Man Page 2012-08-18 TCBMTTEST(1)