home *** CD-ROM | disk | FTP | other *** search
/ Garbo / Garbo.cdr / pc / c / cbase.zoo / cbase.rme < prev    next >
Encoding:
Text File  |  1990-06-21  |  6.5 KB  |  209 lines
  1. ----------------------------------------------------------------------
  2. | Citadel                                                            |
  3. | 241 East Eleventh Street * Brookville, IN 47012 * 317-647-4720     |
  4. |                                               BBS 317-647-2403     |
  5. ----------------------------------------------------------------------
  6.  
  7. cbase is distributed in a single compressed file cbaseRL.zip; R and L
  8. would be the release and level numbers, respectively.  The ZIP data
  9. compression utilities are needed to extract the individual files.
  10.  
  11. The following files are obtained by decompressing cbaseRL.zip:
  12.  
  13.    cbase.rme  preliminary information
  14. rlsnotes.txt  release notes
  15.    order.txt  order form
  16.  distrib.txt  application to distribute cbase for profit
  17.    guide.txt  cbase Programmer's Guide
  18.  blkioRL.zip  blkio library source code
  19.   lseqRL.zip  doubly linked sequential file mngmnt library source code
  20.  btreeRL.zip  B+-tree file management library source code
  21.    cbase.zip  cbase library source code
  22. rolodeck.zip  rolodeck example program
  23.  
  24. cbase is not public domain.  It may be evaluated free for a period of
  25. 30 days.  See the file order.txt for registration and ordering
  26. information.
  27.  
  28. cbase includes four individual libraries, each of which has been
  29. separated into its own compressed file.  The first step in the
  30. installation is to place each compressed file in its own directory,
  31. then perform the extraction to obtain the individual files.  For
  32. example, the following sequence of MS-DOS commands would create
  33. a directory for the blkio library and extract the blkio files into
  34. that directory.
  35.  
  36.      > mkdir blkio
  37.      > copy blkioRL.zip blkio
  38.      > chdir blkio
  39.      > pkunzip blkioRL.zip
  40.  
  41. The same must be done for manxRL.zip, which is one of the files
  42. extracted from blkioRL.zip; manx is a utility used to generate
  43. the reference manual for each library.  The remaining installation
  44. instructions may be found in Appendix A of the "cbase Programmer's
  45. Guide" (guide.txt).  After installing each library, the reference
  46. manual for that library will be in the file libname.man, where libname
  47. would be the name of the library.
  48.  
  49. The original file cbaseRL.zip should be saved if you wish to pass on
  50. copies of cbase to others.  cbase may not be distributed as individual
  51.  
  52.                                                      Citadel  90/06/21
  53. files, or in an incomplete or altered form.  The individual libraries
  54. may not be distributed separately.  The exceptions are blkioRL.zip and
  55. manxRL.zip; see their respective readme files for details.  An
  56. application must be filed and approved in order to distribute copies
  57. of cbase for profit.  See the file distrib.txt for an application
  58. form.
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.                                                      Citadel  90/06/21
  105. ----------------------------------------------------------------------
  106. | cbase - The C Database Library                                     |
  107. | Version 1.0                                                        |
  108. ----------------------------------------------------------------------
  109.  
  110. cbase is a complete multiuser C database file management library,
  111. providing indexed and sequential access on multiple keys.  It features
  112. a modular design, comprising four individual libraries:
  113.  
  114.      cbase - C database library
  115.      lseq  - doubly linked sequential file management library
  116.      btree - B+-tree file management library
  117.      blkio - block buffered input/output library
  118.  
  119. cbase internally uses lseq for record storage and btree for inverted
  120. file index storage, which in turn use blkio for file access and
  121. buffering; blkio is analagous to stdio but based on a file model more
  122. appropriate for structured files such as used in database software.
  123. The figure below diagrams the hierarchical relationship of the cbase
  124. libraries.
  125.  
  126.                  -----------------------------------
  127.                  |              cbase              |
  128.                  -----------------------------------
  129.                          |                 |
  130.                  ----------------- -----------------
  131.                  |     lseq      | |     btree     |
  132.                  ----------------- -----------------
  133.                          |                 |
  134.                  -----------------------------------
  135.                  |              blkio              |
  136.                  -----------------------------------
  137.  
  138.                            cbase Libraries
  139.  
  140.  
  141. The lower level libraries can also be accessed directly for
  142. independent use.  For example, the btree library can be used to
  143. manipulate B+-trees for purposes other than inverted files, and the
  144. blkio library to develop new structured file management libraries.
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.                                                      Citadel  90/06/21
  157.  
  158.                             cbase Features
  159.                             --------------
  160. Portable:
  161.   - Written in strict adherence to ANSI C standard.
  162.   - K&R C compatibility maintained.
  163.   - All operating system dependent code is isolated to a small portion
  164.     of the blkio library to make porting to new systems easy.
  165.   - UNIX and MS-DOS currently supported.*
  166. Buffered:
  167.   - Both records and indexes are buffered using LRU (least recently
  168.     used) buffering.
  169. Fast and efficient random access:
  170.   - B+-trees are used for inverted file key storage.
  171.   - Multiple keys are supported.
  172.   - Both unique and duplicate keys are supported.
  173. Fast and efficient sequential access:
  174.   - B+-trees also allow keyed sequential access.
  175.   - Records are stored in doubly linked lists for non-keyed sequential
  176.     access.
  177.   - Both types of sequential access are bidirectional.
  178. Multiuser:
  179.   - Read-only locking.
  180. Other:
  181.   - Text file data import and export.
  182.   - Custom data types can be defined.
  183.   - Marker used to detect corrupt files when opened.
  184.   - Reference documentation is in standard UNIX manual entry format,
  185.     including errno values.
  186.  
  187.  
  188. $77 plus shipping                                      VISA/MasterCard
  189.  
  190. All source code included.
  191. Technical support included.
  192. No run-time fees or royalties.
  193.  
  194. Citadel
  195. 241 East Eleventh Street
  196. Brookville, IN 47012
  197. 317-647-4720
  198. BBS 317-647-2403
  199.  
  200. An evaluation copy of cbase can be obtained at no charge on the
  201. Citadel BBS 317-647-2403, or send $5 for diskette.
  202.  
  203.  
  204.  
  205. * UNIX is a trademark of AT&T.  Turbo C is a trademark of Borland
  206.   International, Inc.  MS-DOS is a trademark of Microsoft.
  207.  
  208.                                                      Citadel  90/06/21
  209.