3.1 Configuring the distribution
Polygraph comes with an auto-configuration script. The script analyses your
environment and adjusts Polygraph settings accordingly. The configuration step
is required for Polygraph installation.
Unpack the archive. For example:
gunzip -c polygraph-2.6.0-src.tar.gz | tar -xvf -
Change your directory to polygraph/:
Configure the distribution:
Watch configuration process for warnings or errors. In some cases, you may
need to specify parameters for the configure script. Read the
INSTALL file or type ./configure --help for more
Polygraph does not have optional modules of features that can be enabled or
disabled at the configure time.
Note that configuration process caches some of the results. The
cache can be found in the config.cache file. If you are fiddling with
configuration parameters or are changing your setup, it is probably a good
idea to remove that cache file before running configure again.
Otherwise, the script may not notice the changes you have made. Furthermore,
to remove all traces of a successful configuration and return to
ground zero, you may run make distclean.
MS Windows users should skip the configuration step.
3.2 Building the distribution
Change your directory to polygraph/ if you are not
If you do not have GNU make
installed on your system, install it. Native makers may work, but GNU
maker often works better.
Watch out for compilation warnings and errors. Please report them to
us. Not all warnings are harmful, but it never hurts to double check. In
our environment, Polygraph compiles with no warnings.
- Make should create several executables including
polyclt and polysrv. Those executables are sufficient
for running most tests and analyzing the results.
Some of the optional tools may not build on your system. For example,
polymon requires, among other things, properly installed ncurses
To install Polygraph files, run
You may or may not need special file access
permissions to do that, depending on what you told configure
about the installation directory. By default, Polygraph will install into
the /usr/local/polygraph/ directory.
If you get errors during the build, please report them to us. At the very
least, we can probably help you to fix the problem. In general, without your
feedback, the bug will remain there -- we do not release source code that has
compilation problems in our environment, so if you see an error, you
can be pretty sure we do not know about it...
MS Windows users do not have to compile Polygraph since binaries are
available (in InstallShield format). However, they can try to compile
Polygraph by running the config.bat batch file from Polygraph
distribution (requires Microsoft nmake).
Polygraph is known to compile with g++ and MS Visual
C++, but other compilers may work as well.
At the time of writing, Polygraph does not support automated
de-installation. You have to remove unneeded files manually.