README for gscanbus 0.6

Andreas Micklei <micklei@fokus.gmd.de>
18.11.1999 - 22.05.2000

What is this?
~~~~~~~~~~~~~

gscanbus is a little bus scanning, testing and topology visualizing tool for
the Linux IEEE1394 subsystem, with some AV/C support, especially for
controlling Camcorders and VCRs.

Prerequisites
~~~~~~~~~~~~~

Obviously a working IEEE1394 subsystem.
(CVS version from 22.05.2000 or newer preferred)
libraw1394 0.6 or greater.

How to compile
~~~~~~~~~~~~~~

Edit the Makefile so that your libraw1394 include and lib files can be
found by the compiler.
Type make

Usage
~~~~~

./gscanbus

Try clicking on some nodes to get additional information.

Do some transactions via the menu bar.

That's all.

Troubelshooting
~~~~~~~~~~~~~~~

If gscanbus aborts with the error message
" error in loading shared libraries: libraw1394.so.2: can't open shared
  object file: No such file or directory "
try one of the following:

1. export LD_LIBRARY_PATH=/usr/local/lib
   (or wherever you installed libraw1394)

2. add the line /usr/local/lib to the file /etc/ld.so.conf and run 
   "/sbin/ldconfig -v"

The first solution works only in the current shell, while the second solutions
solves the problem system wide once and for all. Do not forget to run ldconfig
whenever you install new libraries (it's best to run it automatically at
boot-time).

