Struct LibPamTransaction 

pub struct LibPamTransaction<C: Conversation> { /* private fields */ }

An owned PAM handle.

Implementations

impl<C: Conversation> LibPamTransaction<C>

pub fn end_silent(self)

Ends the PAM transaction “quietly” (on Linux-PAM only).

On Linux-PAM, this is equivalent to passing the PAM_DATA_SILENT flag to pam_end on Linux-PAM, which signals that data cleanup should “not treat the call too seriously” [sic].

On other platforms, this is no different than letting the transaction end on its own.

Trait Implementations

impl<C: Conversation> Debug for LibPamTransaction<C>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<C: Conversation> Drop for LibPamTransaction<C>

fn drop(&mut self)

Closes the PAM session on an owned PAM handle.

This internally calls pam_end with the appropriate error code.

References

• Application Developers’ Guide on pam_end
• Linux-PAM manpage for pam_end
• OpenPAM manpage for pam_end
• Illumos manpage for pam_end
• X/SSO spec for pam_end

impl<C: Conversation> Logger for LibPamTransaction<C>

fn log(&self, level: Level, location: Location<'_>, entry: Arguments<'_>)

Logs something via this PAM handle.

impl<C: Conversation> PamShared for LibPamTransaction<C>

fn environ(&self) -> impl EnvironMap<'_>

The contents of the environment to set for the logged-in user.

fn environ_mut(&mut self) -> impl EnvironMapMut<'_>

A writable map of the environment to set for the logged-in user.

fn username(&mut self, prompt: Option<&OsStr>) -> Result<OsString>

Retrieves the name of the user who is authenticating or logging in.

fn items(&self) -> impl Items<'_>

Gets Items, data shared by PAM, the application, and modules.

fn items_mut(&mut self) -> impl ItemsMut<'_>

Read-write access to PAM Items.

impl<C: Conversation> Transaction for LibPamTransaction<C>

fn authenticate(&mut self, flags: AuthnFlags) -> Result<()>

Starts the authentication process for the user.

fn account_management(&mut self, flags: AuthnFlags) -> Result<()>

Verifies the validity of the user’s account (and other stuff).

fn change_authtok(&mut self, flags: AuthtokFlags) -> Result<()>

Changes the authentication token.