# $Revision: 1.6.98.1 $	$Date: 95/07/20 10:55:47 $


		 Setup Instructions for Programming Q4


Programming Q4 is done via the text processing language Perl.  You must
have Perl to program Q4.  (These scripts were developed using Perl 4.0.  I
haven't tried 5.x, yet.  Caveat emptor.)

Perl is available within HP from many sources.  A good starting place is the
ninstall catalog:

	ninstall -hhp-gjd.hp.com catalog

Outside HP, Perl is available from:

	* any of the comp.sources.unix archives

	* ftp via:
		ftp.uu.net (137.39.1.9)
		archive.cis.ohio-state.edu (128.146.8.52)
		jpl-devvax.jpl.nasa.gov (128.149.1.143)

	* anonymous uucp via:
		uunet
		osu-cis

The Q4 programming package should be available on your system in the file

	/usr/contrib/lib/Q4Lib.tar.Z

(It's installed from an optional fileset along with several other
contributed utilities.)  Use uncompress(1) and tar(1) to unpack the file.

Q4 is quite independent of kernel version, but some of the scripts are not.
Q4 automatically adapts to fields within data structures moving around, but
it can't automatically handle changes in the algorithms that organize the
data structures.  That responsibility falls to the scripts.  Many of them
encapsulate the knowledge that can change from release to release of how to
navigate through kernel data structures.

These algorithmic changes don't happen frequently so often times an exact
match of the kernel and the script library will not be necessary.  However,
to have the best chance of success debugging a crashdump take the scripts
archive (Q4Lib.tar.Z) from the system that crashed and unpack it in the
directory where you've chosen to debug the crashdump.  (It will unpack the
scripts into a directory called "q4lib" in the current directory.)

Next, move sample.q4rc.pl to ~/.q4rc.pl.  This is the file Q4 invokes when
you ask for programming (the "-p" option).  It adds your "./q4lib"
directory to the include search path, initializes the debugging environment
and then enters the main loop (where you get interactive control).

You can change your copy of this file (~/.q4rc.pl) to change your search
path or add other directories to it.  You can also add anything else you
choose to further customize your debugging environment.
