ALICE TRD fxsproxy README
		=========================

fxsproxy is a tool for the retrieval of all TRD FEE configuration 
information via DIM acknowledge channel, triggered by a DIM command 
including the run number. This command can be launched from everywhere, 
preferably from within the PVSS SOR script.
In case of any problems, please contact: Frederick.Kramer@cern.ch


REQUIREMENTS
------------

The Library libdim is necessary for this package.


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

The installation procedure makes use of the GNU quasi-standard 
autoreconfigure, which is creating a configure script which then provides 
the actual makefiles.
The standard installation procedure comprises the following steps:
1. unpack & enter the package:
	tar zxfv fxsproxy.tar.gz
	cd fxsproxy
2. create the makefiles with the prefix /
	./configure --prefix=/
3. compile the code and test the output
	make
4. install the fxsproxy (you need to be root for this)
	(su)
	make install
	(exit)


INSTALLATION/DE-INSTALLATION OPTIONS
-----------------------------------

- remove the installed files
	make uninstall
- erase what has been built
	make clean 
- additionally erase anything './configure' has created
	make distclean


OPERATION
---------

This package comes with 3 binary programs:
1. a command-line test-server: fxsproxy_server, which stops after collecting
   all information once, sends output to stdout
2. a test-client: fxsproxy_testclient, which takes the run number as unique 
   argument - use 1 for testing purposes
3. the daemon fxsproxyd, which contains the same functionalities like
   fxsproxy_server but runs as a background process, puts output to
   /var/log/messages and can be controlled in the normal fashoined way,
   e.g. "/sbin/service fxsproxyd [arg]" while arg can be one out of
   start/stop/status