1# $OpenBSD: README,v 1.3 2001/01/29 02:05:40 niklas Exp $ 2# $NetBSD: README,v 1.5 1996/05/03 21:54:19 cgd Exp $ 3# @(#)README 8.8 (Berkeley) 7/31/94 4 5To run the tests, enter "make regress". 6 7Fairly large files (the command files) are built in this directory during 8the test runs, and even larger files (the database files) are created in 9"/var/tmp". If the latter directory doesn't exist, set the environmental 10variable TMPDIR to a directory where the files can be built. 11 12=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= 13The script file consists of lines with an initial character which is 14the command for that line, or an initial character indicating a key 15or data entry for a previous command. 16 17Legal command characters are as follows: 18 19c: compare a record 20 + must be followed by [kK][dD]; the data value in the database 21 associated with the specified key is compared to the specified 22 data value. 23e: echo a string 24 + writes out the rest of the line into the output file; if the 25 last character is not a carriage-return, a newline is appended. 26f: set the flags for the next command 27 + no value zero's the flags 28g: do a get command 29 + must be followed by [kK] 30 + writes out the retrieved data DBT. 31o [r]: dump [reverse] 32 + dump the database out, if 'r' is set, in reverse order. 33p: do a put command 34 + must be followed by [kK][dD] 35r: do a del command 36 + must be followed by [kK] unless R_CURSOR flag set. 37S: sync the database 38s: do a seq command 39 + must be followed by [kK] if R_CURSOR flag set. 40 + writes out the retrieved data DBT. 41 42Legal key/data characters are as follows: 43 44D [file]: data file 45 + set the current data value to the contents of the file 46d [data]: 47 + set the current key value to the contents of the line. 48K [file]: key file 49 + set the current key value to the contents of the file 50k [data]: 51 + set the current key value to the contents of the line. 52 53Blank lines, lines with leading white space, and lines with leading 54hash marks (#) are ignored. 55 56Options to dbtest are as follows: 57 58 -d: Set the DB_LOCK flag. 59 -f: Use the file argument as the database file. 60 -i: Use the rest of the argument to set elements in the info 61 structure. If the type is btree, then "-i cachesize=10240" 62 will set BTREEINFO.cachesize to 10240. 63 -o: The rest of the argument is the output file instead of 64 using stdout. 65 -s: Don't delete the database file before opening it, i.e. 66 use the database file from a previous run. 67 68Dbtest requires two arguments, the type of access "hash", "recno" 69or "btree", and the script name or "-" to indicate stdin. 70