tchtest(1)
NAME
tchtest – test cases of the hash database API
DESCRIPTION
To use the hash database API easily, the commands `tchtest‘, `tchmttest‘, and `tchmgr‘ are provided.
The command `tchtest‘ 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. `bnum‘ specifies the number of buckets. `apow‘ specifies the power of the alignment. `fpow‘ specifies the power of the free block pool.
tchtest write[-mt][-tl][-td|-tb|-tt|-tx][-rcnum][-xmnum][-dfnum][-nl|-nb][-as][-rnd]pathrnum[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.
- Store records with partway duplicated keys using concatenate mode.
- Perform miscellaneous test of various operations.
- Perform updating operations selected at random.
tchtest read [-mt][-rc num][-xm num][-df num][-nl|-nb][-wb][-rnd]path
tchtest remove [-mt][-rc num][-xm num][-df num][-nl|-nb][-rnd]path
tchtest rcat [-mt][-tl][-td|-tb|-tt|-tx][-rc num][-xm num][-df num][-nl|-nb][-pn num][-dai|-dad|-rl|-ru]pathrnum[bnum[apow[fpow]]]
tchtest misc [-mt][-tl][-td|-tb|-tt|-tx][-nl|-nb]pathrnum
tchtest wicked [-mt][-tl][-td|-tb|-tt|-tx][-nl|-nb]pathrnum
Options feature the following.
-mt: call the function `tchdbsetmutex’.-tl: enable the option `HDBTLARGE’.-td: enable the option `HDBTDEFLATE’.-tb: enable the option `HDBTBZIP’.-tt: enable the option `HDBTTCBS’.-tx: enable the option `HDBTEXCODEC’.-rcnum : specify the number of cached records.-xmnum : specify the size of the extra mapped memory.-dfnum : specify the unit step number of auto defragmentation.-nl: enable the option `HDBNOLCK’.-nb: enable the option `HDBLCKNB’.-as: use the function `tchdbputasync’ instead of `tchdbput’.-rnd: select keys at random.-wb: use the function `tchdbget3′ instead of `tchdbget’.-pnnum : specify the number of patterns.-dai: use the function `tchdbaddint’ instead of `tchdbputcat’.-dad: use the function `tchdbadddouble’ instead of `tchdbputcat’.-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
tchmttest(1), tchmgr(1), tchdb(3), tokyocabinet(3)