Files
heimdal/doc/install.texi
Johan Danielsson 3687b1c603 Updated.
git-svn-id: svn://svn.h5l.se/heimdal/trunk/heimdal@4097 ec53bebd-3082-4978-b11e-865c3cabbd6b
1997-12-04 03:59:10 +00:00

77 lines
2.7 KiB
Plaintext

@node Building and Installing, Setting up a realm, What is Kerberos?, Top
@comment node-name, next, previous, up
@chapter Building and Installing
Heimdal uses GNU Autoconf to configure for specific hosts, and GNU
Automake to manage makefiles. If this is new to you, the short
instruction is to run the @code{configure} script in the top level
directory, and when that finishes @code{make}.
If you want to build the distribution in a different directory from the
source directory, you will need a make that implements VPATH correctly,
such as GNU make.
You will need to build the distribution:
@itemize @bullet
@item
A compiler that supports a ``loose'' ANSI C mode, such as @code{gcc}.
@item
lex or flex
@item
awk
@item
yacc or bison
@item
a socket library
@item
NDBM or Berkeley DB for building the server side.
@end itemize
When everything is built, you can install by doing @kbd{make
install}. The default location for installation is @file{/usr/heimdal},
but this can be changed by running @code{configure} with
@samp{--prefix=/some/other/place}.
If you need to change the default behavior, configure understands the
following options:
@table @asis
@item @kbd{--without-berkeley-db}
DB is preferred before NDBM, but if you for some reason want to use NDBM
instead, you can use this option.
@item @kbd{--with-krb4=@file{dir}}
Gives the location of Kerberos 4 libraries and headers. This enables
Kerberos 4 support in the applications (telnet, rsh, popper, etc) and
the KDC. If you keep libraries and headers in different places, you can
instead give the path to each with the @kbd{--with-krb4-lib=@file{dir}},
and @kbd{--with-krb4-include=@file{dir}} options.
You will need a fairly recent version of our Kerberos 4 distribution for
@code{rshd} and @code{popper} to support version 4 clients.
@item @kbd{--enable-kaserver}
Enables experimental kaserver support in the KDC. This is the protocol
used by the ``KDC'' in AFS. Requires Kerberos 4 support.
@item @kbd{--with-readline=@file{dir}}
Gives the path for the GNU Readline library, which will be used in some
programs. If no readline library is found, the (simpler) editline
library will be used instead.
@end table
@menu
* Finishing the installation::
@end menu
@node Finishing the installation, , Building and Installing, Building and Installing
@section Loose threads
@pindex login
There is a login program in the distribution, but it isn't built by
default, and might not work as expected. Instead, @code{telnetd} will
try to use the @code{login} found in the @file{/usr/athena/bin}
directory. If you don't have a working login program there (it should
grok the @samp{-f} flag), you can either start telnetd with the
@samp{-L} flag, or edit the definition of @code{BINDIR} in
@file{telnetd.h}.