NAME

       tcttest - test cases of the table database API

DESCRIPTION

       The  command  `tcttest' is a utility for facility test and performance test.  This command
       is used in the following format.  `path' specifies the path of a  database  file.   `rnum'
       specifies  the  number  of  iterations.   `bnum'  specifies the number of buckets.  `apow'
       specifies the power of the alignment.  `fpow' specifies the power of the free block pool.

              tcttest write [-mt] [-tl] [-td|-tb|-tt|-tx] [-rc num] [-lc num] [-nc num] [-xm num]
              [-df  num]  [-ip]  [-is]  [-in]  [-it] [-if] [-ix] [-nl|-nb] [-rnd] path rnum [bnum
              [apow [fpow]]]
                     Store records with columns "str", "num", "type", and "flag".
              tcttest read [-mt] [-rc num] [-lc num] [-nc num]  [-xm  num]  [-df  num]  [-nl|-nb]
              [-rnd] path
                     Retrieve all records of the database above.
              tcttest  remove  [-mt]  [-rc num] [-lc num] [-nc num] [-xm num] [-df num] [-nl|-nb]
              [-rnd] path
                     Remove all records of the database above.
              tcttest rcat [-mt] [-tl] [-td|-tb|-tt|-tx] [-rc num] [-lc num] [-nc num] [-xm  num]
              [-df   num]   [-ip]   [-is]   [-in]   [-it]   [-if]   [-ix]   [-nl|-nb]  [-pn  num]
              [-dai|-dad|-rl|-ru] path rnum [bnum [apow [fpow]]]
                     Store records with partway duplicated keys using concatenate mode.
              tcttest misc [-mt] [-tl] [-td|-tb|-tt|-tx] [-nl|-nb] path rnum
                     Perform miscellaneous test of various operations.
              tcttest wicked [-mt] [-tl] [-td|-tb|-tt|-tx] [-nl|-nb] path rnum
                     Perform updating operations selected at random.

       Options feature the following.

              -mt : call the function `tctdbsetmutex'.
              -tl : enable the option `TDBTLARGE'.
              -td : enable the option `TDBTDEFLATE'.
              -tb : enable the option `TDBTBZIP'.
              -tt : enable the option `TDBTTCBS'.
              -tx : enable the option `TDBTEXCODEC'.
              -rc num : specify the number of cached records.
              -lc num : specify the number of cached leaf pages.
              -nc num : specify the number of cached non-leaf pages.
              -xm num : specify the size of the extra mapped memory.
              -df num : specify the unit step number of auto defragmentation.
              -ip : create the number index for the primary key.
              -is : create the string index for the column "str".
              -in : create the number index for the column "num".
              -it : create the string index for the column "type".
              -if : create the token inverted index for the column "flag".
              -ix : create the q-gram inverted index for the column "text".
              -nl : enable the option `TDBNOLCK'.
              -nb : enable the option `TDBLCKNB'.
              -rnd : select keys at random.
              -pn num : specify the number of patterns.
              -dai : use the function `tctdbaddint' instead of `tctdbputcat'.
              -dad : use the function `tctdbadddouble' instead of `tctdbputcat'.
              -rl : set the length of values at random.
              -ru : select update operations at random.

       This command returns 0 on success, another on failure.

SEE ALSO

       tctmttest(1), tctmgr(1), tctdb(3), tokyocabinet(3)