.. _build_V5:

Building Kerberos V5
====================

This section details how to build and install MIT Kerberos software
from the source.

Prerequisites
-------------

In order to build Kerberos V5, you will need approximately 60-70
megabytes of disk space.  The exact amount will vary depending on the
platform and whether the distribution is compiled with debugging
symbol tables or not.

Your C compiler must conform to ANSI C (ISO/IEC 9899:1990, "c89").
Some operating systems do not have an ANSI C compiler, or their
default compiler requires extra command-line options to enable ANSI C
conformance.

If you wish to keep a separate build tree, which contains the compiled
\*.o file and executables, separate from your source tree, you will
need a make program which supports **VPATH**, or you will need to use
a tool such as lndir to produce a symbolic link tree for your build
tree.

Obtaining the software
----------------------

The source code can be obtained from MIT Kerberos Distribution page,
at http://web.mit.edu/kerberos/dist/index.html.
The MIT Kerberos distribution comes in an archive file, generally named
krb5-VERSION.tar, where *VERSION* is a placeholder for the major and minor
versions of MIT Kerberos.  (For example, MIT Kerberos 1.9
has major version "1" and minor version "9".)

The krb5-VERSION.tar contains a compressed tar file consisting of the
sources for all of Kerberos (generally krb5-VERSION.tar.gz) and
a PGP signature file for this source tree (generally
krb5-VERSION.tar.gz.asc).  MIT highly recommends that you verify
the integrity of the source code using this signature.

Unpack krb5-VERSION.tar.gz in some directory. In this section we will assume
that you have chosen the top directory of the distribution the directory
``/u1/krb5-VERSION``.

Review the README file for the license, copyright and other sprecific to the
distribution information.

Contents
--------
.. toctree::
   :maxdepth: 1

   directory_org.rst
   doing_build.rst
   options2configure.rst
   osconf.rst