home *** CD-ROM | disk | FTP | other *** search
/ Frostbyte's 1980s DOS Shareware Collection / floppyshareware.zip / floppyshareware / DOOG / CBASE09.ZIP / README.TXT < prev   
Text File  |  1989-09-01  |  6KB  |  157 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 from PKware, Inc. are needed to extract the
  10. individual files.  These utilities are available on most BBSs.
  11.  
  12. The following files are obtained by decompressing cbaseRL.zip:
  13.  
  14.   readme.txt  preliminary information
  15.  distrib.txt  application to distribute cbase for profit
  16.    order.txt  registration information and order form
  17.    guide.txt  cbase programmer's guide
  18.  blkioRL.zip  blkio library source code
  19.     lseq.zip  doubly linked sequential file mngmnt library source code
  20.    btree.zip  B+-tree file management library source code
  21.    cbase.zip  cbase library source code
  22.  
  23. cbase is not in the public domain.  See the file order.txt for
  24. registration and ordering information.
  25.  
  26. cbase includes four individual libraries, each of which has been
  27. separated into its own compressed file.  The first step in the
  28. installation is to place each compressed file in its own directory,
  29. then perform the extraction to obtain the individual files.  For
  30. example, the following sequence of MS-DOS commands would create
  31. a directory for the blkio library and extract the blkio files into
  32. that directory.
  33.  
  34.      mkdir blkio
  35.      copy blkioRL.zip blkio
  36.      chdir blkio
  37.      pkunzip blkioRL.zip
  38.  
  39. The same must be done for manxRL.zip which is one of the files
  40. extracted from blkioRL.zip; manx is a utility used to generate
  41. the reference manual for each of the individual libraries.  The
  42. remaining installation instructions may be found in the programmer's
  43. guide (guide.txt).
  44.  
  45. The original file cbaseRL.zip should be saved if you wish to pass on
  46. copies of cbase.  cbase may not be distributed as individual files,
  47. or in an incomplete or altered form.  The individual files or
  48. libraries of cbase may not be distributed separately.  The exceptions
  49. are blkioRL.zip and manxRL.zip; see their respective readme files for
  50. details.  An application must be filed in order to distribute copies
  51. of cbase for profit.  See the file distrib.txt.
  52.                                                         Citadel  08-89
  53. ----------------------------------------------------------------------
  54. | cbase - C database library                                         |
  55. | Version 1.0                                                        |
  56. ----------------------------------------------------------------------
  57.  
  58. cbase is a C database file management library.  B+-trees are used for
  59. indexed and sequential record access.  cbase features a truly modular
  60. design and provides a logical and consistent interface.  The figure
  61. below shows the individual libraries included with cbase and their
  62. relationships.  Each of these is complete and may be used
  63. independently.
  64.  
  65.                  -----------------------------------
  66.                  |              cbase              |
  67.                  -----------------------------------
  68.                          |                 |
  69.                  ----------------- -----------------
  70.                  |     lseq      | |     btree     |
  71.                  ----------------- -----------------
  72.                          |                 |
  73.                  -----------------------------------
  74.                  |              blkio              |
  75.                  -----------------------------------
  76.  
  77.                     cbase and Underlying Libraries
  78.  
  79.      cbase - C database file management library
  80.      btree - B+-tree file management library
  81.      lseq  - doubly linked sequential file management library
  82.      blkio - block buffered input/output library
  83.  
  84. Extremely portable:
  85.   - Written in strict adherence to ANSI C standard.
  86.   - Will also work with K&R C compilers.
  87.   - All operating system dependent code is isolated to a small portion
  88.     of the blkio library to make porting to new systems easy.
  89.   - All source code is included.
  90.   - UNIX and MS-DOS currently supported.*
  91. Completely buffered:
  92.   - Both records and indexes are buffered using LRU (least recently
  93.     used) buffering.
  94. Fast and efficient sequential access:
  95.   - Records are stored in doubly linked lists for non-keyed sequential
  96.     access.
  97.   - Indexes are stored in B+-trees to allow keyed sequential access.
  98.   - Both types of sequential access are bidirectional.
  99. Fast and efficient random access:
  100.   - B+-trees are used for inverted file key storage.
  101.   - Multiple keys are supported.
  102.   - Both unique and duplicate keys are supported.
  103.  
  104.                                                         Citadel  08-89
  105. Multiuser:
  106.   - Read-only locking used.
  107.   - Multiuser support can be ported to any system with file locking
  108.     capabilities.
  109. Corrupt file marker:
  110.   - A marker is used to detect corrupt files when opened.
  111. Documentation:
  112.   - Example program explained in detail.
  113.   - Reference documentation is in standard UNIX manual entry format,
  114.     including errno values.
  115.   - Procedure to add new data types documented.
  116.  
  117. All source code included.
  118. No run-time fees or royalties.
  119. Free technical support.
  120.  
  121. Price:  $77.00
  122.  
  123. cbase may be downloaded from the Citadel BBS 317-647-2403.
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154. * UNIX is a trademark of AT&T.  MS-DOS is a trademark of Microsoft.
  155.  
  156.                                                         Citadel  08-89
  157.