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