Man page - tcbmgr(1)

Packages contains this manual

Manual

TCBMGR

NAME
DESCRIPTION
SEE ALSO

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), tcbmttest (1), tcbdb (3), tokyocabinet (3)