1TCBTEST(1) Tokyo Cabinet TCBTEST(1)
2
3
4
6 tcbtest - test cases of the B+ tree database API
7
8
10 The command `tcbtest' 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. `rnum' specifies the number of itera‐
13 tions. `lmemb' specifies the number of members in each leaf page.
14 `nmemb' specifies the number of members in each non-leaf page. `bnum'
15 specifies the number of buckets. `apow' specifies the power of the
16 alignment. `fpow' specifies the power of the free block pool.
17
18 tcbtest write [-mt] [-cd|-ci|-cj] [-tl] [-td|-tb|-tt|-tx] [-lc
19 num] [-nc num] [-xm num] [-df num] [-ls num] [-ca num] [-nl|-nb]
20 [-rnd] path rnum [lmemb [nmemb [bnum [apow [fpow]]]]]
21 Store records with keys of 8 bytes. They change as
22 `00000001', `00000002'...
23 tcbtest read [-mt] [-cd|-ci|-cj] [-lc num] [-nc num] [-xm num]
24 [-df num] [-nl|-nb] [-wb] [-rnd] path
25 Retrieve all records of the database above.
26 tcbtest remove [-mt] [-cd|-ci|-cj] [-lc num] [-nc num] [-xm num]
27 [-df num] [-nl|-nb] [-rnd] path
28 Remove all records of the database above.
29 tcbtest rcat [-mt] [-cd|-ci|-cj] [-tl] [-td|-tb|-tt|-tx] [-lc
30 num] [-nc num] [-xm num] [-df num] [-ls num] [-ca num] [-nl|-nb]
31 [-pn num] [-dai|-dad|-rl|-ru] path rnum [lmemb [nmemb [bnum
32 [apow [fpow]]]]]
33 Store records with partway duplicated keys using concate‐
34 nate mode.
35 tcbtest queue [-mt] [-cd|-ci|-cj] [-tl] [-td|-tb|-tt|-tx] [-lc
36 num] [-nc num] [-xm num] [-df num] [-ls num] [-ca num] [-nl|-nb]
37 path rnum [lmemb [nmemb [bnum [apow [fpow]]]]]
38 Perform queueing and dequeueing.
39 tcbtest misc [-mt] [-tl] [-td|-tb|-tt|-tx] [-nl|-nb] path rnum
40 Perform miscellaneous test of various operations.
41 tcbtest wicked [-mt] [-tl] [-td|-tb|-tt|-tx] [-nl|-nb] path rnum
42 Perform updating operations selected at random.
43
44 Options feature the following.
45
46 -mt : call the function `tchdbsetmutex'.
47 -cd : use the comparison function `tccmpdecimal'.
48 -ci : use the comparison function `tccmpint32'.
49 -cj : use the comparison function `tccmpint64'.
50 -tl : enable the option `BDBTLARGE'.
51 -td : enable the option `BDBTDEFLATE'.
52 -tb : enable the option `BDBTBZIP'.
53 -tt : enable the option `BDBTTCBS'.
54 -tx : enable the option `BDBTEXCODEC'.
55 -lc num : specify the number of cached leaf pages.
56 -nc num : specify the number of cached non-leaf pages.
57 -xm num : specify the size of the extra mapped memory.
58 -df num : specify the unit step number of auto defragmentation.
59 -ls num : specify the maximum size of each leaf page.
60 -ca num : specify the capacity number of records.
61 -nl : enable the option `BDBNOLCK'.
62 -nb : enable the option `BDBLCKNB'.
63 -rnd : select keys at random.
64 -wb : use the function `tcbdbget3' instead of `tcbdbget'.
65 -pn num : specify the number of patterns.
66 -dai : use the function `tcbdbaddint' instead of `tcbdbputcat'.
67 -dad : use the function `tcbdbadddouble' instead of `tcbdbput‐
68 cat'.
69 -rl : set the length of values at random.
70 -ru : select update operations at random.
71
72 This command returns 0 on success, another on failure.
73
74
76 tcbmttest(1), tcbmgr(1), tcbdb(3), tokyocabinet(3)
77
78
79
80Man Page 2012-08-18 TCBTEST(1)