kcforestmgr − command line interface to manage the directory tree database
The command ‘kcforestmgr’ is a utility for test and debugging of the file tree database and its applications. ‘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.
kcforestmgr create [−otr] [−onl|−otl|−onr] [−tc] [−bnum num] [−psiz num] [−rcd|−rcld|−rcdd] path
Creates a database file.
kcforestmgr inform [−onl|−otl|−onr] [−st] path
Prints status information.
kcforestmgr set [−onl|−otl|−onr] [−add|−app|−rep|−inci|−incd] [−sx] path key value
Stores a record.
kcforestmgr remove [−onl|−otl|−onr] [−sx] path key
Removes a record.
kcforestmgr get [−onl|−otl|−onr] [−rm] [−sx] [−px] [−pz] path key
Prints the value of a record.
kcforestmgr list [−onl|−otl|−onr] [−des] [−max num] [−rm] [−sx] [−pv] [−px] path [key]
Prints keys of all records, separated by line feeds.
kcforestmgr clear [−onl|−otl|−onr] path
Removes all records of a database.
kcforestmgr import [−onl|−otl|−onr] [−sx] path [file]
Imports records from a TSV file.
kcforestmgr copy [−onl|−otl|−onr] path file
Copies the whole database.
kcforestmgr dump [−onl|−otl|−onr] path [file]
Dumps records into a snapshot file.
kcforestmgr load [−otr] [−onl|−otl|−onr] path [file]
Loads records from a snapshot file.
kcforestmgr setbulk [−onl|−otl|−onr] path key value ...
Store records at once.
kcforestmgr removebulk [−onl|−otl|−onr] [−sx] path key ...
Remove records at once.
kcforestmgr getbulk [−onl|−otl|−onr] [−sx] [−px] path key ...
Retrieve records at once.
kcforestmgr check [−onl|−otl|−onr] path
Checks consistency.
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.
−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.
This command returns 0 on success, another on failure.
kcforesttest(1)