README

   1 libosl, the object storage layer, is a library for storing small to
   2 medium-sized data in relational tables. It is easy to use, lightweight,
   3 fast and portable. libosl is suitable for applications that need
   4 only a small fraction of the features a full database management
   5 system provides.
   6
   7 Libosl is simple:
   8
   9 - For libosl, all data stored in the osl tables are blobs,
  10 libosl will never try to interpret the table contents.
  11
  12 - There is no fancy query language but only a relatively
  13 simple C-API.
  14
  15 - There's no support for network-access and libosl only uses a very
  16 rudimentary table locking mechanism.
  17
  18 - There are no dependencies on external libraries. An augmented
  19 version of the red-black tree implementation of the linux
  20 kernel is included in the libosl package.
  21
  22 Libosl is fast:
  23
  24 - It uses sha1 hashes for content-based addressing.
  25
  26 - Red-black trees are used to make lookups fast.
  27
  28 Libosl is portable:
  29
  30 - It is known to compile and run on Linux, FreeBSD, NetBSD. It might
  31 work on other Unix systems as well.
  32
  33 - Content and metadata is stored in an endian-agnostic way.
  34
  35 Libosl is open source:
  36
  37 - Licensed under the [GNU General Public License, Version
  38 2](http://www.gnu.org/licenses/old-licenses/gpl-2.0.html)
  39
  40 Apart from the library itself, the package also contains simple
  41 examples and an fsck program, oslfsck, which can be used to recover
  42 from corrupted tables due to system crashes or bugs in the application
  43 or the library.
  44
  45 Resources:
  46
  47 - Git clone URL: git://git.tuebingen.mpg.de/osl.git
  48 - [Gitweb](http://git.tuebingen.mpg.de/osl.git)
  49 - [Author Home Page](http://people.tuebingen.mpg.de/maan)
  50 - [Project Page](http://people.tuebingen.mpg.de/maan/osl)
  51 - Email: [Andre Noll](mailto:maan@tuebingen.mpg.de)
  52
  53 Comments and bug reports are welcome. Please provide enough info
  54 such as the version of osl you are using and relevant parts of
  55 the logs.