diff src/handle.rs @ 169:77470e45e397

Set up stuff to work the way Sun expects it to. This sets up PAM to use pam_authtok_get.so on Sun machines.
author Paul Fisher <paul@pfish.zone>
date Tue, 15 Jul 2025 01:32:21 -0400
parents 2f5913131295
children e27c5c667a5a
line wrap: on
line diff
--- a/src/handle.rs	Tue Jul 15 00:56:01 2025 -0400
+++ b/src/handle.rs	Tue Jul 15 01:32:21 2025 -0400
@@ -157,6 +157,13 @@
     /// This should only be used by *authentication* and *password-change*
     /// PAM modules.
     ///
+    /// With Sun's PAM implementation, this works a little bit differently
+    /// than it does everywhere else. Sun's PAM provides for password input
+    /// *exclusively* though module stacking with the
+    /// [`pam_authtok_get` module][pam_authtok_get]. On Sun, this function
+    /// is exactly equivalent to [`Self::authtok_item`], in that it only
+    /// retrieves the existing item.
+    ///
     /// # References
     ///
     #[doc = linklist!(pam_get_authtok: man7, manbsd)]