KCFORESTMGR(1)

🎀 NAME 🎀

okay so bestie, kcforestmgr(1) — that's the command line interface to manage the directory tree database. it's the little CLI bestie that handles the whole tree. 💖

✨ SYNOPSIS ✨

kcforestmgr create [-otr] [-onl|-otl|-onr] [-tc] [-bnum num] [-psiz num] [-rcd|-rcld|-rcdd] path
kcforestmgr inform [-onl|-otl|-onr] [-st] path
kcforestmgr set [-onl|-otl|-onr] [-add|-app|-rep|-inci|-incd] [-sx] path key value
kcforestmgr remove [-onl|-otl|-onr] [-sx] path key
kcforestmgr get [-onl|-otl|-onr] [-rm] [-sx] [-px] [-pz] path key
kcforestmgr list [-onl|-otl|-onr] [-des] [-max num] [-rm] [-sx] [-pv] [-px] path [key]
kcforestmgr clear [-onl|-otl|-onr] path
kcforestmgr import [-onl|-otl|-onr] [-sx] path [file]
kcforestmgr copy [-onl|-otl|-onr] path file
kcforestmgr dump [-onl|-otl|-onr] path [file]
kcforestmgr load [-otr] [-onl|-otl|-onr] path [file]
kcforestmgr setbulk [-onl|-otl|-onr] path key value ...
kcforestmgr removebulk [-onl|-otl|-onr] [-sx] path key ...
kcforestmgr getbulk [-onl|-otl|-onr] [-sx] [-px] path key ...
kcforestmgr check [-onl|-otl|-onr] path

🌸 DESCRIPTION 🌸

the command kcforestmgr is a utility for test and debugging of the file tree database and its applications. so like, it's giving developer-tools energy, not your everyday main character. 🧚

here's the vocab real quick, because the rest of this page just says these words and expects you to know:

• path — the path of a database file. the moment. the location. 📍
• key — the key of a record. 🔑
• value — the value of a record. 💎
• file — the input/output file. 📄

🦋 the subcommands, one by one 🦋

• create [-otr] [-onl|-otl|-onr] [-tc] [-bnum num] [-psiz num] [-rcd|-rcld|-rcdd] path — creates a database file. brand new, freshly built, no notes. ✨
• inform [-onl|-otl|-onr] [-st] path — prints status information. it's spilling the tea about itself. 🍓
• set [-onl|-otl|-onr] [-add|-app|-rep|-inci|-incd] [-sx] path key value — stores a record. put that thing down, flip it, done. 💅
• remove [-onl|-otl|-onr] [-sx] path key — removes a record. not me deleting it, it's gone gone. 💀
• get [-onl|-otl|-onr] [-rm] [-sx] [-px] [-pz] path key — prints the value of a record. come get y'all's data. 🫶
• list [-onl|-otl|-onr] [-des] [-max num] [-rm] [-sx] [-pv] [-px] path [key] — prints keys of all records, separated by line feeds. the full roster, periodt. 👑
• clear [-onl|-otl|-onr] path — removes all records of a database. full reset, we don't talk about before. 🌈
• import [-onl|-otl|-onr] [-sx] path [file] — imports records from a TSV file. bring the whole squad in. 🎀
• copy [-onl|-otl|-onr] path file — copies the whole database. twin, but make it identical. 🦋
• dump [-onl|-otl|-onr] path [file] — dumps records into a snapshot file. a lil polaroid of your data. 📸
• load [-otr] [-onl|-otl|-onr] path [file] — loads records from a snapshot file. putting the polaroid back into reality. 🌟
• setbulk [-onl|-otl|-onr] path key value ... — store records at once. bulk era, we're efficient now. 🔥
• removebulk [-onl|-otl|-onr] [-sx] path key ... — remove records at once. goodbye in bulk, no cap. 😭
• getbulk [-onl|-otl|-onr] [-sx] [-px] path key ... — retrieve records at once. grab everything, hands full, thriving. 💜
• check [-onl|-otl|-onr] path — checks consistency. the vibe check, but for your database. ⭐

💅 OPTIONS 💅

options feature the following, bestie — read every single one, i'm not letting you skim. 🙈

• -otr — opens the database with the truncation option. (yes, it truncates. be so serious before you use this. 😭)
• -onl — opens the database with the no locking option.
• -otl — opens the database with the try locking option.
• -onr — opens the database with the no auto repair option.
• -tc — tunes the database with the compression option.
• -bnum num — specifies the number of buckets of the hash table.
• -psiz num — specifies the size of each page.
• -rcd — use the decimal comparator instead of the lexical one.
• -rcld — use the lexical descending comparator instead of the ascending one.
• -rcdd — use the decimal descending comparator instead of the lexical one.
• -st — prints miscellaneous information.
• -add — performs adding operation.
• -app — performs appending operation.
• -rep — performs replacing operation.
• -inci — performs integer increment operation.
• -incd — performs real number increment operation.
• -sx — the input data is evaluated as a hexadecimal data string.
• -rm — removes the record.
• -px — the output data is converted into a hexadecimal data string.
• -pz — does not append line feed at the end of the output.
• -des — visits records in descending order.
• -max num — specifies the maximum number of shown records.
• -pv — prints values of records also.

🌟 EXIT STATUS 🌟

this command returns 0 on success, another on failure. slay when it's 0, investigative journalism when it's not. 🔍

👀 SEE ALSO 👀

• kcforesttest(1)

that's the whole page, bestie — it's giving Man Page energy, dated 2012-05-24, and honestly? iconic. now go forth and manage that directory tree. 🫶✨🎀