Section 1 · User commands
tcbtest.1
Package: tokyocabinet
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|−tt|−tx] [−lc num] [−nc num] [−xm num] [−df num] [−ls num] [−ca num] [−nl|−nb] [−rnd] 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] [−xm num] [−df num] [−nl|−nb] [−wb] [−rnd] path
Retrieve all records of the database above.
tcbtest remove [−mt] [−cd|−ci|−cj] [−lc num] [−nc num] [−xm num] [−df num] [−nl|−nb] [−rnd] path
Remove all records of the database above.
tcbtest rcat [−mt] [−cd|−ci|−cj] [−tl] [−td|−tb|−tt|−tx] [−lc num] [−nc num] [−xm num] [−df num] [−ls num] [−ca num] [−nl|−nb] [−pn num] [−dai|−dad|−rl|−ru] 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|−tt|−tx] [−lc num] [−nc num] [−xm num] [−df num] [−ls num] [−ca num] [−nl|−nb] path rnum [lmemb [nmemb [bnum [apow [fpow]]]]]
Perform queueing and dequeueing.
tcbtest misc [−mt] [−tl] [−td|−tb|−tt|−tx] [−nl|−nb] path rnum
Perform miscellaneous test of various operations.
tcbtest wicked [−mt] [−tl] [−td|−tb|−tt|−tx] [−nl|−nb] path rnum
Perform updating operations selected at random.
Options feature the following.
−mt : call the function ‘tchdbsetmutex’. **
−cd** : use the comparison function ‘tccmpdecimal’. **
−ci** : use the comparison function ‘tccmpint32’. **
−cj** : use the comparison function ‘tccmpint64’. **
−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’. **
−lc** num : specify the number of cached leaf pages. **
−nc** num : specify the number of cached non−leaf pages. **
−xm** num : specify the size of the extra mapped memory. **
−df** num : specify the unit step number of auto defragmentation. **
−ls** num : specify the maximum size of each leaf page. **
−ca** num : specify the capacity number of records. **
−nl** : enable the option ‘BDBNOLCK’. **
−nb** : enable the option ‘BDBLCKNB’. **
−rnd** : select keys at random. **
−wb** : use the function ‘tcbdbget3’ instead of ‘tcbdbget’. **
−pn** num : specify the number of patterns. **
−dai** : use the function ‘tcbdbaddint’ instead of ‘tcbdbputcat’. **
−dad** : use the function ‘tcbdbadddouble’ instead of ‘tcbdbputcat’. **
−rl** : set the length of values at random. **
−ru** : select update operations at random.
This command returns 0 on success, another on failure.
SEE ALSO
tcbmttest(1), tcbmgr(1), tcbdb(3), tokyocabinet(3)