diff options
Diffstat (limited to 'doc/html/build/options2configure.html')
| -rw-r--r-- | doc/html/build/options2configure.html | 491 |
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 — 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’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’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’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’s for +use with the operating system’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<lib</span> <span class="pre">dir></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<library></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 ‘Yet Another C Compiler’ implementation to use. Defaults to +the first program found out of: ‘<cite>bison -y</cite>‘, ‘<cite>byacc</cite>‘, +‘<cite>yacc</cite>‘.</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 “build” 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 –enable/–with options.</dd> +<dt><strong>-</strong><strong>-disable-</strong><em>FEATURE</em></dt> +<dd>Do not include <em>FEATURE</em> (same as –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’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 “address”).</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 ‘make check’; 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 ‘make check’.</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='-lss -lcurses' 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 /> + © <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 |