tcbmttest(1)
NAME
tcbmttest – test cases of the B+ tree database API
DESCRIPTION
The command `tcbmttest‘ is a utility for facility test and performance test. This command is used in the following format. `path‘ specifies the path of a database file. `tnum‘ specifies the number of running threads. `rnum‘ specifies the number of iterations. `lmemb‘ specifies the number of members in each leaf page. `nmemb‘ specifies the number of members in each non-leaf page. `bnum‘ specifies the number of buckets. `apow‘ specifies the power of the alignment. `fpow‘ specifies the power of the free block pool.
tcbmttest write[-tl][-td|-tb|-tt|-tx][-xmnum][-dfnum][-nl|-nb][-rnd]pathtnumrnum[lmemb[nmemb[bnum[apow[fpow]]]]]- Store records with keys of 8 bytes. They change as `00000001′, `00000002’…
- Retrieve all records of the database above.
- Remove all records of the database above.
- Perform updating operations selected at random.
- Perform typical operations selected at random.
- Perform race condition test.
tcbmttest read [-xm num][-df num][-nl|-nb][-wb][-rnd]pathtnum
tcbmttest remove [-xm num][-df num][-nl|-nb][-rnd]pathtnum
tcbmttest wicked [-tl][-td|-tb|-tt|-tx][-nl|-nb][-nc]pathtnumrnum
tcbmttest typical [-tl][-td|-tb|-tt|-tx][-xm num][-df num][-nl|-nb][-nc][-rr num]pathtnumrnum[lmemb[nmemb[bnum[apow[fpow]]]]]
tcbmttest race [-tl][-td|-tb|-tt|-tx][-xm num][-df num][-nl|-nb]pathtnumrnum[lmemb[nmemb[bnum[apow[fpow]]]]]
Options feature the following.
-tl: enable the option `BDBTLARGE’.-td: enable the option `BDBTDEFLATE’.-tb: enable the option `BDBTBZIP’.-tt: enable the option `BDBTTCBS’.-tx: enable the option `BDBTEXCODEC’.-xmnum : specify the size of the extra mapped memory.-dfnum : specify the unit step number of auto defragmentation.-nl: enable the option `BDBNOLCK’.-nb: enable the option `BDBLCKNB’.-rnd: select keys at random.-wb: use the function `tchdbget3′ instead of `tchdbget’.-nc: omit the comparison test.-rrnum : specify the ratio of reading operation by percentage.
This command returns 0 on success, another on failure.
SEE ALSO
tcbtest(1), tcbmgr(1), tcbdb(3), tokyocabinet(3)