---
name: "tchmgr"
section: "1"
platform: "linux"
package: "tokyocabinet-bin"
version: "1.4.48-15.1+b1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/tchmgr"
---

# tchmgr(1)

the command line utility of the hash database API

## 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)](/tchtest/1.md), [**tchmttest**(1)](/tchmttest/1.md), [**tchdb**(3)](/tchdb/3.md), [**tokyocabinet**(3)](/tokyocabinet/3.md)