X-Git-Url: https://pd.if.org/git/?p=btree;a=blobdiff_plain;f=README.md;h=d24a063ed99e0431073545feb012d99df9893434;hp=691c7b7710e00b0c72fd5712c4046f6330e1a46b;hb=4ae5ba77c29ec5870baa6256f9be8cf4a0fff3bc;hpb=48501624b8372fa9c781c6f89f41b58d91338bb8 diff --git a/README.md b/README.md index 691c7b7..d24a063 100644 --- a/README.md +++ b/README.md @@ -3,22 +3,19 @@ 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 six files in the btree source code: -btree2q.c Single Threaded/MultiProcess with latching supplied by advisory file locking. Works with network file systems. +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. -threads2h.c Multi-Threaded/Multi-Process with latching implemented with test & set locks in the btree pages. +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. -threads2i.c Multi-Threaded/Multi-Process with latching implemented with test & set locks in the btree pages with Linux futex system calls for contention. +btree2u.c Single Threaded/MultiProcess version that implements a traditional buffer pool manager in the first n pages of the btree file. The buffer pool accesses its pages with mmap. Evicted pages are written back to the btree file from the buffer pool pages with pwrite. -The Foster set includes three types of latching: +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. -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. +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: @@ -26,6 +23,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