summaryrefslogtreecommitdiff
path: root/doc/html/build/options2configure.html
diff options
context:
space:
mode:
authorCy Schubert <cy@FreeBSD.org>2017-07-07 17:03:42 +0000
committerCy Schubert <cy@FreeBSD.org>2017-07-07 17:03:42 +0000
commit33a9b234e7087f573ef08cd7318c6497ba08b439 (patch)
treed0ea40ad3bf5463a3c55795977c71bcb7d781b4b /doc/html/build/options2configure.html
Notes
Diffstat (limited to 'doc/html/build/options2configure.html')
-rw-r--r--doc/html/build/options2configure.html491
1 files changed, 491 insertions, 0 deletions
diff --git a/doc/html/build/options2configure.html b/doc/html/build/options2configure.html
new file mode 100644
index 000000000000..3552932b5ebf
--- /dev/null
+++ b/doc/html/build/options2configure.html
@@ -0,0 +1,491 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+
+ <title>Options to configure &mdash; MIT Kerberos Documentation</title>
+
+ <link rel="stylesheet" href="../_static/agogo.css" type="text/css" />
+ <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
+ <link rel="stylesheet" href="../_static/kerb.css" type="text/css" />
+
+ <script type="text/javascript">
+ var DOCUMENTATION_OPTIONS = {
+ URL_ROOT: '../',
+ VERSION: '1.15.1',
+ COLLAPSE_INDEX: false,
+ FILE_SUFFIX: '.html',
+ HAS_SOURCE: true
+ };
+ </script>
+ <script type="text/javascript" src="../_static/jquery.js"></script>
+ <script type="text/javascript" src="../_static/underscore.js"></script>
+ <script type="text/javascript" src="../_static/doctools.js"></script>
+ <link rel="author" title="About these documents" href="../about.html" />
+ <link rel="copyright" title="Copyright" href="../copyright.html" />
+ <link rel="top" title="MIT Kerberos Documentation" href="../index.html" />
+ <link rel="up" title="Building Kerberos V5" href="index.html" />
+ <link rel="next" title="osconf.hin" href="osconf.html" />
+ <link rel="prev" title="Doing the build" href="doing_build.html" />
+ </head>
+ <body>
+ <div class="header-wrapper">
+ <div class="header">
+
+
+ <h1><a href="../index.html">MIT Kerberos Documentation</a></h1>
+
+ <div class="rel">
+
+ <a href="../index.html" title="Full Table of Contents"
+ accesskey="C">Contents</a> |
+ <a href="doing_build.html" title="Doing the build"
+ accesskey="P">previous</a> |
+ <a href="osconf.html" title="osconf.hin"
+ accesskey="N">next</a> |
+ <a href="../genindex.html" title="General Index"
+ accesskey="I">index</a> |
+ <a href="../search.html" title="Enter search criteria"
+ accesskey="S">Search</a> |
+ <a href="mailto:krb5-bugs@mit.edu?subject=Documentation__Options to <em>configure</em>">feedback</a>
+ </div>
+ </div>
+ </div>
+
+ <div class="content-wrapper">
+ <div class="content">
+ <div class="document">
+
+ <div class="documentwrapper">
+ <div class="bodywrapper">
+ <div class="body">
+
+ <div class="section" id="options-to-configure">
+<span id="options2configure"></span><h1>Options to <em>configure</em><a class="headerlink" href="#options-to-configure" title="Permalink to this headline">¶</a></h1>
+<p>There are a number of options to configure which you can use to
+control how the Kerberos distribution is built.</p>
+<div class="section" id="most-commonly-used-options">
+<h2>Most commonly used options<a class="headerlink" href="#most-commonly-used-options" title="Permalink to this headline">¶</a></h2>
+<dl class="docutils">
+<dt><strong>-</strong><strong>-help</strong></dt>
+<dd>Provides help to configure. This will list the set of commonly
+used options for building Kerberos.</dd>
+<dt><strong>-</strong><strong>-prefix=</strong><em>PREFIX</em></dt>
+<dd>By default, Kerberos will install the package&#8217;s files rooted at
+<tt class="docutils literal"><span class="pre">/usr/local</span></tt>. If you desire to place the binaries into the
+directory <em>PREFIX</em>, use this option.</dd>
+<dt><strong>-</strong><strong>-exec-prefix=</strong><em>EXECPREFIX</em></dt>
+<dd>This option allows one to separate the architecture independent
+programs from the host-dependent files (configuration files,
+manual pages). Use this option to install architecture-dependent
+programs in <em>EXECPREFIX</em>. The default location is the value of
+specified by <strong>-</strong><strong>-prefix</strong> option.</dd>
+<dt><strong>-</strong><strong>-localstatedir=</strong><em>LOCALSTATEDIR</em></dt>
+<dd>This option sets the directory for locally modifiable
+single-machine data. In Kerberos, this mostly is useful for
+setting a location for the KDC data files, as they will be
+installed in <tt class="docutils literal"><span class="pre">LOCALSTATEDIR/krb5kdc</span></tt>, which is by default
+<tt class="docutils literal"><span class="pre">PREFIX/var/krb5kdc</span></tt>.</dd>
+<dt><strong>-</strong><strong>-with-netlib</strong>[=<em>libs</em>]</dt>
+<dd>Allows for suppression of or replacement of network libraries. By
+default, Kerberos V5 configuration will look for <tt class="docutils literal"><span class="pre">-lnsl</span></tt> and
+<tt class="docutils literal"><span class="pre">-lsocket</span></tt>. If your operating system has a broken resolver
+library or fails to pass the tests in <tt class="docutils literal"><span class="pre">src/tests/resolv</span></tt>, you
+will need to use this option.</dd>
+<dt><strong>-</strong><strong>-with-tcl=</strong><em>TCLPATH</em></dt>
+<dd>Some of the unit-tests in the build tree rely upon using a program
+in Tcl. The directory specified by <em>TCLPATH</em> specifies where the
+Tcl header file (TCLPATH/include/tcl.h) as well as where the Tcl
+library (TCLPATH/lib) should be found.</dd>
+<dt><strong>-</strong><strong>-enable-dns-for-realm</strong></dt>
+<dd>Enable the use of DNS to look up a host&#8217;s Kerberos realm,
+if the information is not provided in
+<a class="reference internal" href="../admin/conf_files/krb5_conf.html#krb5-conf-5"><em>krb5.conf</em></a>. See <a class="reference internal" href="../admin/realm_config.html#mapping-hostnames"><em>Mapping hostnames onto Kerberos realms</em></a>
+for information about using DNS to determine the default realm.
+DNS lookups for realm names are disabled by default.</dd>
+<dt><strong>-</strong><strong>-with-system-et</strong></dt>
+<dd><p class="first">Use an installed version of the error-table (et) support software,
+the compile_et program, the com_err.h header file and the com_err
+library. If these are not in the default locations, you may wish
+to specify <tt class="docutils literal"><span class="pre">CPPFLAGS=-I/some/dir</span></tt> and
+<tt class="docutils literal"><span class="pre">LDFLAGS=-L/some/other/dir</span></tt> options at configuration time as
+well.</p>
+<p class="last">If this option is not given, a version supplied with the Kerberos
+sources will be built and installed along with the rest of the
+Kerberos tree, for Kerberos applications to link against.</p>
+</dd>
+<dt><strong>-</strong><strong>-with-system-ss</strong></dt>
+<dd><p class="first">Use an installed version of the subsystem command-line interface
+software, the mk_cmds program, the <tt class="docutils literal"><span class="pre">ss/ss.h</span></tt> header file and the
+ss library. If these are not in the default locations, you may
+wish to specify <tt class="docutils literal"><span class="pre">CPPFLAGS=-I/some/dir</span></tt> and
+<tt class="docutils literal"><span class="pre">LDFLAGS=-L/some/other/dir</span></tt> options at configuration time as
+well. See also the <strong>SS_LIB</strong> option.</p>
+<p class="last">If this option is not given, the ss library supplied with the
+Kerberos sources will be compiled and linked into those programs
+that need it; it will not be installed separately.</p>
+</dd>
+<dt><strong>-</strong><strong>-with-system-db</strong></dt>
+<dd><p class="first">Use an installed version of the Berkeley DB package, which must
+provide an API compatible with version 1.85. This option is
+unsupported and untested. In particular, we do not know if the
+database-rename code used in the dumpfile load operation will
+behave properly.</p>
+<p class="last">If this option is not given, a version supplied with the Kerberos
+sources will be built and installed. (We are not updating this
+version at this time because of licensing issues with newer
+versions that we haven&#8217;t investigated sufficiently yet.)</p>
+</dd>
+</dl>
+</div>
+<div class="section" id="environment-variables">
+<h2>Environment variables<a class="headerlink" href="#environment-variables" title="Permalink to this headline">¶</a></h2>
+<dl class="docutils">
+<dt><strong>CC=</strong><em>COMPILER</em></dt>
+<dd>Use <em>COMPILER</em> as the C compiler.</dd>
+<dt><strong>CFLAGS=</strong><em>FLAGS</em></dt>
+<dd>Use <em>FLAGS</em> as the default set of C compiler flags.</dd>
+<dt><strong>CPP=</strong><em>CPP</em></dt>
+<dd>C preprocessor to use. (e.g., <tt class="docutils literal"><span class="pre">CPP='gcc</span> <span class="pre">-E'</span></tt>)</dd>
+<dt><strong>CPPFLAGS=</strong><em>CPPOPTS</em></dt>
+<dd>Use <em>CPPOPTS</em> as the default set of C preprocessor flags. The
+most common use of this option is to select certain #define&#8217;s for
+use with the operating system&#8217;s include files.</dd>
+<dt><strong>DB_HEADER=</strong><em>headername</em></dt>
+<dd>If db.h is not the correct header file to include to compile
+against the Berkeley DB 1.85 API, specify the correct header file
+name with this option. For example, <tt class="docutils literal"><span class="pre">DB_HEADER=db3/db_185.h</span></tt>.</dd>
+<dt><strong>DB_LIB=</strong><em>libs</em>...</dt>
+<dd>If <tt class="docutils literal"><span class="pre">-ldb</span></tt> is not the correct library specification for the
+Berkeley DB library version to be used, override it with this
+option. For example, <tt class="docutils literal"><span class="pre">DB_LIB=-ldb-3.3</span></tt>.</dd>
+<dt><strong>DEFCCNAME=</strong><em>ccachename</em></dt>
+<dd>Override the built-in default credential cache name.
+For example, <tt class="docutils literal"><span class="pre">DEFCCNAME=DIR:/var/run/user/%{USERID}/ccache</span></tt>
+See <a class="reference internal" href="../admin/conf_files/krb5_conf.html#parameter-expansion"><em>Parameter expansion</em></a> for information about supported
+parameter expansions.</dd>
+<dt><strong>DEFCKTNAME=</strong><em>keytabname</em></dt>
+<dd>Override the built-in default client keytab name.
+The format is the same as for <em>DEFCCNAME</em>.</dd>
+<dt><strong>DEFKTNAME=</strong><em>keytabname</em></dt>
+<dd>Override the built-in default keytab name.
+The format is the same as for <em>DEFCCNAME</em>.</dd>
+<dt><strong>LD=</strong><em>LINKER</em></dt>
+<dd>Use <em>LINKER</em> as the default loader if it should be different from
+C compiler as specified above.</dd>
+<dt><strong>LDFLAGS=</strong><em>LDOPTS</em></dt>
+<dd>This option informs the linker where to get additional libraries
+(e.g., <tt class="docutils literal"><span class="pre">-L&lt;lib</span> <span class="pre">dir&gt;</span></tt>).</dd>
+<dt><strong>LIBS=</strong><em>LDNAME</em></dt>
+<dd>This option allows one to specify libraries to be passed to the
+linker (e.g., <tt class="docutils literal"><span class="pre">-l&lt;library&gt;</span></tt>)</dd>
+<dt><strong>SS_LIB=</strong><em>libs</em>...</dt>
+<dd><p class="first">If <tt class="docutils literal"><span class="pre">-lss</span></tt> is not the correct way to link in your installed ss
+library, for example if additional support libraries are needed,
+specify the correct link options here. Some variants of this
+library are around which allow for Emacs-like line editing, but
+different versions require different support libraries to be
+explicitly specified.</p>
+<p class="last">This option is ignored if <strong>-</strong><strong>-with-system-ss</strong> is not specified.</p>
+</dd>
+<dt><strong>YACC</strong></dt>
+<dd>The &#8216;Yet Another C Compiler&#8217; implementation to use. Defaults to
+the first program found out of: &#8216;<cite>bison -y</cite>&#8216;, &#8216;<cite>byacc</cite>&#8216;,
+&#8216;<cite>yacc</cite>&#8216;.</dd>
+<dt><strong>YFLAGS</strong></dt>
+<dd>The list of arguments that will be passed by default to $YACC.
+This script will default YFLAGS to the empty string to avoid a
+default value of <tt class="docutils literal"><span class="pre">-d</span></tt> given by some make applications.</dd>
+</dl>
+</div>
+<div class="section" id="fine-tuning-of-the-installation-directories">
+<h2>Fine tuning of the installation directories<a class="headerlink" href="#fine-tuning-of-the-installation-directories" title="Permalink to this headline">¶</a></h2>
+<dl class="docutils">
+<dt><strong>-</strong><strong>-bindir=</strong><em>DIR</em></dt>
+<dd>User executables. Defaults to <tt class="docutils literal"><span class="pre">EXECPREFIX/bin</span></tt>, where
+<em>EXECPREFIX</em> is the path specified by <strong>-</strong><strong>-exec-prefix</strong>
+configuration option.</dd>
+<dt><strong>-</strong><strong>-sbindir=</strong><em>DIR</em></dt>
+<dd>System admin executables. Defaults to <tt class="docutils literal"><span class="pre">EXECPREFIX/sbin</span></tt>, where
+<em>EXECPREFIX</em> is the path specified by <strong>-</strong><strong>-exec-prefix</strong>
+configuration option.</dd>
+<dt><strong>-</strong><strong>-sysconfdir=</strong><em>DIR</em></dt>
+<dd>Read-only single-machine data such as krb5.conf.
+Defaults to <tt class="docutils literal"><span class="pre">PREFIX/etc</span></tt>, where
+<em>PREFIX</em> is the path specified by <strong>-</strong><strong>-prefix</strong> configuration
+option.</dd>
+<dt><strong>-</strong><strong>-libdir=</strong><em>DIR</em></dt>
+<dd>Object code libraries. Defaults to <tt class="docutils literal"><span class="pre">EXECPREFIX/lib</span></tt>, where
+<em>EXECPREFIX</em> is the path specified by <strong>-</strong><strong>-exec-prefix</strong>
+configuration option.</dd>
+<dt><strong>-</strong><strong>-includedir=</strong><em>DIR</em></dt>
+<dd>C header files. Defaults to <tt class="docutils literal"><span class="pre">PREFIX/include</span></tt>, where <em>PREFIX</em> is
+the path specified by <strong>-</strong><strong>-prefix</strong> configuration option.</dd>
+<dt><strong>-</strong><strong>-datarootdir=</strong><em>DATAROOTDIR</em></dt>
+<dd>Read-only architecture-independent data root. Defaults to
+<tt class="docutils literal"><span class="pre">PREFIX/share</span></tt>, where <em>PREFIX</em> is the path specified by
+<strong>-</strong><strong>-prefix</strong> configuration option.</dd>
+<dt><strong>-</strong><strong>-datadir=</strong><em>DIR</em></dt>
+<dd>Read-only architecture-independent data. Defaults to path
+specified by <strong>-</strong><strong>-datarootdir</strong> configuration option.</dd>
+<dt><strong>-</strong><strong>-localedir=</strong><em>DIR</em></dt>
+<dd>Locale-dependent data. Defaults to <tt class="docutils literal"><span class="pre">DATAROOTDIR/locale</span></tt>, where
+<em>DATAROOTDIR</em> is the path specified by <strong>-</strong><strong>-datarootdir</strong>
+configuration option.</dd>
+<dt><strong>-</strong><strong>-mandir=</strong><em>DIR</em></dt>
+<dd>Man documentation. Defaults to <tt class="docutils literal"><span class="pre">DATAROOTDIR/man</span></tt>, where
+<em>DATAROOTDIR</em> is the path specified by <strong>-</strong><strong>-datarootdir</strong>
+configuration option.</dd>
+</dl>
+</div>
+<div class="section" id="program-names">
+<h2>Program names<a class="headerlink" href="#program-names" title="Permalink to this headline">¶</a></h2>
+<dl class="docutils">
+<dt><strong>-</strong><strong>-program-prefix=</strong><em>PREFIX</em></dt>
+<dd>Prepend <em>PREFIX</em> to the names of the programs when installing
+them. For example, specifying <tt class="docutils literal"><span class="pre">--program-prefix=mit-</span></tt> at the
+configure time will cause the program named <tt class="docutils literal"><span class="pre">abc</span></tt> to be
+installed as <tt class="docutils literal"><span class="pre">mit-abc</span></tt>.</dd>
+<dt><strong>-</strong><strong>-program-suffix=</strong><em>SUFFIX</em></dt>
+<dd>Append <em>SUFFIX</em> to the names of the programs when installing them.
+For example, specifying <tt class="docutils literal"><span class="pre">--program-suffix=-mit</span></tt> at the configure
+time will cause the program named <tt class="docutils literal"><span class="pre">abc</span></tt> to be installed as
+<tt class="docutils literal"><span class="pre">abc-mit</span></tt>.</dd>
+<dt><strong>-</strong><strong>-program-transform-name=</strong><em>PROGRAM</em></dt>
+<dd>Run <tt class="docutils literal"><span class="pre">sed</span> <span class="pre">-e</span> <span class="pre">PROGRAM</span></tt> on installed program names. (<em>PROGRAM</em> is a
+sed script).</dd>
+</dl>
+</div>
+<div class="section" id="system-types">
+<h2>System types<a class="headerlink" href="#system-types" title="Permalink to this headline">¶</a></h2>
+<dl class="docutils">
+<dt><strong>-</strong><strong>-build=</strong><em>BUILD</em></dt>
+<dd>Configure for building on <em>BUILD</em>
+(e.g., <tt class="docutils literal"><span class="pre">--build=x86_64-linux-gnu</span></tt>).</dd>
+<dt><strong>-</strong><strong>-host=</strong><em>HOST</em></dt>
+<dd>Cross-compile to build programs to run on <em>HOST</em>
+(e.g., <tt class="docutils literal"><span class="pre">--host=x86_64-linux-gnu</span></tt>). By default, Kerberos V5
+configuration will look for &#8220;build&#8221; option.</dd>
+</dl>
+</div>
+<div class="section" id="optional-features">
+<h2>Optional features<a class="headerlink" href="#optional-features" title="Permalink to this headline">¶</a></h2>
+<dl class="docutils">
+<dt><strong>-</strong><strong>-disable-option-checking</strong></dt>
+<dd>Ignore unrecognized &#8211;enable/&#8211;with options.</dd>
+<dt><strong>-</strong><strong>-disable-</strong><em>FEATURE</em></dt>
+<dd>Do not include <em>FEATURE</em> (same as &#8211;enable-FEATURE=no).</dd>
+<dt><strong>-</strong><strong>-enable-</strong><em>FEATURE</em>[=<em>ARG</em>]</dt>
+<dd>Include <em>FEATURE</em> [ARG=yes].</dd>
+<dt><strong>-</strong><strong>-enable-maintainer-mode</strong></dt>
+<dd>Enable rebuilding of source files, Makefiles, etc.</dd>
+<dt><strong>-</strong><strong>-disable-delayed-initialization</strong></dt>
+<dd>Initialize library code when loaded. Defaults to delay until
+first use.</dd>
+<dt><strong>-</strong><strong>-disable-thread-support</strong></dt>
+<dd>Don&#8217;t enable thread support. Defaults to enabled.</dd>
+<dt><strong>-</strong><strong>-disable-rpath</strong></dt>
+<dd>Suppress run path flags in link lines.</dd>
+<dt><strong>-</strong><strong>-enable-athena</strong></dt>
+<dd>Build with MIT Project Athena configuration.</dd>
+<dt><strong>-</strong><strong>-disable-kdc-lookaside-cache</strong></dt>
+<dd>Disable the cache which detects client retransmits.</dd>
+<dt><strong>-</strong><strong>-disable-pkinit</strong></dt>
+<dd>Disable PKINIT plugin support.</dd>
+<dt><strong>-</strong><strong>-disable-aesni</strong></dt>
+<dd>Disable support for using AES instructions on x86 platforms.</dd>
+<dt><strong>-</strong><strong>-enable-asan</strong>[=<em>ARG</em>]</dt>
+<dd>Enable building with asan memory error checking. If <em>ARG</em> is
+given, it controls the -fsanitize compilation flag value (the
+default is &#8220;address&#8221;).</dd>
+</dl>
+</div>
+<div class="section" id="optional-packages">
+<h2>Optional packages<a class="headerlink" href="#optional-packages" title="Permalink to this headline">¶</a></h2>
+<dl class="docutils">
+<dt><strong>-</strong><strong>-with-</strong><em>PACKAGE</em>[=ARG]</dt>
+<dd>Use <em>PACKAGE</em> (e.g., <tt class="docutils literal"><span class="pre">--with-imap</span></tt>). The default value of <em>ARG</em>
+is <tt class="docutils literal"><span class="pre">yes</span></tt>.</dd>
+<dt><strong>-</strong><strong>-without-</strong><em>PACKAGE</em></dt>
+<dd>Do not use <em>PACKAGE</em> (same as <tt class="docutils literal"><span class="pre">--with-PACKAGE=no</span></tt>)
+(e.g., <tt class="docutils literal"><span class="pre">--without-libedit</span></tt>).</dd>
+<dt><strong>-</strong><strong>-with-size-optimizations</strong></dt>
+<dd>Enable a few optimizations to reduce code size possibly at some
+run-time cost.</dd>
+<dt><strong>-</strong><strong>-with-system-et</strong></dt>
+<dd>Use the com_err library and compile_et utility that are already
+installed on the system, instead of building and installing
+local versions.</dd>
+<dt><strong>-</strong><strong>-with-system-ss</strong></dt>
+<dd>Use the ss library and mk_cmds utility that are already installed
+on the system, instead of building and using private versions.</dd>
+<dt><strong>-</strong><strong>-with-system-db</strong></dt>
+<dd>Use the berkeley db utility already installed on the system,
+instead of using a private version. This option is not
+recommended; enabling it may result in incompatibility with key
+databases originating on other systems.</dd>
+<dt><strong>-</strong><strong>-with-netlib=</strong><em>LIBS</em></dt>
+<dd>Use the resolver library specified in <em>LIBS</em>. Use this variable
+if the C library resolver is insufficient or broken.</dd>
+<dt><strong>-</strong><strong>-with-hesiod=</strong><em>path</em></dt>
+<dd>Compile with Hesiod support. The <em>path</em> points to the Hesiod
+directory. By default Hesiod is unsupported.</dd>
+<dt><strong>-</strong><strong>-with-ldap</strong></dt>
+<dd>Compile OpenLDAP database backend module.</dd>
+<dt><strong>-</strong><strong>-with-tcl=</strong><em>path</em></dt>
+<dd>Specifies that <em>path</em> is the location of a Tcl installation.
+Tcl is needed for some of the tests run by &#8216;make check&#8217;; such tests
+will be skipped if this option is not set.</dd>
+<dt><strong>-</strong><strong>-with-vague-errors</strong></dt>
+<dd>Do not send helpful errors to client. For example, if the KDC
+should return only vague error codes to clients.</dd>
+<dt><strong>-</strong><strong>-with-crypto-impl=</strong><em>IMPL</em></dt>
+<dd>Use specified crypto implementation (e.g., <strong>-</strong><strong>-with-crypto-impl=</strong><em>openssl</em>). The default is the native MIT
+Kerberos implementation <tt class="docutils literal"><span class="pre">builtin</span></tt>. The other currently
+implemented crypto backend is <tt class="docutils literal"><span class="pre">openssl</span></tt>. (See
+<a class="reference internal" href="../mitK5features.html#mitk5features"><em>MIT Kerberos features</em></a>)</dd>
+<dt><strong>-</strong><strong>-with-prng-alg=</strong><em>ALG</em></dt>
+<dd>Use specified PRNG algorithm. For example, to use the OS native
+prng specify <tt class="docutils literal"><span class="pre">--with-prng-alg=os</span></tt>. The default is <tt class="docutils literal"><span class="pre">fortuna</span></tt>.
+(See <a class="reference internal" href="../mitK5features.html#mitk5features"><em>MIT Kerberos features</em></a>)</dd>
+<dt><strong>-</strong><strong>-with-pkinit-crypto-impl=</strong><em>IMPL</em></dt>
+<dd>Use the specified pkinit crypto implementation <em>IMPL</em>.
+Defaults to using OpenSSL.</dd>
+<dt><strong>-</strong><strong>-without-libedit</strong></dt>
+<dd>Do not compile and link against libedit. Some utilities will no
+longer offer command history or completion in interactive mode if
+libedit is disabled.</dd>
+<dt><strong>-</strong><strong>-with-readline</strong></dt>
+<dd>Compile and link against GNU readline, as an alternative to libedit.
+Building with readline breaks the dejagnu test suite, which is a
+subset of the tests run by &#8216;make check&#8217;.</dd>
+<dt><strong>-</strong><strong>-with-system-verto</strong></dt>
+<dd><p class="first">Use an installed version of libverto. If the libverto header and
+library are not in default locations, you may wish to specify
+<tt class="docutils literal"><span class="pre">CPPFLAGS=-I/some/dir</span></tt> and <tt class="docutils literal"><span class="pre">LDFLAGS=-L/some/other/dir</span></tt> options
+at configuration time as well.</p>
+<p>If this option is not given, the build system will try to detect
+an installed version of libverto and use it if it is found.
+Otherwise, a version supplied with the Kerberos sources will be
+built and installed. The built-in version does not contain the
+full set of back-end modules and is not a suitable general
+replacement for the upstream version, but will work for the
+purposes of Kerberos.</p>
+<p class="last">Specifying <strong>-</strong><strong>-without-system-verto</strong> will cause the built-in
+version of libverto to be used unconditionally.</p>
+</dd>
+<dt><strong>-</strong><strong>-with-krb5-config=</strong><em>PATH</em></dt>
+<dd>Use the krb5-config program at <em>PATH</em> to obtain the build-time
+default credential cache, keytab, and client keytab names. The
+default is to use <tt class="docutils literal"><span class="pre">krb5-config</span></tt> from the program path. Specify
+<tt class="docutils literal"><span class="pre">--without-krb5-config</span></tt> to disable the use of krb5-config and
+use the usual built-in defaults.</dd>
+</dl>
+</div>
+<div class="section" id="examples">
+<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
+<p>For example, in order to configure Kerberos on a Solaris machine using
+the suncc compiler with the optimizer turned on, run the configure
+script with the following options:</p>
+<div class="highlight-python"><div class="highlight"><pre>% ./configure CC=suncc CFLAGS=-O
+</pre></div>
+</div>
+<p>For a slightly more complicated example, consider a system where
+several packages to be used by Kerberos are installed in
+<tt class="docutils literal"><span class="pre">/usr/foobar</span></tt>, including Berkeley DB 3.3, and an ss library that
+needs to link against the curses library. The configuration of
+Kerberos might be done thus:</p>
+<div class="highlight-python"><div class="highlight"><pre>./configure CPPFLAGS=-I/usr/foobar/include LDFLAGS=-L/usr/foobar/lib \
+--with-system-et --with-system-ss --with-system-db \
+SS_LIB=&#39;-lss -lcurses&#39; DB_HEADER=db3/db_185.h DB_LIB=-ldb-3.3
+</pre></div>
+</div>
+</div>
+</div>
+
+
+ </div>
+ </div>
+ </div>
+ </div>
+ <div class="sidebar">
+ <h2>On this page</h2>
+ <ul>
+<li><a class="reference internal" href="#">Options to <em>configure</em></a><ul>
+<li><a class="reference internal" href="#most-commonly-used-options">Most commonly used options</a></li>
+<li><a class="reference internal" href="#environment-variables">Environment variables</a></li>
+<li><a class="reference internal" href="#fine-tuning-of-the-installation-directories">Fine tuning of the installation directories</a></li>
+<li><a class="reference internal" href="#program-names">Program names</a></li>
+<li><a class="reference internal" href="#system-types">System types</a></li>
+<li><a class="reference internal" href="#optional-features">Optional features</a></li>
+<li><a class="reference internal" href="#optional-packages">Optional packages</a></li>
+<li><a class="reference internal" href="#examples">Examples</a></li>
+</ul>
+</li>
+</ul>
+
+ <br/>
+ <h2>Table of contents</h2>
+ <ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../user/index.html">For users</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../admin/index.html">For administrators</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../appdev/index.html">For application developers</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../plugindev/index.html">For plugin module developers</a></li>
+<li class="toctree-l1 current"><a class="reference internal" href="index.html">Building Kerberos V5</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="directory_org.html">Organization of the source directory</a></li>
+<li class="toctree-l2"><a class="reference internal" href="doing_build.html">Doing the build</a></li>
+<li class="toctree-l2 current"><a class="current reference internal" href="">Options to <em>configure</em></a><ul class="simple">
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="osconf.html">osconf.hin</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../basic/index.html">Kerberos V5 concepts</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../formats/index.html">Protocols and file formats</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../mitK5features.html">MIT Kerberos features</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../build_this.html">How to build this documentation from the source</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../about.html">Contributing to the MIT Kerberos Documentation</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../resources.html">Resources</a></li>
+</ul>
+
+ <br/>
+ <h4><a href="../index.html">Full Table of Contents</a></h4>
+ <h4>Search</h4>
+ <form class="search" action="../search.html" method="get">
+ <input type="text" name="q" size="18" />
+ <input type="submit" value="Go" />
+ <input type="hidden" name="check_keywords" value="yes" />
+ <input type="hidden" name="area" value="default" />
+ </form>
+ </div>
+ <div class="clearer"></div>
+ </div>
+ </div>
+
+ <div class="footer-wrapper">
+ <div class="footer" >
+ <div class="right" ><i>Release: 1.15.1</i><br />
+ &copy; <a href="../copyright.html">Copyright</a> 1985-2017, MIT.
+ </div>
+ <div class="left">
+
+ <a href="../index.html" title="Full Table of Contents"
+ >Contents</a> |
+ <a href="doing_build.html" title="Doing the build"
+ >previous</a> |
+ <a href="osconf.html" title="osconf.hin"
+ >next</a> |
+ <a href="../genindex.html" title="General Index"
+ >index</a> |
+ <a href="../search.html" title="Enter search criteria"
+ >Search</a> |
+ <a href="mailto:krb5-bugs@mit.edu?subject=Documentation__Options to <em>configure</em>">feedback</a>
+ </div>
+ </div>
+ </div>
+
+ </body>
+</html> \ No newline at end of file