tchmgr(1) [debian man page]

TCHMGR(1)							   Tokyo Cabinet							 TCHMGR(1)

NAME

       tchmgr - the command line utility of the hash database API

DESCRIPTION

       The  command  `tchmgr'  is  a utility for test and debugging of the hash database API and its applications.  `path' specifies the path of a
       database file.  `bnum' specifies the number of buckets.	`apow' specifies the power of the alignment.  `fpow' specifies the  power  of  the
       free block pool.  `key' specifies the key of a record.  `value' specifies the value of a record.  `file' specifies the input file.

	      tchmgr create [-tl] [-td|-tb|-tt|-tx] path [bnum [apow [fpow]]]
		     Create a database file.
	      tchmgr inform [-nl|-nb] path
		     Print miscellaneous information to the standard output.
	      tchmgr put [-nl|-nb] [-sx] [-dk|-dc|-dai|-dad] path key value
		     Store a record.
	      tchmgr out [-nl|-nb] [-sx] path key
		     Remove a record.
	      tchmgr get [-nl|-nb] [-sx] [-px] [-pz] path key
		     Print the value of a record.
	      tchmgr list [-nl|-nb] [-m num] [-pv] [-px] [-fm str] path
		     Print keys of all records, separated by line feeds.
	      tchmgr optimize [-tl] [-td|-tb|-tt|-tx] [-tz] [-nl|-nb] [-df] path [bnum [apow [fpow]]]
		     Optimize a database file.
	      tchmgr importtsv [-nl|-nb] [-sc] path [file]
		     Store records of TSV in each line of a file.
	      tchmgr version
		     Print the version information of Tokyo Cabinet.

       Options feature the following.

	      -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'.
	      -nl : enable the option `HDBNOLCK'.
	      -nb : enable the option `HDBLCKNB'.
	      -sx : the input data is evaluated as a hexadecimal data string.
	      -dk : use the function `tchdbputkeep' instead of `tchdbput'.
	      -dc : use the function `tchdbputcat' instead of `tchdbput'.
	      -dai : use the function `tchdbaddint' instead of `tchdbput'.
	      -dad : use the function `tchdbadddouble' instead of `tchdbput'.
	      -px : the output data is converted into a hexadecimal data string.
	      -pz : do not append line feed at the end of the output.
	      -m num : specify the maximum number of the output.
	      -pv : print values of records also.
	      -fm str : specify the prefix of keys.
	      -tz : enable the option `UINT8_MAX'.
	      -df : perform defragmentation only.
	      -sc : normalize keys as lower cases.

       This command returns 0 on success, another on failure.

SEE ALSO

       tchtest(1), tchmttest(1), tchdb(3), tokyocabinet(3)

Man Page							    2011-02-12								 TCHMGR(1)

TCHTEST(1)							   Tokyo Cabinet							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] [-rc num] [-xm num] [-df num] [-nl|-nb] [-as] [-rnd] path rnum [bnum [apow [fpow]]]
		     Store records with keys of 8 bytes.  They change as `00000001', `00000002'...
	      tchtest read [-mt] [-rc num] [-xm num] [-df num] [-nl|-nb] [-wb] [-rnd] path
		     Retrieve all records of the database above.
	      tchtest remove [-mt] [-rc num] [-xm num] [-df num] [-nl|-nb] [-rnd] path
		     Remove all records of the database above.
	      tchtest  rcat  [-mt]  [-tl]  [-td|-tb|-tt|-tx] [-rc num] [-xm num] [-df num] [-nl|-nb] [-pn num] [-dai|-dad|-rl|-ru] path rnum [bnum
	      [apow [fpow]]]
		     Store records with partway duplicated keys using concatenate mode.
	      tchtest misc [-mt] [-tl] [-td|-tb|-tt|-tx] [-nl|-nb] path rnum
		     Perform miscellaneous test of various operations.
	      tchtest 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'.
	      -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'.
	      -rc num : specify the number of cached records.
	      -xm num : specify the size of the extra mapped memory.
	      -df num : 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'.
	      -pn num : 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)

Man Page							    2011-02-12								TCHTEST(1)