<!DOCTYPE html> <!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]--> <!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]--> <head> <meta charset="utf-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <title>Building and using Cyrus SASL on Mac OS X — Cyrus SASL 2.1.27 documentation</title> <link rel="shortcut icon" href="../_static/favicon.ico"/> <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" /> <link rel="stylesheet" href="../_static/cyrus.css" type="text/css" /> <link rel="index" title="Index" href="../genindex.html"/> <link rel="search" title="Search" href="../search.html"/> <link rel="top" title="Cyrus SASL 2.1.27 documentation" href="../index.html"/> <link rel="up" title="Installation" href="installation.html"/> <link rel="next" title="Building Cyrus SASL on Windows" href="windows.html"/> <link rel="prev" title="Cyrus SASL Developer Guide" href="developer/installation.html"/> </head> <body class="wy-body-for-nav" role="document"> <div class="pageheader"> <ul> <li><a href="../index.html">Home</a></li> <li><a href="http://www.cyrusimap.org">Cyrus IMAP</a></li> <li><a href="../download.html">Download</a></li> <li><a href="../contribute.html">Contribute</a></li> </ul> <div> <a href="../index.html"> <img src="../_static/logo.gif" alt="CYRUS SASL" /> </a> </div> </div> <div style="clear: both;"></div> <div class="wy-grid-for-nav"> <nav data-toggle="wy-nav-shift" class="wy-nav-side"> <div class="wy-side-nav-search"> <a href="../index.html"> <img src="../_static/logo.gif" /> </a> <div role="search"> <form id="rtd-search-form" class="wy-form" action="../search.html" method="get"> <input type="text" name="q" placeholder="Search docs" /> <input type="hidden" name="check_keywords" value="yes" /> <input type="hidden" name="area" value="default" /> </form> </div> </div> <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation"> <p class="caption"><span class="caption-text">Cyrus SASL</span></p> <ul> <li class="toctree-l1"><a class="reference internal" href="../download.html">Download</a><ul> <li class="toctree-l2"><a class="reference internal" href="../getsasl.html">Get SASL</a><ul> <li class="toctree-l3"><a class="reference internal" href="installation.html">Installation</a><ul> <li class="toctree-l4"><a class="reference internal" href="installation.html#quick-install-guide">Quick install guide</a></li> <li class="toctree-l4"><a class="reference internal" href="installation.html#detailed-installation-guide">Detailed installation guide</a></li> <li class="toctree-l4"><a class="reference internal" href="installation.html#supported-platforms">Supported platforms</a></li> </ul> </li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="release-notes/index.html">Release Notes</a><ul> <li class="toctree-l3"><a class="reference internal" href="release-notes/index.html#supported-product-series">Supported Product Series</a><ul> <li class="toctree-l4"><a class="reference internal" href="release-notes/index.html#series-2-1">Series 2.1</a></li> </ul> </li> <li class="toctree-l3"><a class="reference internal" href="release-notes/index.html#older-versions">Older Versions</a><ul> <li class="toctree-l4"><a class="reference internal" href="release-notes/index.html#series-2-2-0">Series 2: 2.0</a></li> <li class="toctree-l4"><a class="reference internal" href="release-notes/index.html#series-1">Series 1</a></li> </ul> </li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="../packager.html">Note for Packagers</a></li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="quickstart.html">Quickstart guide</a><ul> <li class="toctree-l2"><a class="reference internal" href="quickstart.html#features">Features</a></li> <li class="toctree-l2"><a class="reference internal" href="quickstart.html#typical-installation">Typical Installation</a></li> <li class="toctree-l2"><a class="reference internal" href="quickstart.html#configuration">Configuration</a></li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="concepts.html">Concepts</a><ul> <li class="toctree-l2"><a class="reference internal" href="concepts.html#sasl">SASL</a></li> <li class="toctree-l2"><a class="reference internal" href="concepts.html#sasl-authentication-mechanisms">SASL Authentication Mechanisms</a></li> <li class="toctree-l2"><a class="reference internal" href="concepts.html#security-layers">Security Layers</a></li> <li class="toctree-l2"><a class="reference internal" href="concepts.html#channel-binding">Channel Binding</a></li> <li class="toctree-l2"><a class="reference internal" href="concepts.html#realms">Realms</a></li> <li class="toctree-l2"><a class="reference internal" href="concepts.html#protocols">Protocols</a></li> <li class="toctree-l2"><a class="reference internal" href="concepts.html#cyrus-sasl">Cyrus SASL</a></li> <li class="toctree-l2"><a class="reference internal" href="concepts.html#the-glue-library">The Glue Library</a></li> <li class="toctree-l2"><a class="reference internal" href="concepts.html#auxiliary-properties">Auxiliary Properties</a></li> <li class="toctree-l2"><a class="reference internal" href="concepts.html#plugins">Plugins</a></li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="../setup.html">Setup</a><ul> <li class="toctree-l2"><a class="reference internal" href="installation.html">Installation</a><ul> <li class="toctree-l3"><a class="reference internal" href="installation.html#quick-install-guide">Quick install guide</a><ul> <li class="toctree-l4"><a class="reference internal" href="installation.html#tarball-installation">Tarball installation</a></li> <li class="toctree-l4"><a class="reference internal" href="installation.html#unix-package-installation">Unix package Installation</a></li> <li class="toctree-l4"><a class="reference internal" href="installation.html#configuration">Configuration</a></li> </ul> </li> <li class="toctree-l3"><a class="reference internal" href="installation.html#detailed-installation-guide">Detailed installation guide</a><ul> <li class="toctree-l4"><a class="reference internal" href="installation.html#requirements">Requirements</a></li> <li class="toctree-l4"><a class="reference internal" href="installation.html#build-configuration">Build Configuration</a></li> <li class="toctree-l4"><a class="reference internal" href="installation.html#building-and-installation">Building and Installation</a></li> <li class="toctree-l4"><a class="reference internal" href="installation.html#compilation-hints">Compilation Hints</a></li> <li class="toctree-l4"><a class="reference internal" href="installation.html#application-configuration">Application Configuration</a></li> </ul> </li> <li class="toctree-l3"><a class="reference internal" href="installation.html#supported-platforms">Supported platforms</a></li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="upgrading.html">Upgrading from v1 to v2</a><ul> <li class="toctree-l3"><a class="reference internal" href="upgrading.html#backwards-compatibility">Backwards Compatibility</a></li> <li class="toctree-l3"><a class="reference internal" href="upgrading.html#coexistence-with-saslv1">Coexistence with SASLv1</a></li> <li class="toctree-l3"><a class="reference internal" href="upgrading.html#database-upgrades">Database Upgrades</a></li> <li class="toctree-l3"><a class="reference internal" href="upgrading.html#errors-on-migration">Errors on migration</a></li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="components.html">Components</a><ul> <li class="toctree-l3"><a class="reference internal" href="components.html#the-application">The Application</a></li> <li class="toctree-l3"><a class="reference internal" href="components.html#the-sasl-glue-layer">The SASL Glue Layer</a></li> <li class="toctree-l3"><a class="reference internal" href="components.html#plugins">Plugins</a><ul> <li class="toctree-l4"><a class="reference internal" href="components.html#plugins-general">Plugins: General</a></li> <li class="toctree-l4"><a class="reference internal" href="components.html#plugins-sasl-mechanisms">Plugins: SASL Mechanisms</a></li> <li class="toctree-l4"><a class="reference internal" href="components.html#plugins-auxiliary-property">Plugins: Auxiliary Property</a></li> <li class="toctree-l4"><a class="reference internal" href="components.html#plugins-username-canonicalization">Plugins: Username Canonicalization</a></li> </ul> </li> <li class="toctree-l3"><a class="reference internal" href="components.html#password-verification-services">Password Verification Services</a></li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="options.html">Options</a><ul> <li class="toctree-l3"><a class="reference internal" href="options.html#sasl-library">SASL Library</a></li> <li class="toctree-l3"><a class="reference internal" href="options.html#auxiliary-property-plugin">Auxiliary Property Plugin</a></li> <li class="toctree-l3"><a class="reference internal" href="options.html#gssapi">GSSAPI</a></li> <li class="toctree-l3"><a class="reference internal" href="options.html#ldapdb">LDAPDB</a><ul> <li class="toctree-l4"><a class="reference internal" href="options.html#notes-on-ldapdb">Notes on LDAPDB</a></li> <li class="toctree-l4"><a class="reference internal" href="options.html#examples">Examples</a></li> </ul> </li> <li class="toctree-l3"><a class="reference internal" href="options.html#ntlm">NTLM</a></li> <li class="toctree-l3"><a class="reference internal" href="options.html#otp">OTP</a></li> <li class="toctree-l3"><a class="reference internal" href="options.html#digest-md5">Digest-md5</a></li> <li class="toctree-l3"><a class="reference internal" href="options.html#sasldb">SASLDB</a><ul> <li class="toctree-l4"><a class="reference internal" href="options.html#notes-on-sasldb-with-lmdb">Notes on sasldb with LMDB</a></li> </ul> </li> <li class="toctree-l3"><a class="reference internal" href="options.html#sql-plugin">SQL Plugin</a><ul> <li class="toctree-l4"><a class="reference internal" href="options.html#notes-on-sql">Notes on SQL</a></li> <li class="toctree-l4"><a class="reference internal" href="options.html#id2">Examples</a></li> </ul> </li> <li class="toctree-l3"><a class="reference internal" href="options.html#srp">SRP</a></li> <li class="toctree-l3"><a class="reference internal" href="options.html#kerberos-v4">Kerberos V4</a></li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="advanced.html">Advanced Usage</a><ul> <li class="toctree-l3"><a class="reference internal" href="advanced.html#notes-for-advanced-usage-of-libsasl">Notes for Advanced Usage of libsasl</a><ul> <li class="toctree-l4"><a class="reference internal" href="advanced.html#using-cyrus-sasl-as-a-static-library">Using Cyrus SASL as a static library</a></li> </ul> </li> </ul> </li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="../operations.html">Operations</a><ul> <li class="toctree-l2"><a class="reference internal" href="sysadmin.html">System Administrators</a><ul> <li class="toctree-l3"><a class="reference internal" href="sysadmin.html#what-sasl-is">What SASL is</a><ul> <li class="toctree-l4"><a class="reference internal" href="sysadmin.html#authentication-and-authorization-identifiers">Authentication and authorization identifiers</a></li> <li class="toctree-l4"><a class="reference internal" href="sysadmin.html#realms">Realms</a></li> </ul> </li> <li class="toctree-l3"><a class="reference internal" href="sysadmin.html#how-sasl-works">How SASL works</a><ul> <li class="toctree-l4"><a class="reference internal" href="sysadmin.html#the-plain-mechanism-sasl-checkpass-and-plaintext-passwords">The PLAIN mechanism, <code class="docutils literal"><span class="pre">sasl_checkpass()</span></code>, and plaintext passwords</a></li> <li class="toctree-l4"><a class="reference internal" href="sysadmin.html#shared-secrets-mechanisms">Shared secrets mechanisms</a></li> <li class="toctree-l4"><a class="reference internal" href="sysadmin.html#kerberos-mechanisms">Kerberos mechanisms</a></li> <li class="toctree-l4"><a class="reference internal" href="sysadmin.html#the-otp-mechanism">The OTP mechanism</a></li> </ul> </li> <li class="toctree-l3"><a class="reference internal" href="sysadmin.html#auxiliary-properties">Auxiliary Properties</a></li> <li class="toctree-l3"><a class="reference internal" href="sysadmin.html#how-to-set-configuration-options">How to set configuration options</a><ul> <li class="toctree-l4"><a class="reference internal" href="sysadmin.html#the-default-configuration-file">The default configuration file</a></li> <li class="toctree-l4"><a class="reference internal" href="sysadmin.html#application-configuration">Application configuration</a></li> </ul> </li> <li class="toctree-l3"><a class="reference internal" href="sysadmin.html#troubleshooting">Troubleshooting</a></li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="manpages.html">Man pages</a><ul> <li class="toctree-l3"><a class="reference internal" href="manpages.html#library-files">(3) Library Files</a><ul> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl.html"><strong>SASL</strong> - SASL Authentication Library</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_authorize_t.html"><strong>sasl_authorize_t</strong> - The SASL authorization callback</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_auxprop.html"><strong>sasl_auxprop</strong> - How to work with SASL auxiliary properties</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_auxprop_add_plugin.html"><strong>sasl_auxprop_add_plugin</strong> - add a SASL auxiliary property plugin</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_auxprop_getctx.html"><strong>sasl_auxprop_getctx</strong> - Acquire an auxiliary property context</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_auxprop_request.html"><strong>sasl_auxprop_request</strong> - Request auxiliary properties from SASL</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_callbacks.html"><strong>sasl_callbacks</strong> - How to work with SASL callbacks</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_canon_user_t.html"><strong>sasl_canon_user_t</strong> - Application-supplied user canonicalization function</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_canonuser_add_plugin.html"><strong>sasl_canonuser_add_plugin</strong> - add a SASL user canonicalization plugin</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_chalprompt_t.html"><strong>sasl_chalprompt_t</strong> - Realm acquisition callback</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_checkapop.html"><strong>sasl_checkapop</strong> - Check an APOP challenge/response</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_checkpass.html"><strong>sasl_checkpass</strong> - Check a plaintext password</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_client_add_plugin.html"><strong>sasl_client_add_plugin</strong> - add a SASL client plugin</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_client_done.html"><strong>sasl_client_done</strong> - Cleanup function</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_client_init.html"><strong>sasl_client_init</strong> - SASL client authentication initialization</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_client_new.html"><strong>sasl_client_new</strong> - Create a new client authentication object</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_client_plug_init_t.html"><strong>sasl_client_plug_init_t</strong> - client plug‐in entry point</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_client_start.html"><strong>sasl_client_start</strong> - Begin an authentication negotiation</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_client_step.html"><strong>sasl_client_step</strong> - Perform a step in the authentication negotiation</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_decode.html"><strong>sasl_decode</strong> - Decode data received</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_decode64.html"><strong>sasl_decode64</strong> - Decode base64 string</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_dispose.html"><strong>sasl_dispose</strong> - Dispose of a SASL connection object</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_done.html"><strong>sasl_done</strong> - Dispose of a SASL connection object</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_encode.html"><strong>sasl_encode</strong> - Encode data for transport to authenticated host</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_encode64.html"><strong>sasl_encode64</strong> - Encode base64 string</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_encodev.html"><strong>sasl_encodev</strong> - Encode data for transport to authenticated host</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_erasebuffer.html"><strong>sasl_erasebuffer</strong> - erase buffer</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_errdetail.html"><strong>sasl_errdetail</strong> - Retrieve detailed information about an error</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_errors.html"><strong>sasl_errors</strong> - SASL error codes</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_errstring.html"><strong>sasl_errstring</strong> - Translate a SASL return code to a human-readable form</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_getcallback_t.html"><strong>sasl_getcallback_t</strong> - callback function to lookup a sasl_callback_t for a connection</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_getconfpath_t.html"><strong>sasl_getconfpath_t</strong> - The SASL callback to indicate location of the config files</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_getopt_t.html"><strong>sasl_getopt_t</strong> - The SASL get option callback</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_getpath_t.html"><strong>sasl_getpath_t</strong> - The SASL callback to indicate location of the mechanism drivers</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_getprop.html"><strong>sasl_getprop</strong> - Get a SASL property</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_getrealm_t.html"><strong>sasl_getrealm_t</strong> - Realm Acquisition Callback</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_getsecret_t.html"><strong>sasl_getsecret_t</strong> - The SASL callback for secrets (passwords)</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_getsimple_t.html"><strong>sasl_getsimple_t</strong> - The SASL callback for username/authname/realm</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_global_listmech.html"><strong>sasl_global_listmech</strong> - Retrieve a list of the supported SASL mechanisms</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_idle.html"><strong>sasl_idle</strong> - Perform precalculations during an idle period</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_listmech.html"><strong>sasl_listmech</strong> - Retrieve a list of the supported SASL mechanisms</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_log_t.html"><strong>sasl_log_t</strong> - The SASL logging callback</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_server_add_plugin.html"><strong>sasl_server_add_plugin</strong> - add a SASL server plugin</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_server_done.html"><strong>sasl_server_done</strong> - Cleanup function</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_server_init.html"><strong>sasl_server_init</strong> - SASL server authentication initialization</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_server_new.html"><strong>sasl_server_new</strong> - Create a new server authentication object</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_server_plug_init_t.html"><strong>sasl_server_plug_init_t</strong> - server plug‐in entry point</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_server_start.html"><strong>sasl_server_start</strong> - Begin an authentication negotiation</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_server_step.html"><strong>sasl_server_step</strong> - Perform a step in the authentication negotiation</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_server_userdb_checkpass_t.html"><strong>sasl_server_userdb_checkpass_t</strong> - Plaintext Password Verification Callback</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_server_userdb_setpass_t.html"><strong>sasl_server_userdb_setpass_t</strong> - UserDB Plaintext Password Setting Callback</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_set_alloc.html"><strong>sasl_set_alloc</strong> - set the memory allocation functions used by the SASL library</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_set_mutex.html"><strong>sasl_set_mutex</strong> - set the mutex lock functions used by the SASL library</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_seterror.html"><strong>sasl_seterror</strong> - set the error string</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_setpass.html"><strong>sasl_setpass</strong> - Check a plaintext password</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_setprop.html"><strong>sasl_setprop</strong> - Set a SASL property</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_user_exists.html"><strong>sasl_user_exists</strong> - Check if a user exists on server</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_usererr.html"><strong>sasl_usererr</strong> - Remove information leak about accounts from sasl error codes</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_utf8verify.html"><strong>sasl_utf8verify</strong> - Verify a string is valid utf8</a></li> <li class="toctree-l4"><a class="reference internal" href="reference/manpages/library/sasl_verifyfile_t.html"><strong>sasl_verifyfile_t</strong> - The SASL file verification</a></li> </ul> </li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="auxiliary_properties.html">Auxiliary Properties</a><ul> <li class="toctree-l3"><a class="reference internal" href="auxiliary_properties.html#auxiliary-properties-and-the-glue-layer">Auxiliary Properties and the Glue Layer</a></li> <li class="toctree-l3"><a class="reference internal" href="auxiliary_properties.html#passwords-and-other-data">Passwords and other Data</a></li> <li class="toctree-l3"><a class="reference internal" href="auxiliary_properties.html#sasldb">sasldb</a></li> <li class="toctree-l3"><a class="reference internal" href="auxiliary_properties.html#ldapdb">ldapdb</a></li> <li class="toctree-l3"><a class="reference internal" href="auxiliary_properties.html#sql">sql</a></li> <li class="toctree-l3"><a class="reference internal" href="auxiliary_properties.html#user-canonicalization">User Canonicalization</a></li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="authentication_mechanisms.html">Authentication Mechanisms</a><ul> <li class="toctree-l3"><a class="reference internal" href="authentication_mechanisms.html#mechanisms">Mechanisms</a><ul> <li class="toctree-l4"><a class="reference internal" href="authentication_mechanisms.html#anonymous">ANONYMOUS</a></li> <li class="toctree-l4"><a class="reference internal" href="authentication_mechanisms.html#cram-md5">CRAM-MD5</a></li> <li class="toctree-l4"><a class="reference internal" href="authentication_mechanisms.html#digest-md5">DIGEST-MD5</a></li> <li class="toctree-l4"><a class="reference internal" href="authentication_mechanisms.html#external">EXTERNAL</a></li> <li class="toctree-l4"><a class="reference internal" href="authentication_mechanisms.html#g2">G2</a></li> <li class="toctree-l4"><a class="reference internal" href="authentication_mechanisms.html#gssapi">GSSAPI</a></li> <li class="toctree-l4"><a class="reference internal" href="authentication_mechanisms.html#gss-spegno">GSS-SPEGNO</a></li> <li class="toctree-l4"><a class="reference internal" href="authentication_mechanisms.html#kerberos-v4">KERBEROS_V4</a></li> <li class="toctree-l4"><a class="reference internal" href="authentication_mechanisms.html#login">LOGIN</a></li> <li class="toctree-l4"><a class="reference internal" href="authentication_mechanisms.html#ntlm">NTLM</a></li> <li class="toctree-l4"><a class="reference internal" href="authentication_mechanisms.html#otp">OTP</a></li> <li class="toctree-l4"><a class="reference internal" href="authentication_mechanisms.html#passdss">PASSDSS</a></li> <li class="toctree-l4"><a class="reference internal" href="authentication_mechanisms.html#plain">PLAIN</a></li> <li class="toctree-l4"><a class="reference internal" href="authentication_mechanisms.html#scram">SCRAM</a></li> <li class="toctree-l4"><a class="reference internal" href="authentication_mechanisms.html#srp">SRP</a></li> <li class="toctree-l4"><a class="reference internal" href="authentication_mechanisms.html#non-sasl-authentication">Non-SASL Authentication</a></li> </ul> </li> <li class="toctree-l3"><a class="reference internal" href="authentication_mechanisms.html#summary">Summary</a></li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="pwcheck.html">Pwcheck</a><ul> <li class="toctree-l3"><a class="reference internal" href="pwcheck.html#auxprop">Auxprop</a></li> <li class="toctree-l3"><a class="reference internal" href="pwcheck.html#auxprop-hashed">Auxprop-hashed</a></li> <li class="toctree-l3"><a class="reference internal" href="pwcheck.html#saslauthd">Saslauthd</a></li> <li class="toctree-l3"><a class="reference internal" href="pwcheck.html#authdaemon">Authdaemon</a></li> <li class="toctree-l3"><a class="reference internal" href="pwcheck.html#alwaystrue">Alwaystrue</a></li> <li class="toctree-l3"><a class="reference internal" href="pwcheck.html#auto-transition">Auto Transition</a></li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="faq.html">Frequently Asked Questions</a><ul> <li class="toctree-l3"><a class="reference internal" href="faqs/authorize-vs-authenticate.html">What is the difference between an Authorization ID and a Authentication ID?</a></li> <li class="toctree-l3"><a class="reference internal" href="faqs/crammd5-digestmd5.html">Why do CRAM-MD5 and DIGEST-MD5 not work with CyrusSaslauthd?</a></li> <li class="toctree-l3"><a class="reference internal" href="faqs/openldap-sasl-gssapi.html">How do I configure OpenLDAP +SASL+GSSAPI?</a></li> <li class="toctree-l3"><a class="reference internal" href="faqs/plaintextpasswords.html">Why does CyrusSasl store plaintext passwords in its databases?</a></li> <li class="toctree-l3"><a class="reference internal" href="faqs/rfcs.html">RFCs and drafts</a></li> <li class="toctree-l3"><a class="reference internal" href="faqs/upgrade-saslv2.html">Why am I having a problem running dbconverter-2 to upgrade from SASLv1 to SASLv2?</a></li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="resources.html">Other Documentation & Resources</a></li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="../developer.html">Developers</a><ul> <li class="toctree-l2"><a class="reference internal" href="appconvert.html">Converting Applications from v1 to v2</a><ul> <li class="toctree-l3"><a class="reference internal" href="appconvert.html#tips-for-both-clients-and-servers">Tips for both clients and servers</a></li> <li class="toctree-l3"><a class="reference internal" href="appconvert.html#tips-for-clients">Tips for clients</a></li> <li class="toctree-l3"><a class="reference internal" href="appconvert.html#tips-for-servers">Tips for Servers</a></li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="developer/programming.html">Application Programmer’s Guide</a><ul> <li class="toctree-l3"><a class="reference internal" href="developer/programming.html#introduction">Introduction</a><ul> <li class="toctree-l4"><a class="reference internal" href="developer/programming.html#about-this-guide">About this Guide</a></li> <li class="toctree-l4"><a class="reference internal" href="developer/programming.html#what-is-sasl">What is SASL?</a></li> </ul> </li> <li class="toctree-l3"><a class="reference internal" href="developer/programming.html#background">Background</a><ul> <li class="toctree-l4"><a class="reference internal" href="developer/programming.html#how-did-the-world-work-before-sasl">How did the world work before SASL?</a></li> <li class="toctree-l4"><a class="reference internal" href="developer/programming.html#sasl-to-the-rescue">SASL to the rescue!</a></li> </ul> </li> <li class="toctree-l3"><a class="reference internal" href="developer/programming.html#briefly">Briefly</a><ul> <li class="toctree-l4"><a class="reference internal" href="developer/programming.html#what-is-the-cyrus-sasl-library-good-for">What is the Cyrus SASL library good for?</a></li> <li class="toctree-l4"><a class="reference internal" href="developer/programming.html#what-does-the-cyrus-sasl-library-do">What does the Cyrus SASL library do?</a></li> <li class="toctree-l4"><a class="reference internal" href="developer/programming.html#what-doesn-t-the-cyrus-sasl-library-do">What doesn’t the Cyrus SASL library do?</a></li> </ul> </li> <li class="toctree-l3"><a class="reference internal" href="developer/programming.html#client-only-section">Client-only Section</a><ul> <li class="toctree-l4"><a class="reference internal" href="developer/programming.html#a-typical-interaction-from-the-client-s-perspective">A typical interaction from the client’s perspective</a></li> <li class="toctree-l4"><a class="reference internal" href="developer/programming.html#how-does-this-look-in-code">How does this look in code</a></li> </ul> </li> <li class="toctree-l3"><a class="reference internal" href="developer/programming.html#server-only-section">Server-only Section</a><ul> <li class="toctree-l4"><a class="reference internal" href="developer/programming.html#a-typical-interaction-from-the-server-s-perspective">A typical interaction from the server’s perspective</a></li> <li class="toctree-l4"><a class="reference internal" href="developer/programming.html#id1">How does this look in code?</a></li> </ul> </li> <li class="toctree-l3"><a class="reference internal" href="developer/programming.html#common-section">Common Section</a><ul> <li class="toctree-l4"><a class="reference internal" href="developer/programming.html#callbacks-and-interactions">Callbacks and Interactions</a></li> <li class="toctree-l4"><a class="reference internal" href="developer/programming.html#security-layers">Security layers</a></li> </ul> </li> <li class="toctree-l3"><a class="reference internal" href="developer/programming.html#example-applications-that-come-with-the-cyrus-sasl-library">Example applications that come with the Cyrus SASL library</a><ul> <li class="toctree-l4"><a class="reference internal" href="developer/programming.html#sample-client-and-sample-server"><cite>sample-client</cite> and <cite>sample-server</cite></a></li> <li class="toctree-l4"><a class="reference internal" href="developer/programming.html#cyrus-imapd-v2-1-0-or-later">Cyrus imapd v2.1.0 or later</a></li> <li class="toctree-l4"><a class="reference internal" href="developer/programming.html#imtest-from-cyrus-2-1-0-or-later"><cite>imtest</cite>, from Cyrus 2.1.0 or later</a></li> </ul> </li> <li class="toctree-l3"><a class="reference internal" href="developer/programming.html#miscellaneous-information">Miscellaneous Information</a><ul> <li class="toctree-l4"><a class="reference internal" href="developer/programming.html#empty-exchanges">Empty exchanges</a></li> <li class="toctree-l4"><a class="reference internal" href="developer/programming.html#idle">Idle</a></li> </ul> </li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="developer/plugprog.html">Plugin Programmer’s Guide</a><ul> <li class="toctree-l3"><a class="reference internal" href="developer/plugprog.html#introduction">Introduction</a><ul> <li class="toctree-l4"><a class="reference internal" href="developer/plugprog.html#about-this-guide">About this Guide</a></li> <li class="toctree-l4"><a class="reference internal" href="developer/plugprog.html#what-is-sasl">What is SASL?</a></li> </ul> </li> <li class="toctree-l3"><a class="reference internal" href="developer/plugprog.html#common-section">Common Section</a><ul> <li class="toctree-l4"><a class="reference internal" href="developer/plugprog.html#overview-of-plugin-programming">Overview of Plugin Programming</a></li> <li class="toctree-l4"><a class="reference internal" href="developer/plugprog.html#use-of-sasl-utils-t">Use of sasl_utils_t</a></li> <li class="toctree-l4"><a class="reference internal" href="developer/plugprog.html#error-reporting">Error Reporting</a></li> <li class="toctree-l4"><a class="reference internal" href="developer/plugprog.html#memory-allocation">Memory Allocation</a></li> <li class="toctree-l4"><a class="reference internal" href="developer/plugprog.html#client-send-first-server-send-last">Client Send First / Server Send Last</a></li> </ul> </li> <li class="toctree-l3"><a class="reference internal" href="developer/plugprog.html#client-plugins">Client Plugins</a></li> <li class="toctree-l3"><a class="reference internal" href="developer/plugprog.html#server-plugins">Server Plugins</a></li> <li class="toctree-l3"><a class="reference internal" href="developer/plugprog.html#user-canonicalization-canon-user-plugins">User Canonicalization (canon_user) Plugins</a></li> <li class="toctree-l3"><a class="reference internal" href="developer/plugprog.html#auxiliary-property-auxprop-plugins">Auxiliary Property (auxprop) Plugins</a></li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="developer/testing.html">Testing</a><ul> <li class="toctree-l3"><a class="reference internal" href="developer/testing.html#testing-the-cmu-sasl-library-with-the-included-sample-applications">Testing the CMU SASL Library with the included sample applications</a><ul> <li class="toctree-l4"><a class="reference internal" href="developer/testing.html#example">Example</a></li> </ul> </li> <li class="toctree-l3"><a class="reference internal" href="developer/testing.html#running-the-testsuite-application">Running the Testsuite application</a></li> </ul> </li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="../support.html">Support/Community</a></li> </ul> <p class="caption"><span class="caption-text">IMAP</span></p> <ul> <li class="toctree-l1"><a class="reference external" href="http://www.cyrusimap.org">Cyrus IMAP</a></li> </ul> </div> </nav> <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"> <nav class="wy-nav-top" role="navigation" aria-label="top navigation"> <i data-toggle="wy-nav-top" class="fa fa-bars"></i> <a href="../index.html">Cyrus SASL</a> </nav> <div class="wy-nav-content"> <div class="rst-content"> <div role="navigation" aria-label="breadcrumbs navigation"> <ul class="wy-breadcrumbs"> <li><a href="../index.html">Docs v2.1.27</a> »</li> <li><a href="../download.html">Download</a> »</li> <li><a href="../getsasl.html">Get SASL</a> »</li> <li><a href="installation.html">Installation</a> »</li> <li>Building and using Cyrus SASL on Mac OS X</li> <li class="wy-breadcrumbs-aside"> <a href="https://github.com/cyrusimap/cyrus-sasl/blob/master/docsrc/sasl/macosx.rst" class="fa fa-github"> Edit on GitHub</a> </li> </ul> <hr/> </div> <div role="main" class="document"> <div class="section" id="building-and-using-cyrus-sasl-on-mac-os-x"> <span id="install-macos"></span><h1>Building and using Cyrus SASL on Mac OS X<a class="headerlink" href="#building-and-using-cyrus-sasl-on-mac-os-x" title="Permalink to this headline">¶</a></h1> <p>The Cyrus SASL v2 distribution now supports Mac OS X, including applications written to Apple’s Carbon and Cocoa interfaces, as well as the standard Unix-like API. It includes the following components:</p> <ul class="simple"> <li>A port of the Unix SASL library, which lives in <code class="docutils literal"><span class="pre">/usr/local/lib/libsasl2.dylib</span></code> (or similar) and with plugins in <code class="docutils literal"><span class="pre">/usr/lib/sasl</span></code> (which should be a symlink to <code class="docutils literal"><span class="pre">/usr/local/lib/sasl</span></code>).</li> <li>A framework which lives in <code class="docutils literal"><span class="pre">/Library/Frameworks/SASL2.framework</span></code>, and allows the use of the <code class="docutils literal"><span class="pre">-framework</span></code> option to Apple’s <code class="docutils literal"><span class="pre">ld</span></code>, or linking with the framework in Project Builder. This framework is in fact a wrapper for a symlink to <code class="docutils literal"><span class="pre">/usr/local/lib/libsasl2.dylib</span></code> with the necessary information to recognize it as a framework. This is what we expect many Cocoa and Carbon Mach-O applications will want to use, and the framework is required for CFBundle to work, which is used by the CFM glue library.</li> <li>A CFM glue library (<code class="docutils literal"><span class="pre">/Library/CFMSupport/SASL2GlueCFM</span></code>) which can be linked in by Carbon CFM applications, that uses CFBundle to bind the framework and thus load the Unix-level library. It automatically loads the important functions at <code class="docutils literal"><span class="pre">sasl_client_init</span></code> or <code class="docutils literal"><span class="pre">sasl_server_init</span></code> time; it also automatically makes sure memory allocation works if you’re using the metrowerks malloc; if you’re not, <code class="docutils literal"><span class="pre">sasl_set_alloc</span></code> works as usual.</li> <li>A Carbon port of the existing CFM library for Mac OS 9. Note that this could probably be modified fairly easily to work on OS X, but there’s not much point. The CFM glue layer to the Unix library supports many more functions, including the entire server API; also, the Unix implementation is mostly independent of Kerberos implementation, while the Mac OS 9 Carbon port specifically requires MIT Kerberos for Macintosh 3.5 or later in order to get Kerberos support. The Mac OS 9 code implements only the client API, but this is mostly what is wanted from SASL on OS 9 anyway.</li> </ul> <p>If you are building a Carbon CFM application and intend it to run on both OS 9 and OS X, you should link against the OS 9 Carbon SASL library, since it exports fewer APIs (client side only, specifically) than the OS X CFM glue. Your application should work seamlessly with both libraries if you do this, despite the different implementations underneath.</p> <p>If you need a Carbon CFM application to support server-side SASL functionality, you need to link against the <code class="docutils literal"><span class="pre">SASL2GlueCFM</span></code> library, but be aware that your application will not run on OS 9.</p> <div class="section" id="compiling-and-using-the-unix-library"> <h2>Compiling and Using the Unix library<a class="headerlink" href="#compiling-and-using-the-unix-library" title="Permalink to this headline">¶</a></h2> <p>The Unix library is mostly ready to build on Mac OS X, but it does depend on the <code class="docutils literal"><span class="pre">dlcompat</span></code> package in order to load its plugins. <code class="docutils literal"><span class="pre">dlcompat-20010505</span></code> is a relatively simple version known to work with SASL; it is provided with the distribution in a tarball. You should <code class="docutils literal"><span class="pre">make</span></code> and <code class="docutils literal"><span class="pre">make</span> <span class="pre">install</span></code> the <code class="docutils literal"><span class="pre">dlcompat</span></code> library (which probably goes into <code class="docutils literal"><span class="pre">/usr/local/lib/libdl.dylib</span></code>) before attempting to <code class="docutils literal"><span class="pre">./configure</span></code> the SASL distribution itself. SASL will then pretend it’s a real Unix <code class="docutils literal"><span class="pre">libdl</span></code>, and link against it.</p> <p>Since there are, at this point, newer and far more complex versions of dlcompat, you may prefer to use those instead if other software requires their functionality. The dlcompat homepage is located on the <a class="reference external" href="http://www.opendarwin.org/projects/dlcompat">OpenDarwin</a> site. Many users may want to install the <code class="docutils literal"><span class="pre">/sw</span></code> tree from <a class="reference external" href="http://fink.sourceforge.net">the Fink project</a> to get this, as well as possibly newer autotools and other software.</p> <p>As of version 2.1.16, SASL uses and requires a recent version of GNU autotools (autoconf, automake, and libtool) to build its configuration scripts. If you are building from GIT, you will need to have the autotools installed on your system. The version included with all releases of the developer tools for OS X 10.2.x is too old for this; if you aren’t using OS X 10.3 or later, you should upgrade to more recent patchlevels of these tools. The easiest way to do this is to install the Fink environment and then <code class="docutils literal"><span class="pre">apt-get</span> <span class="pre">install</span> <span class="pre">autoconf2.5</span> <span class="pre">automake1.7</span> <span class="pre">libtool14</span></code>.</p> <p>Recent versions of SASL ship with Kerberos v4 disabled by default. If you need Kerberos v4 for some reason, and you are using MIT Kerberos for Macintosh 4.0 or later, you should <code class="docutils literal"><span class="pre">./configure</span></code> with the added options <code class="docutils literal"><span class="pre">"--enable-krb4=/usr</span> <span class="pre">--without-openssl</span> <span class="pre">--disable-digest"</span></code> so that it finds the correct location for the header files, and does not use OpenSSL or build anything that depends on it (such as the digest-md5 plugin), since OpenSSL provides its own DES routines which do not work with Kerberos v4.</p> <div class="admonition warning"> <p class="first admonition-title">Warning</p> <p class="last">Please read the “Known Problems” section at the end of this document for more information on this issue.</p> </div> <p>You must be root to make install, since <code class="docutils literal"><span class="pre">/usr/local</span></code> is only modifiable by root. You need not enable the root account using NetInfo; the recommended (but underdocumented) method is to use <code class="docutils literal"><span class="pre">sudo</span> <span class="pre">-s</span></code> from the Terminal window when you are logged into an administrator’s account, and enter the password for that account. When building on Mac OS X, <code class="docutils literal"><span class="pre">make</span> <span class="pre">install</span></code> will automatically add the framework to <code class="docutils literal"><span class="pre">/Library/Frameworks</span></code>.</p> <p>This does not build the CFM glue library. Building the CFM glue library requires Metrowerks CodeWarrior Pro 6 or later (tested with 6), and the files necessary to build it are in the <code class="docutils literal"><span class="pre">mac/osx_cfm_glue</span></code> folder.</p> </div> <div class="section" id="changes-to-the-unix-library-to-make-it-work-on-os-x"> <h2>Changes to the Unix library to make it work on OS X<a class="headerlink" href="#changes-to-the-unix-library-to-make-it-work-on-os-x" title="Permalink to this headline">¶</a></h2> <p>This is provided for reference purposes only. The build system will automatically take care of all of these issues when building on Darwin or Mac OS X.</p> <ul class="simple"> <li>The random code supports the preferred way to generate random numbers in Darwin. (In SASL v2, it does this on all unix-like platforms that lack jrand48). <em>Note that Mac OS X “Jaguar”, version 10.2, now has the standard jrand48 function, and that SASL will use this instead of the previous workaround.</em></li> <li>Symbols which are dlopened have an underscore prefixed. (This behavior is detected by configure in SASL v2.)</li> <li>Plugins are linked with the <code class="docutils literal"><span class="pre">-module</span></code> option to <code class="docutils literal"><span class="pre">libtool</span></code>, which causes the <code class="docutils literal"><span class="pre">-bundle</span></code> option to be supplied to Apple’s <code class="docutils literal"><span class="pre">ld</span></code>. (This is done on all platforms in SASL v2.)</li> <li>The MD5 symbols are renamed to avoid library conflicts. This allows proper compilations against Heimdal and MIT’s unix kerberos distribution, and prevents crashes when linked against MIT Kerberos for Macintosh (which also duplicates the symbols, but in a different way). Note that the MD5 symbols have local names on all platforms with SASL v2; this was only different in SASL v1.</li> <li>MIT Kerberos for Macintosh 4.0 and later are fully supported. This was accomplished by using <code class="docutils literal"><span class="pre">krb_get_err_text</span></code> if available and checking for additional names for the krb4 libraries.</li> </ul> </div> <div class="section" id="changes-to-the-mac-os-9-projects-to-support-carbon"> <h2>Changes to the Mac OS 9 projects to support Carbon<a class="headerlink" href="#changes-to-the-mac-os-9-projects-to-support-carbon" title="Permalink to this headline">¶</a></h2> <div class="admonition warning"> <p class="first admonition-title">Warning</p> <p class="last">Please read these notes before you attempt to build SASL for OS 9 Carbon!</p> </div> <ul class="simple"> <li><strong>Important!</strong> You must make sure that all files have their correct HFS filetype before starting to build this code! In particular, all source and text files must be of type <code class="docutils literal"><span class="pre">'TEXT'</span></code>, which is not the default if you use the Mac OS X GIT client to check out the projects. If you run into this problem, you may want to use a utility such as FileTyper to recursively change the type on all files. CodeWarrior is less picky about the projects’ filetypes, but setting them to filetype <code class="docutils literal"><span class="pre">'MMPr'</span></code>, creator code <code class="docutils literal"><span class="pre">'CWIE'</span></code> may be helpful in opening the projects from the Finder. Users on Mac OS X familiar with the Unix <code class="docutils literal"><span class="pre">find</span></code> command should be able to rig <code class="docutils literal"><span class="pre">/Developer/Tools/SetFile</span></code> to do this job as well.</li> <li>Many of the important projects (for <code class="docutils literal"><span class="pre">libdes</span></code>, <code class="docutils literal"><span class="pre">libsasl</span></code>, <code class="docutils literal"><span class="pre">build_plugins</span></code>, and the sample client <code class="docutils literal"><span class="pre">sc_shlb</span></code>) have Carbon versions.</li> <li>Plugins are loaded from a <code class="docutils literal"><span class="pre">Carbon</span></code> subfolder of the <code class="docutils literal"><span class="pre">SASL</span> <span class="pre">v2</span></code> folder in the Extensions folder. Plugins directly in the <code class="docutils literal"><span class="pre">SASL</span> <span class="pre">v2</span></code> folder are considered to be for the Classic libraries.</li> <li>Note that when using the <code class="docutils literal"><span class="pre">build_plugins</span></code> project, you must generate the plugin init files using the <code class="docutils literal"><span class="pre">makeinit.sh</span></code> script in the <code class="docutils literal"><span class="pre">plugins</span></code> directory. The easiest way to do this is to run the script from a Unix shell, such as Mac OS X. You must then fix the filetypes of the generated source files (see above).</li> <li>There is a new folder in <code class="docutils literal"><span class="pre">CommonKClient</span></code> called <code class="docutils literal"><span class="pre">mac_kclient3</span></code> which contains code compatible with MIT’s new <a class="reference external" href="http://web.mit.edu/macdev/Development/MITKerberos/MITKerberosLib/KClient/Documentation/index.html">KClient 3.0</a> API. This folder must be in your CodeWarrior access paths, the old <code class="docutils literal"><span class="pre">mac_kclient</span></code> folder must not, and it must precede the project’s main folder.</li> <li>The kerberos4 plugin uses this new code. The kerberos4 plugin also statically links the Carbon <code class="docutils literal"><span class="pre">libdes</span></code>, and no other part of Carbon SASL uses <code class="docutils literal"><span class="pre">libdes</span></code> directly. <em>Your application should **not*</em> link against* <code class="docutils literal"><span class="pre">libdes.shlb</span></code> <em>under Carbon!</em> (It causes problems due to DES symbols also existing in the MIT Kerberos library, which loads first.)</li> <li>To build the projects, you should have the MIT Kerberos for Macintosh 3.5 installation disk images mounted, since the access paths include the absolute paths to the library directories from that image. It’s easier than you having to find the paths yourself, and smaller than having to distribute the libraries with SASL.</li> </ul> </div> <div class="section" id="known-problems"> <h2>Known Problems<a class="headerlink" href="#known-problems" title="Permalink to this headline">¶</a></h2> <ul class="simple"> <li>The Kerberos v4 headers bundled with Mac OS X (and Kerberos for Macintosh) are not compatible with OS X’s OpenSSL headers. (Kerberos v4 support is disabled by default.) If you actually need krb4 support, the easiest solution is to build without using OpenSSL’s <code class="docutils literal"><span class="pre">libcrypto</span></code>. To do this, specify the <code class="docutils literal"><span class="pre">--without-openssl</span></code> option to <code class="docutils literal"><span class="pre">configure</span></code>. As of version 2.1.18, this automatically disables using <code class="docutils literal"><span class="pre">libcrypto</span></code> for DES as well. You will probably also need to specify <code class="docutils literal"><span class="pre">--disable-digest</span></code> since the digestmd5 plugin does not build against Kerberos v4’s DES headers or library. Note that this disables several features (digestmd5, NTLM, OTP) which require OpenSSL. If both Kerberos v4 and functionality that requires OpenSSL are needed, it is possible to build the Kerberos v4 plugin against the correct K4 DES libraries, and everything else against OpenSSL; however, we do not support that configuration.</li> <li>Versions of Cyrus SASL prior to 2.1.14 with support for Carbon CFM applications on Mac OS X have a known bug involving the CFM glue code (in <code class="docutils literal"><span class="pre">mac/osx_cfm_glue</span></code>). If <code class="docutils literal"><span class="pre">sasl_done</span></code> is called to unload the SASL library, and then one of the initialization functions (such as <code class="docutils literal"><span class="pre">sasl_client_init</span></code>) is called to reinitialize it from the same process, the application will crash. A fix for one obvious cause of this problem is included in 2.1.14; however, as of this writing, it has not been tested. It is possible that other bugs in Cyrus SASL, or deficiencies in Apple’s libraries, will make this fix insufficient to resolve this issue.</li> </ul> </div> </div> </div> <footer> <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation"> <a href="windows.html" class="btn btn-neutral float-right" title="Building Cyrus SASL on Windows" accesskey="n">Next <span class="fa fa-arrow-circle-right"></span></a> <a href="developer/installation.html" class="btn btn-neutral" title="Cyrus SASL Developer Guide" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous</a> </div> <hr/> <div role="contentinfo"> <p> © Copyright 1993-2016, The Cyrus Team. </p> </div> Built with <a href="http://sphinx-doc.org/">Sphinx</a> 1.6.6 using a modified <a href="https://readthedocs.org">Read the Docs</a> <a href="https://github.com/snide/sphinx_rtd_theme">theme</a>. </footer> </div> </div> </section> </div> <script type="text/javascript"> var DOCUMENTATION_OPTIONS = { URL_ROOT:'../', VERSION:'2.1.27', 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> <script type="text/javascript" src="https://cdn.mathjax.org/mathjax/latest/MathJax.js"></script> <script type="text/javascript" src="../_static/js/theme.js"></script> <script type="text/javascript"> <!-- jQuery(function () { SphinxRtdTheme.StickyNav.enable(); }); --> </script> </body> </html>