1@node Building and Installing, Setting up a realm, What is Kerberos?, Top 2@comment node-name, next, previous, up 3@chapter Building and Installing 4 5Heimdal uses GNU Autoconf to configure for specific hosts, and GNU 6Automake to manage makefiles. If this is new to you, the short 7instruction is to run the @code{configure} script in the top level 8directory, and when that finishes @code{make}. 9 10If you want to build the distribution in a different directory from the 11source directory, you will need a make that implements VPATH correctly, 12such as GNU make. 13 14You will need to build the distribution: 15 16@itemize @bullet 17@item 18A compiler that supports a ``loose'' ANSI C mode, such as @code{gcc}. 19@item 20lex or flex 21@item 22awk 23@item 24yacc or bison 25@item 26a socket library 27@item 28NDBM or Berkeley DB for building the server side. 29@end itemize 30 31When everything is built, you can install by doing @kbd{make 32install}. The default location for installation is @file{/usr/heimdal}, 33but this can be changed by running @code{configure} with 34@samp{--prefix=/some/other/place}. 35 36If you need to change the default behavior, configure understands the 37following options: 38 39@table @asis 40@item @kbd{--without-berkeley-db} 41DB is preferred before NDBM, but if you for some reason want to use NDBM 42instead, you can use this option. 43 44@item @kbd{--with-krb4=@file{dir}} 45Gives the location of Kerberos 4 libraries and headers. This enables 46Kerberos 4 support in the applications (telnet, rsh, popper, etc) and 47the KDC. It is automatically check for in @file{/usr/athena}. If you 48keep libraries and headers in different places, you can instead give the 49path to each with the @kbd{--with-krb4-lib=@file{dir}}, and 50@kbd{--with-krb4-include=@file{dir}} options. 51 52You will need a fairly recent version of our Kerberos 4 distribution for 53@code{rshd} and @code{popper} to support version 4 clients. 54 55@item @kbd{--enable-kaserver} 56Enables experimental kaserver support in the KDC. This is the protocol 57used by the ``KDC'' in AFS. Requires Kerberos 4 support. 58 59@item @kbd{--enable-kaserver-db} 60Enables experimental support for reading kaserver databases in hprop. 61This is useful when migrating from a kaserver to a Heimdal KDC. 62 63@item @kbd{--disable-otp} 64By default some of the application programs will build with support for 65one-time passwords (OTP). Use this option to disable that support. 66 67@item @kbd{--enable-osfc2} 68Enable some C2 support for OSF/Digital Unix/Tru64. Use this option if 69you are running your OSF operating system in C2 mode. 70 71@item @kbd{--with-readline=@file{dir}} 72Gives the path for the GNU Readline library, which will be used in some 73programs. If no readline library is found, the (simpler) editline 74library will be used instead. 75 76@item @kbd{--with-hesiod=@file{dir}} 77Enables hesiod support in push. 78 79@item @kbd{--enable-netinfo} 80Add support for using netinfo to lookup configuration information. 81Probably only useful (and working) on NextStep/Mac OS X. 82 83@item @kbd{--without-ipv6} 84Disable the IPv6 support. 85 86@end table 87