From dan Thu Dec  8 13:06:43 1994
From: Denis Nicole <dan>
Message-Id: <4093.9412081306@orca.ecs.soton.ac.uk>
Subject: T9000 tools
To: tcarden@parsys.co.uk, bobdob@cernvm.cern.ch, gassilloud@telmat.fr,
        paul@ace.nl, rob@pact.nl, emmanuel@parsys.co.uk, pmiguel@fi.upm.es
Date: Thu, 8 Dec 1994 13:06:38 +0000 (GMT)
Cc: dan (Denis Nicole), rs1 (Rajini Sivaram)
X-Mailer: ELM [version 2.4 PL0]
Mime-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Length: 3367      
Status: OR

The first release of SCOTT, the Southampton COff Tools for Transputers
can now be obtained by anonymous ftp from "ecs.soton.ac.uk".  You need
the three files gdb.tar.gz iserver.tar.gz and wish.tar.gz in directory
"/pub/transputer/t9000". These amount to about 10Mbytes in binaries and
sources.

Fuller documentation will follow shortly.

INSTALLATION
------------

Create a directory for SCOTT and untar the three files into it
	gunzip -c iserver.tar.gz | tar xvf -
	<similarly wish, gdb>
You will have a top-level directory, eg SCOTT with three subdirectory
trees, iserver, wish and gdb. cd to directory SCOTT/wish/examples and
edit the file transputer.dat to suit your system and the file setup to
have the appropriate TRANSPUTER variable.  Then, from the C shell 
	setenv WISH <full path of SCOTT directory>
	source setup

You must use our special iserver which has non-INMOS socket support and
ACE Xserver support---setup sets this up.


ASSUMED CONFIGURATION
---------------------

The binaries are built for SUNs running SUNOS. Any of the normally INMOS
supported interfaces such as the B300 should work; we have added support
for Transtech and Archipel (Telmat?) cards.  The transputer
configuration is assumed to be:

           +-----------+  +----+    +-------+ 
iserver----|L0       L2|--|C100|----|Cin    |
           |         L3|--|    |----|L0     |
           | T805 +    |  +----+    | T9000 |
           | 2or4Mbytes|            +-------+
           +-----------+

PVM will also assume a C104 connected via a C100 to link 3 of the T805.
If your limk configurations differ, you will need to change some of the
scripts. 


TESTING
-------

Iserver tests
-------------

After running setup, cd to SCOTT/iserver/examples and
	iserver -sb xcc.run
will test xpds binary support.
	setenv IBOARDSIZE #400000
	iserver -sb icc.btl
will test INMOS binary support; set IBOARDSIZE appropriately for your
system.

TCL/Wish tests
--------------

cd to SCOTT/wish/tcl
	iserver -sb tclsh.run
	[%] expr 2 + 2
	[4]
	[%] exit
will test the tcl binary; tcl's prompts and responses are enclosed in
[].

cd to SCOTT/wish/tk and setup the DISPLAY variable
	setenv DISPLAY mycomputer:0.0
	iserver -sb wish 
will run the wish X-based scripting system and 
	iserver -sb wish -f library/demos/widget
will run an extensive wish demo.


T9000 tests
-----------

cd to SCOTT/wish/examples. then
	tclserv hello.out 
will load and run an XPDS C program on the T9000
	wishserv hello.out
will do the same thing but with a dedicated window for the program
output
	tclserv gdbtest.out -D gdbwin
will open a debugging window for the program gdbtest.

Note that sources are provided for both T9000 and T800 gdb but only a
T9000 binary is included.


Building T9000 applications (single processor)
----------------------------------------------

The Makefile in SCOTT/wish/examples should provide a template.  In short, if 
you want to use the debugger, you need to link SCOTT/wish/lib/dbginit.o as
the start-up, SCOTT/wish/lib/t9socket.o for socket support and 
SCOTT/wish/lib/libdbg.a to provide the debug stub as well as the usual XPDS
libraries. the -D gdbwin option to tclserv then activates gdb. Don't forget
also to compile with the -g flag to get a symbol table.

If you don't need the debugger, you can omit libdbg.a and t9socket.o and
replace dbginit.o with coffinit.o


Denis.