Bindings to Cyrus SASL.

This crate provides raw bindings to the Cyrus SASL library, libsasl2. Each module corresponds to a public header file in the C API.

Build configuration

Vendored

If the vendored Cargo feature is enabled, a bundled copy of libsasl2 will be compiled and statically linked. The libsasl2 version will generally track the latest upstream release. Note that the version number of this crate is unrelated to the bundled version of libsasl2.

sasl2-sys is currently bundling libsasl2 v2.1.27.

When configuring the bundled library, sasl2-sys is intentionally conservative in the features it enables. All optional features are disabled by default. The following Cargo features can be used to re-enable features as necessary.

• gssapi-vendored enables the GSSAPI plugin (--enable-gssapi) by building and statically linking a copy of MIT's Kerberos implementation using the krb5-src crate.

• plain enables the PLAIN plugin (--enable-plain).

Note that specifying any of these features implies vendored.

The eventual goal is to expose each libsasl2 feature behind a Cargo feature of the same name. Pull requests on this front are welcomed.

System

Without the vendored Cargo feature, sasl2-sys will search for the libsasl2 library and headers in several standard locations. If the pkg-config feature is enabled, as it is by default, pkg-config will be queried for the location of the sasl2 library.

When linking against the system-provided library, dynamic linking is preferred unless the SASL2_STATIC variable is set.

Platform support

Upstream supports most major platforms, but sasl2-sys is only tested on recent versions of Ubuntu, CentOS, and macOS. Patches that improve support for other platforms are welcome.