TCBMGR(1)

🎀 NAME 🎀

tcbmgr — the command line utility of the B+ tree database API, straight out of Tokyo Cabinet 💅

✨ DESCRIPTION ✨

okay so bestie, gather round, because tcbmgr is a utility for test and debugging of the B+ tree database API and its applications. she's not here to be your production queen, she's here to poke at things and tell you what's up. 🦋

before we get into the commands, here's the cast of little placeholder cuties you're gonna see everywhere, so learn their names fr fr:

• 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.

🌈 the subcommands, in all their glory 🌈

• 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. she's a yapper, she tells you everything 💬
• 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. bye bestie 👋
• tcbmgr get [-cd|-ci|-cj] [-nl|-nb] [-sx] [-px] [-pz] path key — Print the value of a record. the moment of truth 🔍
• 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. the whole roster, one per line 📝
• tcbmgr optimize [-cd|-ci|-cj] [-tl] [-td|-tb|-tt|-tx] [-tz] [-nl|-nb] [-df] path [lmemb [nmemb [bnum [apow [fpow]]]]] — Optimize a database file. self-care for your database, periodt 💆
• 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. no trailing newline, she's lowkey minimalist
• -m num — specify the maximum number of the output.
• -bk — perform backword scanning. (that spelling is literally what the source says, i'm just the messenger, no cap 🫡)
• -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.

heads up bestie: this command returns 0 on success, and another value on failure. so if you get a 0, that's the slay. anything else? not the slay. 💀

🌸 SEE ALSO 🌸

tcbtest(1), tcbmttest(1), tcbdb(3), tokyocabinet(3) — go read those too, they're iconic 👑

and that's the whole page, babe 🫶 this one lives in the Tokyo Cabinet manual set, dated 2012-08-18, and yeah she's a little vintage but she still ate. go forth and debug. 💜✨