 		    INSTALLATION INSTRUCTIONS
		      Warren W. Gay VE3WWG
                    Thu Jun  2 20:42:21 2011		

INTRODUCTION:

        The install is now simpler, using ./configure.
        The following is a guided tour.  If you already know
        the autoconf drill, scroll down to the NOTES section.

GUIDED INSTALL:

1.	Find a suitable directory to start from (best done from a
	non root account for overall safety:

		$ cd $HOME
		$ tar xzvf wavplay-2.0.tar.gz

	This creates a subdirectory ./wavplay-2.0 where all the
	extracted files should go.

2.	Change to the new directory:

		$ cd wavplay-2.0

3.      Decide where you want it installed.  If you want it
        installed somewhere other than /usr/local, then you
        must also include a PREFIX=mydir on the ./configure
        command line.

4.      Configure: choose if you want just the commands wavplay
        and wavrec, or whether you also want the X11 client
        program xltwavplay also.

        wavplay and wavrec only:

                $ ./configure --enable-nox

        Full install:

                $ ./configure

5.      Build:

		$ make

6.	Gain root privileges for install:

		$ su

	(or login in as root)

7.      Install

		# make install

NOTES:

        1.  If you want realtime scheduling, add the
            option: -DSCHED_PRIORITY to your ./configure
            CFLAGS variable:

            $ CFLAGS="-DSCHED_PRIORITY" ./configure ...

            Then you must make wavplay and wavrec run
            as setuid root:

            # chown root /usr/local/bin/wavplay
            # chmod u+s  /usr/local/bin/wavplay

            Do the same for wavrec.

            NOTE: setuid root may have security consequences.
                  The author assumes NO responsibility.  Do not
                  apply setuid if you have concerns about this.

        2.  To run xltwavplay, just launch it:

		$ xltwavplay &

        3.  If your audio device is not installed as /dev/dsp,
            then add -DAUDIODEV="/dev/whatever" to your 
            ./configure CFLAGS variable.

        4.  By default the IPC key used for locking the audio
            device is 0x33333333. To use a different key, 
            add -DAUDIOLCK=0xwhatever to your CFLAGS in the
            ./configure step.

TO UNINSTALL:

        You can uninstall wavplay, if you have not already
        upgraded to a newer version.  As root, simply:

                # make uninstall

End INSTALL
