DYSTMGR(1)

NAME
dystmgr - the command line utility of the core API

DESCRIPTION

The command `dystmgr' is a utility for test and debugging of the core API and its applications. `path' specifies the path of a database directory. `ernum' specifies the expected number of records. `etnum' specifies the expected number of tokens. `id' specifies the ID number of a record. `text' specifies the text of a record. `word' specifies a search word. `file' specifies the input file.

    dystmgr create [-tl] [-td|-tb|-tt] path [ernum [etnum]]
        Create a database directory.
    dystmgr inform [-nl|-nb] path
        Print miscellaneous information to the standard output.
    dystmgr put [-nl|-nb] path id text
        Store a record.
    dystmgr out [-nl|-nb] path id
        Remove a record.
    dystmgr get [-nl|-nb] path id
        Print the text of a record.
    dystmgr search [-nl|-nb] [-eu|-ei|-ed] [-sp|-ss|-sf|-st|-stp|-sts] [-max num] [-ph] [-pv] path [word...]
        Search for records.
    dystmgr list [-nl|-nb] [-max num] [-pv] path
        Print ID numbers of all records.
    dystmgr optimize [-nl|-nb] path
        Optimize a database directory.
    dystmgr importtsv [-ic num] [-nl|-nb] path [file]
        Store records of TSV in each line of a file.
    dystmgr version
        Print the version information of Tokyo Dystopia.

Options feature the following.

    -tl : enable the option `IDBTLARGE'.
    -td : enable the option `IDBTDEFLATE'.
    -tb : enable the option `IDBTBZIP'.
    -tt : enable the option `IDBTTCBS'.
    -nl : enable the option `IDBNOLCK'.
    -nb : enable the option `IDBLCKNB'.
    -eu : use the union expression.
    -ei : use the intersection expression.
    -ed : use the difference expression.
    -sp : use the prefix matching mode.
    -ss : use the suffix matching mode.
    -sf : use the full matching mode.
    -st : use the token matching mode.
    -stp : use the token prefix matching mode.
    -sts : use the token suffix matching mode.
    -max num : specify the maximum number of the output.
    -ph : print hints also.
    -pv : print texts of records also.
    -ic num : specify the capacity size of the token cache.

This command returns 0 on success, another on failure.

TCQTEST

The command `tcqtest' is a utility for facility test and performance test of the q-gram database API. This command is used in the following format. `path' specifies the path of a database directory. `rnum' specifies the number of iterations.

    tcqtest write [-tl] [-td|-tb|-tt] [-et num] [-ic num] [-nl|-nb] [-la num] [-en] [-rc] [-ra] [-rs] path rnum
        Store records with random texts.
    tcqtest read [-nl|-nb] [-la num] [-lm num] [-en] [-rc] [-ra] [-rs] [-sp|-ss|-sf] path rnum
        Search for records with random texts.
    tcqtest wicked [-tl] [-td|-tb|-tt] [-et num] [-ic num] [-nl|-nb] [-la num] [-en] [-rc] [-ra] [-rs] path rnum
        Perform updating operations selected at random.

Options feature the following.

    -tl : enable the option `QDBTLARGE'.
    -td : enable the option `QDBTDEFLATE'.
    -tb : enable the option `QDBTBZIP'.
    -tt : enable the option `QDBTTCBS'.
    -et num : specify the expected number of tokens.
    -ic num : specify the capacity size of the token cache.
    -nl : enable the option `QDBNOLCK'.
    -nb : enable the option `QDBLCKNB'.
    -la num : specify the average length of each records.
    -lm num : specify the minimum length of each records.
    -en : use English-like text.
    -rc : do not normalize character cases.
    -ra : do not normalize characters with accent marks.
    -rs : do not normalize white-space characters.
    -sp : use the prefix matching mode.
    -ss : use the suffix matching mode.
    -sf : use the full matching mode.

This command returns 0 on success, another on failure.

SEE ALSO

dysttest(1), dystopia(3)