KCFORESTMGR

NAME

kcforestmgr - command line interface to manage the directory tree database

DESCRIPTION

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.

SEE ALSO

kcforesttest(1)