xref: /freebsd-11.0-release/lib/libc/db/test/README

#	@(#)README	8.2 (Berkeley) 2/21/94

To build this portably, try something like:

    make INC="-I../PORT/MACH/ -I../PORT/MACH/include" LIB=../PORT/MACH/libdb.a

where MACH is the machine, i.e. "sunos.4.1.1".

To run the tests, enter "sh run.test".  If your system dictionary isn't
in /usr/share/dict/words, edit run.test to reflect the correct place.

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
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.