NetBSD/regress/lib/libc/db
cgd a441b518cd RCS Id conventions 1995-04-20 22:37:12 +00:00
..
Makefile RCS Id conventions 1995-04-20 22:37:12 +00:00
README RCS Id conventions 1995-04-20 22:37:12 +00:00
dbtest.c RCS Id conventions 1995-04-20 22:37:12 +00:00
run.test RCS Id conventions 1995-04-20 22:37:12 +00:00

README

#	$NetBSD: README,v 1.4 1995/04/20 22:39:18 cgd Exp $
#	@(#)README	8.4 (Berkeley) 6/20/94

To run the tests, enter "make regress".

Fairly large files (the command files) are built in this directory during
the test runs, and even larger files (the database files) are created in
"/var/tmp".  If the latter directory doesn't exist, set the environmental
variable TMPDIR to a directory where the files can be built.

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
The script file consists of lines with a initial character which is
the "command" for that line.  Legal characters are as follows:

c: compare a record
	+ must be followed by [kK][dD]; the data value in the database
	  associated with the specified key is compared to the specified
	  data value.
e: echo a string
	+ writes out the rest of the line into the output file; if the
	  last character is not a carriage-return, a newline is appended.
g: do a get command
	+ must be followed by [kK]
	+ writes out the retrieved data DBT.
p: do a put command
	+ must be followed by [kK][dD]
r: do a del command
	+ must be followed by [kK]
s: do a seq command
	+ writes out the retrieved data DBT.
f: set the flags for the next command
	+ no value zero's the flags
D [file]: data file
	+ set the current data value to the contents of the file
d [data]:
	+ set the current key value to the contents of the line.
K [file]: key file
	+ set the current key value to the contents of the file
k [data]:
	+ set the current key value to the contents of the line.
o [r]: dump [reverse]
	+ dump the database out, if 'r' is set, in reverse order.

Options to dbtest are as follows:

	-f: Use the file argument as the database file.
	-i: Use the rest of the argument to set elements in the info
	    structure.  If the type is btree, then "-i cachesize=10240"
	    will set BTREEINFO.cachesize to 10240.
	-o: The rest of the argument is the output file instead of
	    using stdout.

Dbtest requires two arguments, the type of access "hash", "recno" or
"btree", and the script name.