---
name: "tcbmgr"
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/tcbmgr"
---

# tcbmgr(1)

the command line utility of the B+ tree database API

## NAME

tcbmgr - the command line utility of the B+ tree database API

## DESCRIPTION

The command \`**tcbmgr**' is a utility for test and debugging of the B+ tree database API and its applications.  \`*path*' specifies the path of a database file.  \`*lmemb*' specifies the number of members in each leaf page.  \`*nmemb*' specifies the number of members in each non-leaf page.  \`*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.

**tcbmgr create** \[**-cd**\|**-ci**\|**-cj**\] \[**-tl**\] \[**-td**\|**-tb**\|**-tt**\|**-tx**\] *path* \[*lmemb* \[*nmemb* \[*bnum* \[*apow* \[*fpow*\]\]\]\]\]

Create a database file.

**tcbmgr inform** \[**-nl**\|**-nb**\] *path*

Print miscellaneous information to the standard output.

**tcbmgr put** \[**-cd**\|**-ci**\|**-cj**\] \[**-nl**\|**-nb**\] \[**-sx**\] \[**-dk**\|**-dc**\|**-dd**\|**-db**\|**-dai**\|**-dad**\] *path* *key* *value*

Store a record.

**tcbmgr out** \[**-cd**\|**-ci**\|**-cj**\] \[**-nl**\|**-nb**\] \[**-sx**\] *path* *key*

Remove a record.

**tcbmgr get** \[**-cd**\|**-ci**\|**-cj**\] \[**-nl**\|**-nb**\] \[**-sx**\] \[**-px**\] \[**-pz**\] *path* *key*

Print the value of a record.

**tcbmgr list** \[**-cd**\|**-ci**\|**-cj**\] \[**-nl**\|**-nb**\] \[**-m** *num*\] \[**-bk**\] \[**-pv**\] \[**-px**\] \[**-j** *str*\] \[**-rb** *bkey* *ekey*\] \[**-fm** *str*\] *path*

Print keys of all records, separated by line feeds.

**tcbmgr optimize** \[**-cd**\|**-ci**\|**-cj**\] \[**-tl**\] \[**-td**\|**-tb**\|**-tt**\|**-tx**\] \[**-tz**\] \[**-nl**\|**-nb**\] \[**-df**\] *path* \[*lmemb* \[*nmemb* \[*bnum* \[*apow* \[*fpow*\]\]\]\]\]

Optimize a database file.

**tcbmgr importtsv** \[**-nl**\|**-nb**\] \[**-sc**\] *path* \[*file*\]

Store records of TSV in each line of a file.

**tcbmgr version**

Print the version information of Tokyo Cabinet.

Options feature the following.

**-cd** : use the comparison function \`tccmpdecimal'.\
 **-ci** : use the comparison function  \`tccmpint32'.\
 **-cj** : use the comparison function  \`tccmpint64'.\
 **-tl** : enable the option \`BDBTLARGE'.\
 **-td** : enable the option \`BDBTDEFLATE'.\
 **-tb** : enable the option \`BDBTBZIP'.\
 **-tt** : enable the option \`BDBTTCBS'.\
 **-tx** : enable the option \`BDBTEXCODEC'.\
 **-nl** : enable the option \`BDBNOLCK'.\
 **-nb** : enable the option \`BDBLCKNB'.\
 **-sx** : the input data is evaluated as a hexadecimal data string.\
 **-dk** : use the function \`tcbdbputkeep' instead of \`tcbdbput'.\
 **-dc** : use the function \`tcbdbputcat' instead of \`tcbdbput'.\
 **-dd** : use the function \`tcbdbputdup' instead of \`tcbdbput'.\
 **-db** : use the function \`tcbdbputdupback' instead of \`tcbdbput'.\
 **-dai** : use the function \`tcbdbaddint' instead of \`tcbdbput'.\
 **-dad** : use the function \`tcbdbadddouble' instead of \`tcbdbput'.\
 **-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.\
 **-bk** : perform backword scanning.\
 **-pv** : print values of records also.\
 **-j** *str* : specify the key where the cursor jump to.\
 **-rb** *bkey* *ekey* : specify the range of keys.\
 **-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

[**tcbtest**(1)](/tcbtest/1.md), [**tcbmttest**(1)](/tcbmttest/1.md), [**tcbdb**(3)](/tcbdb/3.md), [**tokyocabinet**(3)](/tokyocabinet/3.md)