Previous: OS Incompatibilities, Up: Building Kerberos V5

3.11 Using Autoconf

(If you are not a developer, you can skip this section.)

In most of the Kerberos V5 source directories, there is a configure script which automatically determines the compilation environment and creates the proper Makefiles for a particular platform. These configure files are generated using autoconf, which can be found in the src/util/autoconf directory in the distribution.

Normal users will not need to worry about running autoconf; the distribution comes with the configure files already prebuilt. Developers who wish to modify the files should see Overview (The Autoconf Manual).

Note that in order to run autoconf, you must have GNU m4 in your path. Before you use the autoconf in the Kerberos V5 source tree, you may also need to run configure, and then run make in the src/util/autoconf directory in order to properly set up autoconf.

One tool which is provided for the convenience of developers can be found in src/util/reconf. This program should be run while the current directory is the top source directory. It will automatically rebuild any configure files which need rebuilding. If you know that you have made a change that will require that all the configure files need to be rebuilt from scratch, specify the --force option:

     % cd /u1/krb5-post-1.4/src
     % ./util/reconf --force

The developmental sources are a raw source tree (before it's been packaged for public release), without the pre-built configure files. In order to build from such a source tree, you must do:

     % cd krb5/util/autoconf
     % ./configure
     % make
     % cd ../..
     % util/reconf

Then follow the instructions for building packaged source trees (above). To install the binaries into a binary tree, do:

     % cd /u1/krb5-post-1.4/src
     % make all
     % make install DESTDIR=somewhere-else