Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
TCHTEST(1)			  Tokyo Cabinet 		      TCHTEST(1)

NAME
     tchtest - test cases of the hash database API

DESCRIPTION
     To  use  the hash database API easily, the commands `tchtest', `tchmttest',
     and `tchmgr' are provided.

     The command `tchtest' 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' speci-
     fies  the	number of buckets.  `apow' specifies the power of the alignment.
     `fpow' specifies the power of the free block pool.

	    tchtest write [-mt] [-tl] [-td|-tb|-tt|-tx] [-rc num] [-xm num] [-df
	    num] [-nl|-nb] [-as] [-rnd] path rnum [bnum [apow [fpow]]]
		   Store  records  with  keys  of  8  bytes.   They  change   as
		   `00000001', `00000002'...
	    tchtest  read  [-mt]  [-rc	num] [-xm num] [-df num] [-nl|-nb] [-wb]
	    [-rnd] path
		   Retrieve all records of the database above.
	    tchtest remove [-mt] [-rc num] [-xm num] [-df num] [-nl|-nb]  [-rnd]
	    path
		   Remove all records of the database above.
	    tchtest  rcat [-mt] [-tl] [-td|-tb|-tt|-tx] [-rc num] [-xm num] [-df
	    num] [-nl|-nb] [-pn num] [-dai|-dad|-rl|-ru] path rnum  [bnum  [apow
	    [fpow]]]
		   Store  records with partway duplicated keys using concatenate
		   mode.
	    tchtest misc [-mt] [-tl] [-td|-tb|-tt|-tx] [-nl|-nb] path rnum
		   Perform miscellaneous test of various operations.
	    tchtest 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 `tchdbsetmutex'.
	    -tl : enable the option `HDBTLARGE'.
	    -td : enable the option `HDBTDEFLATE'.
	    -tb : enable the option `HDBTBZIP'.
	    -tt : enable the option `HDBTTCBS'.
	    -tx : enable the option `HDBTEXCODEC'.
	    -rc num : specify the number of cached records.
	    -xm num : specify the size of the extra mapped memory.
	    -df num : specify the unit step number of auto defragmentation.
	    -nl : enable the option `HDBNOLCK'.
	    -nb : enable the option `HDBLCKNB'.
	    -as : use the function `tchdbputasync' instead of `tchdbput'.
	    -rnd : select keys at random.
	    -wb : use the function `tchdbget3' instead of `tchdbget'.
	    -pn num : specify the number of patterns.
	    -dai : use the function `tchdbaddint' instead of `tchdbputcat'.
	    -dad : use the function `tchdbadddouble' instead of `tchdbputcat'.
	    -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
     tchmttest(1), tchmgr(1), tchdb(3), tokyocabinet(3)

Man Page			   2012-08-18			      TCHTEST(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=tchtest&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help