KCHASHMGR

NAME

kchashmgr - command line interface to manage the file hash database

DESCRIPTION

The command ‘kchashmgr’ is a utility for test and debugging of the file hash 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.

kchashmgr create [-otr] [-onl|-otl|-onr] [-apow num] [-fpow num] [-ts] [-tl] [-tc] [-bnum num] path

Creates a database file.

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

Prints status information.

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

Stores a record.

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

Removes a record.

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

Prints the value of a record.

kchashmgr list [-onl|-otl|-onr] [-max num] [-rm] [-sx] [-pv] [-px] path [key]

Prints keys of all records, separated by line feeds.

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

Removes all records of a database.

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

Imports records from a TSV file.

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

Copies the whole database.

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

Dumps records into a snapshot file.

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

Loads records from a snapshot file.

kchashmgr defrag [-onl|-otl|-onr] path

Performs defragmentation.

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

Store records at once.

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

Remove records at once.

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

Retrieve records at once.

kchashmgr 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.
-apow num : specifies the power of the alignment of record size.
-fpow num : specifies the power of the capacity of the free block pool.
-ts : tunes the database with the small option.
-tl : tunes the database with the linear option.
-tc : tunes the database with the compression option.
-bnum num : specifies the number of buckets of the hash table.
-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.
-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

kchashtest(1)