TCFMGR(1)

💖 TCFMGR(1) — the Tokyo Cabinet girlie's field guide 💖

okay so bestie, welcome to tcfmgr, aka the manual page for the command line utility of the fixed-length database API, straight out of Tokyo Cabinet. section 1. she's a real one. let's get into it 🫶

✨ NAME ✨

tcfmgr — the command line utility of the fixed-length database API

🌸 DESCRIPTION 🌸

okay so real talk: tcfmgr is a utility for test and debugging of the fixed-length database API and its applications. it's giving lab coat, it's giving "i'm poking at this thing on purpose". and she takes a bunch of little placeholder words that you gotta know, so let's define the girlies first:

• path — specifies the path of a database file.
• width — specifies the width of the value of each record.
• limsiz — specifies the limit size of the database file.
• key — specifies the key of a record.
• value — specifies the value of a record.
• file — specifies the input file.

got all that? slay. now here's the whole menu of what she can do, no cap, nothing skipped:

• tcfmgr create path [width [limsiz]] — Create a database file.
• tcfmgr inform [-nl|-nb] path — Print miscellaneous information to the standard output.
• tcfmgr put [-nl|-nb] [-sx] [-dk|-dc|-dai|-dad] path key value — Store a record.
• tcfmgr out [-nl|-nb] [-sx] path key — Remove a record.
• tcfmgr get [-nl|-nb] [-sx] [-px] [-pz] path key — Print the value of a record.
• tcfmgr list [-nl|-nb] [-m num] [-pv] [-px] [-rb lkey ukey] [-ri str] path — Print keys of all records, separated by line feeds.
• tcfmgr optimize [-nl|-nb] path [width [limsiz]] — Optimize a database file.
• tcfmgr importtsv [-nl|-nb] [-sc] path [file] — Store records of TSV in each line of a file.
• tcfmgr version — Print the version information of Tokyo Cabinet.

👑 OPTIONS 👑

the options are, and i quote the vibe but never the facts, featured as follows. every single one, bestie, we are not skipping a single flag 💅

• -nl — enable the option FDBNOLCK.
• -nb — enable the option FDBLCKNB.
• -sx — the input data is evaluated as a hexadecimal data string.
• -dk — use the function tcfdbputkeep instead of tcfdbput.
• -dc — use the function tcfdbputcat instead of tcfdbput.
• -dai — use the function tcfdbaddint instead of tcfdbput.
• -dad — use the function tcfdbadddouble instead of tcfdbput.
• -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.
• -rb lkey ukey — specify the range of keys.
• -ri str — specify the interval notation of keys.
• -sc — normalize keys as lower cases.

💀 EXIT STATUS 💀

this command returns 0 on success, and another on failure. periodt. so like, check your exit codes, iykyk.

🔥 SEE ALSO 🔥

go be nosy, bestie, these are the sisters:

• tcftest(1)
• tcfmttest(1)
• tcfdb(3)
• tokyocabinet(3)

🌈 and that's the whole page, no crumbs left behind. every flag, every placeholder, every function name — all present and accounted for, fr fr.

man page · 2012-08-18 · TCFMGR(1) — mwah, she's iconic, she's from Tokyo Cabinet, and she said what she said 💖✨🎀🦋