SICS README

  Requirements 

  - hdf-4, hdf5- libraries: http://hdf.ncsa.uiuc.edu
  - szlib                 : same place as HDF
  - Mini XML library      : http://www.minixml.org/software.php
  - libghttp              : 
       http://ftp.gnome.org/pub/GNOME/source/libghttp/1.0/libghttp-1.0.9.tar.gz
  - json-c                : http://oss.metaparadigm.com/json-c
  - tcl                   : any version from 8.0, package tcl-devel on most 
                            modern linux distros


  Building

  Install the libraries stated above, preferably to a common place.
  Then edit the suplied makefile, instance makefile_linux, and change:
  - uncomment all the NI, NIOBJ, NILIB stuff, except if you want support 
    for the NI enet100 GPIB/TCP/IP converter. 
  - Edit linux_def and set HDFROOT to where you installed your libraries
  - Review the CFLAGS and LIBS to match your setup. Consider file format
    format support:
    ** HDF-4 required -DHDF4 in CFLAGS and -lmfdf -ldf in LIBS
    ** HDF-5 support requires: -DHDF5 in CFLAGS and -lhdf5 in LIBS 
    ** XML support requires:  -DNXXML -n CFLAGS and -lmxml in LIBS
  - build with make -f makefile_linux
  - Good Luck!!
  Sorry, no configure script here. There are so few people building SICS 
  that it is not worth the effort. The effort really is to build the 
  libraries.


  Running
  
  In the sim directory there are startup scripts for a number of different 
  instruments. To run any of them:
  - edit the instrument file and change the home or root variable at the 
    top to match your setup.
  - run with: SICServer path-to-instrument-file
    For example: SICServer sim/topsi/morpheus.tcl
  - Common issues:
    ** tmp directory missing: create one
    ** SicsDataNumber file missing: create a file with a single 0 in it

  
  Trying it out with telnet

  - telnet host-where-sics-runs 2911
  - type username and password: Spy 007 is a good idea for the supplied sims
  - type SICS commands


  Directories

  sics             : root directory containing the SICS kernel
  sics/psi         : psi specific drivers and stuff
  sics/site_ansto  : ANSTO specific stuff. Currently empty, ANSTO has its 
                     own cvs
  sics/dummy       : example kit for defining an own site
  sics/doc/user    : user documentation
  sics/doc/manager : manager documentation
  sics/doc/programmer : programmer documentation
  sics/matrix      : matrix library used within SICS
  sics/mcstas      : code for virtual McStas instruments
  sics/sim         : control files for various instruments
  sics/test        : a sort of regression test for the SICS server