comparison libpam-sys/libpam-sys-consts/README.md @ 158:d5b7b28d754e

Add `__TARGET_DEFAULT__` PamImpl and set up for docsrs build. Also fixes some formatting stuff.
author Paul Fisher <paul@pfish.zone>
date Sat, 12 Jul 2025 17:17:37 -0400
parents 4b3a5095f68c
children 09dff285ff5e
comparison
equal deleted inserted replaced
157:0099f2f79f86 158:d5b7b28d754e
47 } 47 }
48 ``` 48 ```
49 49
50 ## Configuration 50 ## Configuration
51 51
52 By default, this crate automatically detects your libpam version. 52 Known implementations of PAM are listed in the `PamImpl` enum, and your currently installed implementation is automatically detected.
53 Known implementations are listed in the `PamImpl` enum.
54 53
55 You can override this **at build time** by setting the `LIBPAMSYS_IMPL` environment variable to one of those names. 54 If you need to configure this, you can override it **at build time** with the `LIBPAMSYS_IMPL` environment variable:
56 For example, `LIBPAMSYS_IMPL=OpenPam cargo build` will build this library for OpenPAM. 55
56 - Unset or `` (the default): Probe the currently installed LibPAM to figure out which implementation it is.
57 If LibPAM is not present, this will fall back to `__TARGET_DEFAULT__`.
58 - `__TARGET_DEFAULT__`: Select the version of LibPAM most likely to be installed on the current OS.
59 This is a useful setting for cross-compiling.
60 - The name of a `PamEnum` entry: The named PAM implementation.
61 For instance, `LIBPAMSYS_IMPL=OpenPam cargo build` will build this library for OpenPAM.
57 62
58 ## MSRV 63 ## MSRV
59 64
60 This library supports **Rust 1.75**, as the version currently (July 2025) available in Debian Trixie and Ubuntu 24.04 LTS. 65 This library supports **Rust 1.75**, as the version currently (July 2025) available in Debian Trixie and Ubuntu 24.04 LTS.