Compilation and Installation

PrevInstallationNext

Compilation and Installation

When you run ./configure you should specify the path to your root KDE3 and Qt3 directories. At the command prompt, type ./configure --prefix=<path to kde3> --with-qt-dir=<path to Qt3.x> --enable-debug=full. The ./configure script will examine your system and attempt to locate needed libraries and files. If it returns an error, it will exit; if the error message on the screen is not descriptive enough, take a look at the end of the config.log file. If the prerequisite software mentioned in the Software Requirements section of this document has been installed, the script should run to completion.

If the ./configure routine fails to find db4/db.h or db3/db.h on your machine, you may need to modify the file logcore.h to point to the correct file on your machine and recompile the file. When Berkeley DB is installed from packages provided by Sleepycat Software, the common installation location is often /usr/local/BerkeleyDB.4.0. The db.h file is located within the include directory of BerekelyDB. Locate the Berkeley DB file db4/db.h (i.e. run slocate db.h); copy the correct path to into the logcore.h file. The lines in logcore.h to modify look like this:
#ifdef HAVE_LIBDB_4_0
#include <db4/db.h>
#else
#include <db3/db.h>
#endif

As an example, that section in the author's logcore.h file has been altered to look like this:
#include </usr/local/BerkeleyDB.4.0/include/db.h>

As in the example above, you will likely need to remove the other lines (starting with 'ifdef' and ending with 'endif'), keeping only the line that has your correct BerkeleyDB path. Please note that you must recompile the file to run the program.

If configure still will not run to completion, consult the Troubleshooting section of this document.

Make and install the application with make; make install

Ensure that your regular user(s) have read/write permissions for your serial (ttySx) port that interfaces with your radio. One way to permit users to access the serial port is to issue the command: chmod ug+rw /dev/ttyS0 (*modify this to match your machine, usually COM1->/dev/ttyS0, COM2->/dev/ttyS1*) and then ensuring that your users are included in the group that owns serial port access. To find out which group owns /dev/ttySx, simply enter ls -al /dev/ttyS0. Serial port permissions are often alloted to the uucp group. If this is the case on your machine, simply add your username to the appropriate group.

Users will also need read access on /dev/audio, /dev/dsp, or your machine's sound device. For soundcard and sound troubleshooting, please refer to the Sound-How-To.

Exit the 'root' identity and login as a regular user (with correct permissions for tty and audio).

Start KDE3 (if you are not currently running KDE3)

The executable file is in the KPSK directory and will also be installed to the kde3/bin during the make install portion of installation. To run the program from the command line, be sure that the path to your kde3/bin is in your PATH environment variable. To run the program, issue the command kpsk. You may also start the program by changing to the directory where the KPSK executable is located and issuing the command ./kpsk.

If you have performed the installation correctly, the program will start up and you will see the waterfall begin to scroll down the screen. If the startup crashed or otherwise bombed out, see the Troubleshooting section of this document.

PrevHomeNext
Prerequisites for installation of KPSK Up Other References