tchmgr - Man Page

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)

Referenced By

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

2012-08-18 Man Page Tokyo Cabinet