1996-02-27 01:59:15 +00:00
|
|
|
# @(#)README 8.8 (Berkeley) 7/31/94
|
1994-05-27 05:00:24 +00:00
|
|
|
|
|
|
|
|
To build this portably, try something like:
|
|
|
|
|
|
1996-02-27 01:59:15 +00:00
|
|
|
make PORTDIR="../PORT/MACH"
|
1994-05-27 05:00:24 +00:00
|
|
|
|
|
|
|
|
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.
|
|
|
|
|
|
1996-02-27 01:59:15 +00:00
|
|
|
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.
|
|
|
|
|
|
1994-05-27 05:00:24 +00:00
|
|
|
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
|
1996-02-27 01:59:15 +00:00
|
|
|
The script file consists of lines with an initial character which is
|
|
|
|
|
the command for that line, or an initial character indicating a key
|
|
|
|
|
or data entry for a previous command.
|
|
|
|
|
|
|
|
|
|
Legal command characters are as follows:
|
1994-05-27 05:00:24 +00:00
|
|
|
|
|
|
|
|
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.
|
1996-02-27 01:59:15 +00:00
|
|
|
f: set the flags for the next command
|
|
|
|
|
+ no value zero's the flags
|
1994-05-27 05:00:24 +00:00
|
|
|
g: do a get command
|
|
|
|
|
+ must be followed by [kK]
|
|
|
|
|
+ writes out the retrieved data DBT.
|
1996-02-27 01:59:15 +00:00
|
|
|
o [r]: dump [reverse]
|
|
|
|
|
+ dump the database out, if 'r' is set, in reverse order.
|
1994-05-27 05:00:24 +00:00
|
|
|
p: do a put command
|
|
|
|
|
+ must be followed by [kK][dD]
|
|
|
|
|
r: do a del command
|
1996-02-27 01:59:15 +00:00
|
|
|
+ must be followed by [kK] unless R_CURSOR flag set.
|
|
|
|
|
S: sync the database
|
1994-05-27 05:00:24 +00:00
|
|
|
s: do a seq command
|
1996-02-27 01:59:15 +00:00
|
|
|
+ must be followed by [kK] if R_CURSOR flag set.
|
1994-05-27 05:00:24 +00:00
|
|
|
+ writes out the retrieved data DBT.
|
1996-02-27 01:59:15 +00:00
|
|
|
|
|
|
|
|
Legal key/data characters are as follows:
|
|
|
|
|
|
1994-05-27 05:00:24 +00:00
|
|
|
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.
|
1996-02-27 01:59:15 +00:00
|
|
|
|
|
|
|
|
Blank lines, lines with leading white space, and lines with leading
|
|
|
|
|
hash marks (#) are ignored.
|
1994-05-27 05:00:24 +00:00
|
|
|
|
|
|
|
|
Options to dbtest are as follows:
|
|
|
|
|
|
1996-02-27 01:59:15 +00:00
|
|
|
-d: Set the DB_LOCK flag.
|
1994-05-27 05:00:24 +00:00
|
|
|
-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.
|
1996-02-27 01:59:15 +00:00
|
|
|
-s: Don't delete the database file before opening it, i.e.
|
|
|
|
|
use the database file from a previous run.
|
1994-05-27 05:00:24 +00:00
|
|
|
|
1996-02-27 01:59:15 +00:00
|
|
|
Dbtest requires two arguments, the type of access "hash", "recno"
|
|
|
|
|
or "btree", and the script name or "-" to indicate stdin.
|
