readme.uclinux

db.* (pronounced dee-be star) is an advanced, high performance, small footprint embedded database fo

Installing and building db.* for uCLinux
========================================

db.* requires that libc provide wide char support. Hereafter, <uclinux> refers
to root directory where you have uclinux installed.

1) cd to your uCLinux directory and create dbstar directory

    # cd <uclinux>
    # mkdir lib/dbstar

2) unpack db.* distribution into <uclinux>/lib/dbstar

    # (cd lib/dbstar && tar zxf <path/to/dbstar.tar.gz>)

2) apply a patch to intergrate db.* into the uCLinux build procedure

    # patch -p1 lib/dbstar/db.uclinux/uclinux.patch

3) configure uCLinux as usual, and put the necessary marks into db.*
configuration options.

    # make menuconfig

4) build uCLinux, db.* will be build as part of it.

    # make

What does uclinux.patch do
==========================

To intergrate db.* support into uCLinux, the following files are changed:

<uclinux>/config/config.in:
    create db.* specific section with compilation options

<uclinux>/lib/Makefile:
    include db.* directory to be built and resulting libraries to be
    linked into <uclinux>/lib
    
<uclinux>/user/Makefile:
    include db.* directory to allow db.* tools to be built

<uclinux>/vendors/config/common/config.arch
    define make variable $(LIBDBSTAR) to use in your applications