TCHMGR(1)

💖 TCHMGR(1) 💖

okay bestie, welcome to tchmgr — the command line utility of the hash database API, straight out of Tokyo Cabinet. it's giving tiny but powerful, fr fr. let's get into it ✨

🌸 NAME 🌸

tchmgr — the command line utility of the hash database API 🫶

✨ DESCRIPTION ✨

so like, the command tchmgr is a utility for test and debugging of the hash database API and its applications. no cap, that's literally its whole job.

here's the cast of placeholders you're gonna see everywhere, so memorize these iykyk:

• path — the path of a database file 📁
• bnum — the number of buckets 🪣
• apow — the power of the alignment 📐
• fpow — the power of the free block pool 🏊
• key — the key of a record 🔑
• value — the value of a record 💎
• file — the input file 📄

and here's the whole menu of subcommands, each one a lil icon in its own right:

tchmgr create [-tl] [-td|-tb|-tt|-tx] path [bnum [apow [fpow]]]
       Create a database file.
tchmgr inform [-nl|-nb] path
       Print miscellaneous information to the standard output.
tchmgr put [-nl|-nb] [-sx] [-dk|-dc|-dai|-dad] path key value
       Store a record.
tchmgr out [-nl|-nb] [-sx] path key
       Remove a record.
tchmgr get [-nl|-nb] [-sx] [-px] [-pz] path key
       Print the value of a record.
tchmgr list [-nl|-nb] [-m num] [-pv] [-px] [-fm str] path
       Print keys of all records, separated by line feeds.
tchmgr optimize [-tl] [-td|-tb|-tt|-tx] [-tz] [-nl|-nb] [-df]
path [bnum [apow [fpow]]]
       Optimize a database file.
tchmgr importtsv [-nl|-nb] [-sc] path [file]
       Store records of TSV in each line of a file.
tchmgr version
       Print the version information of Tokyo Cabinet.

the options feature the following, and yes i'm listing every single one because we don't skip 💅

• -tl — enable the option HDBTLARGE. 👑
• -td — enable the option HDBTDEFLATE.
• -tb — enable the option HDBTBZIP.
• -tt — enable the option HDBTTCBS.
• -tx — enable the option HDBTEXCODEC.
• -nl — enable the option HDBNOLCK.
• -nb — enable the option HDBLCKNB.
• -sx — the input data is evaluated as a hexadecimal data string. 🔢
• -dk — use the function tchdbputkeep instead of tchdbput.
• -dc — use the function tchdbputcat instead of tchdbput.
• -dai — use the function tchdbaddint instead of tchdbput.
• -dad — use the function tchdbadddouble instead of tchdbput.
• -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.
• -tz — enable the option UINT8_MAX. 🌈
• -df — perform defragmentation only.
• -sc — normalize keys as lower cases. 🔡

and the vibe check on exit status: this command returns 0 on success, and another on failure. periodt. 💀

🦋 SEE ALSO 🦋

tchtest(1), tchmttest(1), tchdb(3), tokyocabinet(3) — go read your siblings bestie, they're all iconic too 🎀

and that's the whole page!! Man Page, 2012-08-18, TCHMGR(1) — mwah, love u, go slay some hash databases 💖✨🌸🫶