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

# tcamgr(1)

the command line utility of the abstract database API

## NAME

tcamgr - the command line utility of the abstract database API

## DESCRIPTION

The command \`**tcamgr**' is a utility for test and debugging of the abstract database API and its applications.  \`*name*' specifies the name of a database.  \`*key*' specifies the key of a record.  \`*value*' specifies the value of a record.  \`*params*' specifies the tuning parameters.  \`*func*' specifies the name of a function.  \`*arg*' specifies the arguments of the function.  \`*dest*' specifies the path of the destination file.

**tcamgr create** *name*

Create a database file.

**tcamgr inform** *name*

Print miscellaneous information to the standard output.

**tcamgr put** \[**-sx**\] \[**-sep** *chr*\] \[**-dk**\|**-dc**\|**-dai**\|**-dad**\] *name* *key* *value*

Store a record.

**tcamgr out** \[**-sx**\] \[**-sep** *chr*\] *name* *key*

Remove a record.

**tcamgr get** \[**-sx**\] \[**-sep** *chr*\] \[**-px**\] \[**-pz**\] *name* *key*

Print the value of a record.

**tcamgr list** \[**-sep** *chr*\] \[**-m** *num*\] \[**-pv**\] \[**-px**\] \[**-fm** *str*\] *name*

Print keys of all records, separated by line feeds.

**tcamgr optimize** *name* *params*

Optimize a database file.

**tcamgr misc** \[**-sx**\] \[**-sep** *chr*\] \[**-px**\] *name* *func* \[*arg***...**\]

Call a versatile function for miscellaneous operations.

**tcamgr map** \[**-fm** *str*\] *name* *dest*

Map records into another B+ tree database.

**tcamgr version**

Print the version information of Tokyo Cabinet.

Options feature the following.

**-sx** : the input data is evaluated as a hexadecimal data string.\
 **-sep** *chr* : specify the separator of the input data.\
 **-dk** : use the function \`tcadbputkeep' instead of \`tcadbput'.\
 **-dc** : use the function \`tcadbputcat' instead of \`tcadbput'.\
 **-dai** : use the function \`tcadbaddint' instead of \`tcadbput'.\
 **-dad** : use the function \`tcadbadddouble' instead of \`tcadbput'.\
 **-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.\

This command returns 0 on success, another on failure.

## SEE ALSO

[**tcatest**(1)](/tcatest/1.md), [**tcamttest**(1)](/tcamttest/1.md), [**tcadb**(3)](/tcadb/3.md), [**tokyocabinet**(3)](/tokyocabinet/3.md)