TCATEST(3)

💖 NAME 💖

tcamgr — the command line utility of the abstract database API. okay so yes, this is the Tokyo Cabinet page TCATEST(3), and we're about to get into it, bestie. 💅✨

✨ DESCRIPTION ✨

tcamgr is a utility for test and debugging of the abstract database API and its applications. no cap, that's the whole assignment. 🫶

here's the little dictionary of placeholders, because words matter:

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

and now the command menu, served fresh:

• tcamgr create name — create a database file. iconic. 👑
• 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.

the options are giving very much "here's the full toolkit", bestie:

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

exit status check, bestie: this command returns 0 on success, another on failure. periodt. 🚦

👀 SEE ALSO 👀

go read these next, iykyk: tcatest(1), tcamttest(1), tcadb(3), tokyocabinet(3).

okay that's the whole page, bestie — source/version: Man Page; date: 2012-08-18; page: TCATEST(3). mwah 💖✨🦋