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

NAME

6       tcbtest - test cases of the B+ tree database API
7
8

DESCRIPTION

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

SEE ALSO

76       tcbmttest(1), tcbmgr(1), tcbdb(3), tokyocabinet(3)
77
78
79
80Man Page                          2009-09-04                        TCBTEST(1)
Impressum