Mercurial > crates > nonstick

diff libpam-sys/libpam-sys-consts/README.md @ 160:09dff285ff5e

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Switch default PAM detection strategy to target-based. To make cross-compilation easier (like for docs.rs), this change makes OS-based detection of PAM the default, only falling back to probing the actual installed PAM as a last resort. I haven't been able to find a Linux distribution that uses anything but Linux-PAM.
author Paul Fisher <paul@pfish.zone>
date Sun, 13 Jul 2025 15:38:00 -0400
parents d5b7b28d754e
children e9354e655f38
line wrap: on
line diff
--- a/libpam-sys/libpam-sys-consts/README.md	Sat Jul 12 18:16:18 2025 -0400
+++ b/libpam-sys/libpam-sys-consts/README.md	Sun Jul 13 15:38:00 2025 -0400
@@ -53,10 +53,10 @@
 
 If you need to configure this, you can override it **at build time** with the `LIBPAMSYS_IMPL` environment variable:
 
-- Unset or `` (the default): Probe the currently installed LibPAM to figure out which implementation it is.
-  If LibPAM is not present, this will fall back to `__TARGET_DEFAULT__`.
-- `__TARGET_DEFAULT__`: Select the version of LibPAM most likely to be installed on the current OS.
-  This is a useful setting for cross-compiling.
+- Unset or empty (the default): Use the version of PAM most commonly found on the target OS.
+  If we don't know what kind of PAM is usually installed on this OS, we fall back to `__installed__`.
+- `__installed__`: Looks at the PAM library installed on the current machine.
+  If none is recognized, falls back to `XSso`.
 - The name of a `PamEnum` entry: The named PAM implementation.
   For instance, `LIBPAMSYS_IMPL=OpenPam cargo build` will build this library for OpenPAM.