INSTALL

Notes
-----

This package provides the katcp library, several utilities and
a control server for the KAT 7 correlator, kcs. For the time
being kcs invokes the corr package (not included) to control
the correlator, but uses its own monitoring subsystem (fmon).

Build requirements
------------------

To build this you need GCC and GNU Make. Generally the code
doesn't contain that much GCC specific stuff (one or two 
__attribute__ ((packed)) statements), but the Makefiles do 
use GNU Make features.

Configuration
-------------

There is no configure script. If you wish to change some
build option (eg amount of debug information, floating
point support, version support) edit Makefile.inc. The various 
options are documented there.

Build
-----

Type 

  make 

at the top level directory. It is also possible to run make in
individual subdirectories. In that case build the content of the
katcp/ subdirectory first, as most other modules depend on it

Installation
------------

If you are only interested in the library (and maybe kcpcmd
or kcplog), enter the respective subdirectories and run make
install from there, or type 

  make -C katcp install
  make -C cmd install

Installing the KAT7 correlator startup logic will no
longer be installed by a global make install, you will
have to do a make install in the scripts and misc directories.
For this to be useful, you also require a configured corr
package, nfs server, dnsmasq, bof files, an exported ppc
filesystem not to mention 16 roach boards.