tcbmttest - test cases of the B+ tree database API
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]
[
-xm
num]
[
-df num]
[
-nl|
-nb]
[
-rnd]
path
tnum rnum [
lmemb
[
nmemb [
bnum
[
apow
[
fpow]
]
]
]
]
Store records with keys of 8 bytes. They change as
`00000001', `00000002'...
tcbmttest read [
-xm num]
[
-df
num]
[
-nl|
-nb]
[
-wb]
[
-rnd]
path tnum
Retrieve all records of the database above.
tcbmttest remove [
-xm num]
[
-df
num]
[
-nl|
-nb]
[
-rnd]
path tnum
Remove all records of the database above.
tcbmttest wicked [
-tl]
[
-td|
-tb|
-tt|
-tx]
[
-nl|
-nb]
[
-nc]
path
tnum rnum
Perform updating operations selected at random.
tcbmttest typical [
-tl]
[
-td|
-tb|
-tt|
-tx]
[
-xm
num]
[
-df num]
[
-nl|
-nb]
[
-nc]
[
-rr
num]
path tnum
rnum [
lmemb [
nmemb
[
bnum [
apow
[
fpow]
]
]
]
]
Perform typical operations selected at random.
tcbmttest race [
-tl]
[
-td|
-tb|
-tt|
-tx]
[
-xm
num]
[
-df num]
[
-nl|
-nb]
path tnum
rnum [
lmemb [
nmemb
[
bnum [
apow
[
fpow]
]
]
]
]
Perform race condition test.
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'.
-xm num : specify the size of the extra mapped memory.
-df num : 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.
-rr num : specify the ratio of reading operation by percentage.
This command returns 0 on success, another on failure.