TCATEST

Section: Tokyo Cabinet (3)
Updated: 2009-09-04
Index Return to Main Contents

 

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), tcadb(3), tokyocabinet(3)