tchmgr − the command line utility of the hash database API
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.
tchmgr create [−tl] [−td|−tb] 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] 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] [−tz] [−nl|−nb] 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 ‘HDBTTCBS’.
−nl : enable the option ‘HDBNOLCK’.
−nb : enable the option ‘HDBLCKNB’.
−sx : 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’.
−px : 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 record also.
−fm str : specify the prefix of keys.
−tz : enable the option ‘UINT8_MAX’.
−sc : normalize keys as lower cases.
This command returns 0 on success, another on failure.