embedded-mbedtls-sys

This crate builds the Mbed TLS C library and generates low-level Rust bindings using bindgen for the embedded-mbedtls library/project. Probably, you will want to use it through the high-level Rust wrapper embedded-mbedtls instead of using this crate directly.

For general project goals, see the README.md in the project repository.

Configuration

Mbed TLS can be configured through crate features, which correspond to the C defines. Currently only the following features are available, but the goal is to expand this in the future.

• MBEDTLS_SSL_CLI_C
• MBEDTLS_SSL_SRV_C

The documentation on docs.rs is build with all features enabled.

For further information how Mbed TLS is configured, see the the build.rs for this crate (especially the write_config_h function) which generates the config.h.

Please note that not all generated Rust bindings which end up in the Rustdoc are meaningful. They are generated by running bindgen on mbedtls/ssl.h and a few other headers (see build.rs) but apparently, mbedtls/ssl.h already includes many other headers and their definitions, even though these are not configured to be used. Trying to use these will most probably result in some kind of error, e.g. linkage errors.

License

Open Logistics License
Version 1.3, January 2023

See the LICENSE file in the top-level directory.

Contact

Fraunhofer IML Embedded Rust Group - embedded-rust@iml.fraunhofer.de