Target Communications Library
=============================


Contents
--------

This directory contains source files for building TCL and
several demonstration programs, on non-Rabbit target
processors.

There may be a target-specific README file for the processors
which are directly supported.  The supported platforms are
currently:

  README.bc  -  Borland C, targeting 80x86 processors with a
                DOS-like programming environment, such as
                MS-DOS desktop PCs, or embedded 80x86 boards.

  README.linux - Embedded or desktop Linux machines.  Most
                any fairly recent kernel version should work,
                since only user-mode processes are necessary.
                Assumes GNU tools (gcc, make etc.) are
                available.

  README.solaris - Embedded or desktop Sparc-based machines,
                running a Solaris or similar System-V-like
                operating system.  The code base is the same
                as that for Linux; only the tc_conf.h file is
                changed to account for machine-level
                differences.  This also assumes the GNU tools
                are available, however it should also work
                with Sun compilers.

Of course, Rabbit processors are also supported via Dynamic-C
library (.lib) files.

Whichever platform is selected, you will need to set up and
run a Rabbit-based DeviceMate before trying to run any of
the demo programs herein.

The current demo programs are:

  TCP/IP subsystem:
    act_open.c
    dns_look.c
    pas_open.c
    tcp_time.c
    udp_echo.c

  File subsystem:
    fs_gen.c
  
  Logging subsystem:
    log100.c
  
  Mail subsystem:
    smtp.c
  
  Dynamic variables subsystem:
    var.c
  
  Watchdog subsystem:
    wd.c

Other source files (.c and .h) are the Target Communications Library
itself.  The only file you may need to examine is tc_conf.h.  This
contains configuration items for each supported platform.  Non-
supported platforms may require more extensive modifications of other
library files, plus implementation of some of the expected low-level
functions.


Installing and Building
-----------------------

The specific commands to install and build the TCL and demos depend
on the platform.  In general, the archive file needs to be unpacked
from the Dynamic-C distribution CDROM.  If desired, the makefile may
be renamed for convenience.  The makefile is then executed in order
to build executable modules.

Please refer to the platform-specific README file (and the DeviceMate
manual) for details.



Enjoy!

==== The Z-World Target Communications Team ====