KCPOLYMGR(1)

πŸ’– kcpolymgr β€” the manual page, but make it make sense πŸ’–

ok so bestie, welcome to kcpolymgr, aka the kcpolymgr(1) situation. it's the manual page for the command line interface to manage the polymorphic database. sit down, grab a strawberry drink πŸ“, and let's get into it.


πŸŽ€ NAME πŸŽ€

kcpolymgr β€” command line interface to manage the polymorphic database


✨ DESCRIPTION ✨

so kcpolymgr is a utility for test and debugging of the polymorphic database and its applications. it's giving dev-tools energy, it's giving "i live in the terminal and i'm thriving" πŸ’…

before we go anywhere, here's the vocab check, because these little placeholders show up everywhere:

  • path β€” specifies the path of a database file. πŸ—‚οΈ
  • key β€” specifies the key of a record. πŸ”‘
  • value β€” specifies the value of a record. πŸ“
  • file β€” specifies the input/output file. πŸ“„
  • src β€” specifies other database files. πŸ“š

no cap, that's the whole glossary. now the fun part.

🌈 the commands (aka the whole menu, no skips)

create β€” makes a database file, fresh out of the box ✨

kcpolymgr create [-otr] [-onl|-otl|-onr] path

inform β€” prints status information, like a vibe check but for your db 🩺

kcpolymgr inform [-onl|-otl|-onr] [-st] path

set β€” stores a record. putting something in its place, periodt πŸ’Ύ

kcpolymgr set [-onl|-otl|-onr] [-add|-app|-rep|-inci|-incd] [-sx] path key value

remove β€” removes a record. bye bestie, it's not personal 🫢

kcpolymgr remove [-onl|-otl|-onr] [-sx] path key

get β€” prints the value of a record. the reveal moment πŸ‘‘

kcpolymgr get [-onl|-otl|-onr] [-rm] [-sx] [-px] [-pz] path key

list β€” prints keys of all records, separated by line feeds. the whole roster, one per line πŸ“‹

kcpolymgr list [-onl|-otl|-onr] [-mp|-mr|-ms] [-des] [-max num] [-rm] [-sx] [-pv] [-px] path [key]

clear β€” removes all records of a database. nuclear option, lowkey 😭

kcpolymgr clear [-onl|-otl|-onr] path

import β€” imports records from a TSV file. bring your data over, we have room 🌸

kcpolymgr import [-onl|-otl|-onr] [-sx] path [file]

copy β€” copies the whole database. everything, in one go, iconic πŸ¦‹

kcpolymgr copy [-onl|-otl|-onr] path file

dump β€” dumps records into a snapshot file. saving the moment for later πŸ“Έ

kcpolymgr dump [-onl|-otl|-onr] path [file]

load β€” loads records from a snapshot file. bringing the moment back ✨

kcpolymgr load [-otr] [-onl|-otl|-onr] path [file]

merge β€” merge records from other databases. the friend group reunion 🀝

kcpolymgr merge [-onl|-otl|-onr] [-add|-app|-rep] path src...

setbulk β€” store records at once. efficiency is the aesthetic πŸ”₯

kcpolymgr setbulk [-onl|-otl|-onr] path key value ...

removebulk β€” remove records at once. mass exit, but make it organized πŸ’€

kcpolymgr removebulk [-onl|-otl|-onr] [-sx] path key ...

getbulk β€” retrieve records at once. haul, but for data πŸŽ€

kcpolymgr getbulk [-onl|-otl|-onr] [-sx] [-px] path key ...

check β€” checks consistency. bestie, are you okay? are you okay, bestie? 🧚

kcpolymgr check [-onl|-otl|-onr] path

πŸ’« the options (all of them, obviously)

options feature the following:

  • -otr β€” opens the database with the truncation option. πŸͺ„
  • -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. πŸš«πŸ› οΈ
  • -st β€” prints miscellaneous information. the extra little details πŸ’…
  • -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 β€” performs not append line feed at the end of the output. βœ‚οΈ
  • -mp β€” performs prefix matching instead of usual scan. πŸ”Ž
  • -mr β€” performs regular expression matching instead of usual scan. 🧠
  • -ms β€” performs similar matching instead of usual scan. πŸͺž
  • -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. so 0 = slay, anything else = go read the output bestie.


🌟 SEE ALSO 🌟

kcpolytest(1), kclangctest(1)

no really, go read those too, they're part of the lore πŸ“

and that's the whole page, bestie πŸ’œ this one came out of Kyoto Cabinet, dated 2012-05-24, and it lives in the Man Page section of your manual. mwah, go forth and manage that polymorphic database πŸ‘‘βœ¨