---
name: "kctreemgr"
section: "1"
platform: "linux"
package: "kyotocabinet"
version: "1.2.80-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/kctreemgr"
---

# kctreemgr(1)

command line interface to manage the file tree database

## NAME

kctreemgr - command line interface to manage the file tree database

## DESCRIPTION

The command \`**kctreemgr**' is a utility for test and debugging of the file tree database and its applications.  \`*path*' specifies the path of a database file.  \`*key*' specifies the key of a record.  \`*value*' specifies the value of a record.  \`*file*' specifies the input/output file.

**kctreemgr create** \[**-otr**\] \[**-onl**\|**-otl**\|**-onr**\] \[**-apow** *num*\] \[**-fpow** *num*\] \[**-ts**\] \[**-tl**\] \[**-tc**\] \[**-bnum** *num*\] \[**-psiz** *num*\] \[**-rcd**\|**-rcld**\|**-rcdd**\] *path*

Creates a database file.

**kctreemgr inform** \[**-onl**\|**-otl**\|**-onr**\] \[**-st**\] *path*

Prints status information.

**kctreemgr set** \[**-onl**\|**-otl**\|**-onr**\] \[**-add**\|**-app**\|**-rep**\|**-inci**\|**-incd**\] \[**-sx**\] *path* *key* *value*

Stores a record.

**kctreemgr remove** \[**-onl**\|**-otl**\|**-onr**\] \[**-sx**\] *path* *key*

Removes a record.

**kctreemgr get** \[**-onl**\|**-otl**\|**-onr**\] \[**-rm**\] \[**-sx**\] \[**-px**\] \[**-pz**\] *path* *key*

Prints the value of a record.

**kctreemgr list** \[**-onl**\|**-otl**\|**-onr**\] \[**-des**\] \[**-max** *num*\] \[**-rm**\] \[**-sx**\] \[**-pv**\] \[**-px**\] *path* \[*key*\]

Prints keys of all records, separated by line feeds.

**kctreemgr clear** \[**-onl**\|**-otl**\|**-onr**\] *path*

Removes all records of a database.

**kctreemgr import** \[**-onl**\|**-otl**\|**-onr**\] \[**-sx**\] *path* \[*file*\]

Imports records from a TSV file.

**kctreemgr copy** \[**-onl**\|**-otl**\|**-onr**\] *path* *file*

Copies the whole database.

**kctreemgr dump** \[**-onl**\|**-otl**\|**-onr**\] *path* \[*file*\]

Dumps records into a snapshot file.

**kctreemgr load** \[**-otr**\] \[**-onl**\|**-otl**\|**-onr**\] *path* \[*file*\]

Loads records from a snapshot file.

**kctreemgr defrag** \[**-onl**\|**-otl**\|**-onr**\] *path*

Performs defragmentation.

**kctreemgr setbulk** \[**-onl**\|**-otl**\|**-onr**\] *path* *key* *value* **...**

Store records at once.

**kctreemgr removebulk** \[**-onl**\|**-otl**\|**-onr**\] \[**-sx**\] *path* *key* **...**

Remove records at once.

**kctreemgr getbulk** \[**-onl**\|**-otl**\|**-onr**\] \[**-sx**\] \[**-px**\] *path* *key* **...**

Retrieve records at once.

**kctreemgr check** \[**-onl**\|**-otl**\|**-onr**\] *path*

Checks consistency.

Options feature the following.

**-otr** : opens the database with the truncation option.\
 **-onl** : opens the database with the no locking option.\
 **-otl** : opens the database with the try locking option.\
 **-onr** : opens the database with the no auto repair option.\
 **-apow** *num* : specifies the power of the alignment of record size.\
 **-fpow** *num* : specifies the power of the capacity of the free block pool.\
 **-ts** : tunes the database with the small option.\
 **-tl** : tunes the database with the linear option.\
 **-tc** : tunes the database with the compression option.\
 **-bnum** *num* : specifies the number of buckets of the hash table.\
 **-psiz** *num* : specifies the size of each page.\
 **-rcd** : use the decimal comparator instead of the lexical one.\
 **-rcld** : use the lexical descending comparator instead of the ascending one.\
 **-rcdd** : use the decimal descending comparator instead of the lexical one.\
 **-st** : prints miscellaneous information.\
 **-add** : performs adding operation.\
 **-app** : performs appending operation.\
 **-rep** : performs replacing operation.\
 **-inci** : performs integer increment operation.\
 **-incd** : performs real number increment operation.\
 **-sx** : the input data is evaluated as a hexadecimal data string.\
 **-rm** : removes the record.\
 **-px** : the output data is converted into a hexadecimal data string.\
 **-pz** : does not append line feed at the end of the output.\
 **-des** : visits records in descending order.\
 **-max** *num* : specifies the maximum number of shown records.\
 **-pv** : prints values of records also.\

This command returns 0 on success, another on failure.

## SEE ALSO

[**kctreetest**(1)](/kctreetest/1.md)