Here some remarks about LDBF version 1.0 beta1.

FILES:
    bin/
      ldbfd              - server engine
      ldbfsetup	         - setup utility
      ldbf-admin         - LDBF admin manager
      ldbfmonitor        - monitor of server activity
      ldbfcgi            - CGI gateway for ldbf server(network version)
      ldbfdcgi           - CGI gateway for ldbf server(local version)
      ldbfcompile        - ldbf.conf checker and compiler for stored procedures
      ldbflog	         - shows contents of transaction log
   contrib/
      ldbfpack           - packs DBF file
      ldbfreindx         - reindexes DBF file
      ldbfaddindx        - adds index tag to DBF file
      ldbfhtml	         - generates HTML form for specified DBF file
    etc/
                         - this directory containes all config. and 
                           admin. files
    lib/
      libldbf.a          - LDBF client library, API for C language
      libwidget.a        - LDBF utilites library (needed for compile)
    include/
      ldbf.h             - header for C programming with libldbf.a library
      ldbfwidget.h       - header for C programming(automaticaly included in ldbf.h)
    Java/                - LDBF API for Java
      ...
    Examples/
      ...                - examples for C
    Demo/
      ...                - example of small application for LDBF


LDBF-ADMIN - Experimental LDBF admin manager
----------------------------------------------
ldbf-admin is HTTP admin manager for LDBF server.
You can use any WWW browser for access to manager.
By default it uses TCP port 7980.
For example, if your LDBF home is /usr/local/ldbf,
you may run manager as 

ldbf-admin -d /usr/local/ldbf &

In order to access manager,run browser and go to URL:

http://yourhost:7980

ldbf-admin uses password file etc/admpw.By default,the user 'admin' 
with password 'admin' stored in this file.In order to change user or password,
use utility htpasswd from the contrib subdirectory.
ldbf-admin is not tested completly,send any bugs ASAP.

LDBFD - server daemon
---------------------------------------------------
It now supports stored procedures and triggers.
I use S-Lang language by John E. Davis to write procedures.
See slang.txt for syntax and language usage for more detail.

In order to execute server you must load ldbfd program.
 it has a few parameters that you may specify:

    ldbfd -cconf_path -llog_level -pport -iid -u
  where:
       -u          - do not use Unix Domain sockets protocol.
       -chome_dir  - defines LDBF home directory(home_dir).
                     by default it uses current directory.    
       -llog_level - as in the conf file, this is level of logging.
       -pport      - specify another TCP port for listen,default is 7979.
       -iid        - specify id for this server.It need if you start more than one
                     server on the same machine.

ldbf.conf file must exists in subdirectory etc/ of the LDBF's home directory,
otherwise you cannot connect to server.

ldbf.sl is default procedure & startup file.You can store all stored 
procedures in this file.ldbf.sl is read before proccessing ldbf.conf.
If you hardly use stored procedures or triggers it's recommended to define
all stored procedures and triggers in this file.It would be read once
instead of reading file with stored procedure every calling.
ldbf.sl resides in subdirectory etc/ of the LDBF's home directory.

Server logs all errors in log file ldbf.log and via syslog facility.
Transactions are kept in file ldbflog.tts in the etc/ subdirectory of LDBF's 
home directory.

LDBFSETUP
----------------------------------------------
Using this program you can change some tunable parameters
in ldbfd server.
Free version comes with special serial number for 1 user license.
ldbfsetup looks for ldbfd program in current directory only.
It is incompatible with versions earler 0.11.
Use serial number and activisation key that comes with
package to set apropriate user license(commercial versions only).

LDBFMONITOR - LDBF server monitor
--------------------------------------

   ldbfmonitor [[-tperiod] [-sscript] [-iid]]
  where
   -tperiod    -   refresh screen after each period seconds
   -sscript    -   run SLang script and exit after its completion
   -iid        -   specify LDBF server's ID.

 ldbfmonitor give you ability to monitor all ldbf server work.
 you may see all users connected to server, it open databases,
 commands that server doing.
 Monitor updates every 5 seconds, but you may specify another
 update period in command line.
 You may reindex any databases without shutdown server and
 users via menu Reindex.
 Also you may execute any defined stored procedure.
 Browser allows you insert,delete and modify records.
 id is server's id you want connect to.
 script is stored procedure.ldbfmonitor executes this stored
 procedure and exits.May be useful for batching purpose.
 In the xterm terminal you can use mouse.

LDBFCOMPILE - check ldbf.conf and compile S-Lang procedure
---------------------------------------------
This utility loads and checks ldbf.conf and is also used for checking 
syntax of SLang scripts.This is useful to check config file before real 
users will start connecting to server.All errors will be written 
to ldbf.log file.

In order to S-Lang functions executed more quickly you may
compile this procedures.After compile it will have extension
.slc. Define in ldbf.conf this newer file with .slc extension
and server will not parse text but start to execute function.


LDBFCGI - CGI gateway for building WWW sites using LDBF server
---------------------------------------------------
If you have some information and you want make it available
via your WWW site, you may use ldbf server as database.
Using ldbfcgi you may write scripts in SLang that accesses
ldbf server and returns information back to client.
See examples in CGI-Interface/ subdirectory for more details.
ldbfcgi are network version,it uses TCP to connect to server.
ldbfdcgi is local version,it connects to server on the same machine only,
using shared memory.
Look for example of ldbfcgi.conf in CGI-Interface/ subdirectory.
All errors are logged in /tmp/ldbfcgi.log file.

Important notes
--------------------------------------

Since 1.0 version, LDBF'll be commercial product.
Free version available at ftp.kiae.su in /linux/misc directory
Also it avalaibe at sunsite.unc.edu /pub/Linux/Incoming or 
/pub/Linux/apps/databases

Information may be obtained from our www site:
   http://torn.ktts.kharkov.ua
or
   finger ldbf@torn.ktts.kharkov.ua

report bugs and suggestions to
      vlad@torn.ktts.kharkov.ua
