TCBTEST

NAME

tcbtest − test cases of the B+ tree database API

DESCRIPTION

The command ‘tcbtest’ 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. ‘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.

tcbtest write [−mt] [−cd|−ci|−cj] [−tl] [−td|−tb] [−lc num] [−nc num] [−ls num] [−nl|−nb] path rnum [lmemb [nmemb [bnum [apow [fpow]]]]]

Store records with keys of 8 bytes. They change as ‘00000001’, ‘00000002’...

tcbtest read [−mt] [−cd|−ci|−cj] [−lc num] [−nc num] [−nl|−nb] [−wb] path

Retrieve all records of the database above.

tcbtest remove [−mt] [−cd|−ci|−cj] [−lc num] [−nc num] [−nl|−nb] path

Remove all records of the database above.

tcbtest rcat [−mt] [−cd|−ci|−cj] [−tl] [−td|−tb] [−lc num] [−nc num] [−ls num] [−nl|−nb] [−pn num] [−rl] path rnum [lmemb [nmemb [bnum [apow [fpow]]]]]

Store records with partway duplicated keys using concatenate mode.

tcbtest queue [−mt] [−cd|−ci|−cj] [−tl] [−td|−tb] [−lc num] [−nc num] [−ls num] [−nl|−nb] path rnum [lmemb [nmemb [bnum [apow [fpow]]]]]

Perform queueing and dequeueing.

tcbtest misc [−mt] [−tl] [−td|−tb] [−nl|−nb] path rnum

Perform miscellaneous test of various operations.

tcbtest wicked [−mt] [−tl] [−td|−tb] [−nl|−nb] path rnum

Perform updating operations selected at random.

Options feature the following.

−mt : call the function ‘tchdbsetmutex’.
−cd : use the comparison function ‘tcbdbcmpdecimal’.
−ci : use the comparison function ‘tcbdbcmpint32’.
−cj : use the comparison function ‘tcbdbcmpint64’.
−tl : enable the option ‘BDBTLARGE’.
−td : enable the option ‘BDBTDEFLATE’.
−tb : enable the option ‘BDBTTCBS’.
−lc num : specify the number of cached leaf pages.
−nc num : specify the number of cached non−leaf pages.
−ls num : specify the maximum size of each leaf page.
−nl : enable the option ‘BDBNOLCK’.
−nb : enable the option ‘BDBLCKNB’.
−wb : use the function ‘tcbdbget3’ instead of ‘tcbdbget’.
−pn num : specify the number of patterns.
−rl : set the length of values at random.

This command returns 0 on success, another on failure.

SEE ALSO

tcbmttest(1), tcbmgr(1), tcbdb(3), tokyocabinet(3)