]> pd.if.org Git - btree/blobdiff - README.md
Introduce btree2t
[btree] / README.md
index 7b2ba8494ba565b07a52c87c3cbc0ef2c3b398e6..856ec018df7075e2adc903e2b09a164572910580 100644 (file)
--- a/README.md
+++ b/README.md
@@ -3,17 +3,17 @@ Btree-source-code
 
 A working project for High-concurrency B-tree source code in C
 
-There are three major code sets in the btree source code:
+There are five major code sets in the standard btree source code:
 
-btree2q.c       Single Threaded/MultiProcess with latching supplied by advisory file locking.  Works with network file systems.
-threads2h.c     Multi-Threaded/Multi-Process with latching implemented with test & set locks in the btree pages.
-threads2i.c     Multi-Threaded/Multi-Process with latching implemented with test & set locks in the btree pages with Linux futex system calls for contention.
+btree2s.c       Single Threaded/MultiProcess version that removes keys all the way back to an original empty btree, placing removed nodes on a free list.  Operates under either memory mapping or file I/O.  Recommended btrees hosted on network file systems.
 
-The Foster set includes three types of latching:
+btree2t.c       Single Threaded/MultiProcess version similar to btree2s except that fcntl locking has been replaced by test & set latches in the first few btree pages.  Uses either memory mapping or file I/O.
 
-Fosterbtreee.c  Multi-Threaded/Single Process with latches hosted by the buffer pool manager
-Fosterbtreef.c  Multi-Threaded/Multi-Process with latches hosted by a latch manager using the first few pages of the btree.
-Fosterbtreeg.c  Multi-Threaded/Multi-Process with latches implemented with test & set locks in the btree pages.
+threads2h.c     Multi-Threaded/Multi-Process with latching implemented by a latch manager with pthreads/SRW latches in the first few btree pages. Recommended for Windows.
+
+threads2i.c     Multi-Threaded/Multi-Process with latching implemented by a latch manager with test & set latches in the first few btree pages with thread yield system calls during contention.
+
+threads2j.c     Multi-Threaded/Multi-Process with latching implemented by a latch manager with test & set locks in the first few btree pages with Linux futex system calls during contention. Recommended for linux.
 
 Compilation is achieved on linux or Windows by:
 
@@ -21,6 +21,6 @@ gcc -D STANDALONE threads2h.c -lpthread
 
 or
 
-cl /D STANDALONE threads2h.c
+cl /Ox /D STANDALONE threads2h.c
 
-Please see the project wiki page for documentation
+Please see the project wiki page for additional documentation