Category : C Source Code
Archive   : CBASE102.ZIP
Filename : CBASE.RME

----------------------------------------------------------------------
| Citadel |
| 241 East Eleventh Street * Brookville, IN 47012 * 317-647-4720 |
| BBS 317-647-2403 |
----------------------------------------------------------------------

cbase is distributed in a single compressed file cbaseRL.zip; R and L
would be the release and level numbers, respectively. The ZIP data
compression utilities are needed to extract the individual files.

The following files are obtained by decompressing cbaseRL.zip:

cbase.rme preliminary information
rlsnotes.txt release notes
order.txt order form
distrib.txt application to distribute cbase for profit
guide.txt cbase Programmer's Guide
manxRL.zip manual entry extraction utility
blkioRL.zip blkio library source code
lseqRL.zip doubly linked sequential file mngmnt library source code
btreeRL.zip B+-tree file management library source code
cbase.zip cbase library source code
cbddlRL.zip cbddlp source code
cbddlp.exe cbddlp executable for DOS
rolodeck.zip rolodeck example program
bcbats.zip installation batch files for Borland C++
mscbats.zip installation batch files for Microsoft C

cbase is not public domain. It may be evaluated free for a period of
30 days. See the file order.txt for registration and ordering
information.

cbase includes four individual libraries, each of which has been
separated into its own compressed file. The first step in the
installation is to create a directory for each compressed file, then
extract the individual files from that compressed file. For example,
the following sequence of DOS commands would extract the files from
the main archive, create a directory for the blkio library, and
extract the blkio files into that directory.

> pkunzip cbaseRL.zip
> mkdir blkio
> chdir blkio
> pkunzip ..\blkioRL.zip

The remaining installation instructions may be found in Appendix A of
the "cbase Programmer's Guide" (guide.txt). Also examine any readme
files (files with the extension .rme) for additional installation
notes. After installing each library, the reference manual for that
library will be in the file libname.man, where libname would be the
name of the library.
Citadel 91/09/23
The original file cbaseRL.zip should be saved if you wish to pass on
copies of cbase to others. cbase may not be distributed as individual
files, or in an incomplete or altered form. The individual files may
not be distributed separately, except for ansi.h, blkioRL.zip, and
manxRL.zip; see their respective readme files for details. An
application must be filed and approved in order to distribute copies
of cbase for profit. See the file distrib.txt for an application
form.











































Citadel 91/09/23
----------------------------------------------------------------------
| cbase - The C Database Library |
| Version 1.0.2 |
----------------------------------------------------------------------

cbase is a complete multiuser C database file management library,
providing indexed and sequential access on multiple keys. It features
a layered architecture and comprises four individual libraries.

-----------------------------------
| ISAM* |
-----------------------------------
| File Structure |
-----------------------------------
| Buffered I/O |
-----------------------------------
| file system |
-----------------------------------
cbase Architecture

-----------------------------------
| cbase |
-----------------------------------
| lseq | btree |
-----------------------------------
| blkio |
-----------------------------------
| operating system |
-----------------------------------
cbase Libraries

The four libraries are:

cbase - C database library for indexed and sequential access
lseq - doubly linked sequential file management library
btree - B+-tree file management library
blkio - block buffered input/output library

cbase internally uses lseq for record storage and btree for inverted
file index storage, which in turn use blkio for file access and
buffering. blkio is analagous to stdio but based on a file model more
appropriate for structured files such as used in database software.

The lower level libraries can also be accessed directly for use
independent of cbase. For example, the btree library can be used to
manipulate B+-trees for purposes other than inverted files, and the
blkio library to develop new structured file management libraries.


* ISAM stands for Indexed Sequential Access Method.

Citadel 91/09/23
cbase Features
--------------
Portable:
- Written in strict adherence to ANSI C standard.
- K&R C compatibility maintained.
- All operating system dependent code is isolated to a small portion
of the blkio library to make porting to new systems easy.
- UNIX and DOS currently supported.
Buffered:
- Both records and indexes are buffered using LRU (least recently
used) buffering.
Fast and efficient random access:
- B+-trees are used for inverted file key storage.
- Multiple keys are supported.
- Both unique and duplicate keys are supported.
Fast and efficient sequential access:
- B+-trees also allow keyed sequential access.
- Records are stored in doubly linked lists for non-keyed sequential
access.
- Both types of sequential access are bidirectional.
Multiuser:
- Read-only locking.
Other Features:
- Text file data import and export.
- Custom data types can be defined.
- Marker used to detect corrupt files.
- Reference documentation is in standard UNIX manual entry format,
including errno values.
Utilities:
- cbddlp, a data definition language processor, is provided to
automatically generate the C code defining a database.


$77 plus shipping VISA/MasterCard

All source code included.
No run-time fees or royalties.

Citadel Software, Inc.
241 East Eleventh Street
Brookville, IN 47012
317-647-4720
BBS 317-647-2403

An evaluation copy of cbase can be obtained at no charge on the
Citadel BBS, or send $5 for diskette.





Citadel 91/09/23