OPENPAM_BORROW_CRED(3)

📦
version 14.5 · 2 versions
, in freebsd 14.5, nixos 26.05, nixpkgs unstable

💖 NAME 💖

okay bestie, welcome to the OPENPAM_BORROW_CRED(3) page from the Library Functions Manual 💖 this is all about openpam_borrow_cred — temporarily borrow user credentials. yes, it's giving identity-swap side quest, and it's lowkey iconic ✨

✨ SYNOPSIS ✨

bestie, here's the exact summoning circle 🕯️

#include <sys/types.h>
#include <security/pam_appl.h>
#include <security/openpam.h>

int
openpam_borrow_cred(pam_handle_t *pamh, const struct passwd *pwd);

🦋 DESCRIPTION 🦋

The openpam_borrow_cred() function saves the current credentials and switches to those of the user specified by its pwd argument. The affected credentials are the effective UID, the effective GID, and the group access list. no cap, those are the three things getting swapped 🫶

The original credentials can be restored using openpam_restore_cred(3) — and yes, you should give them back, bestie 💅

🎀 RETURN VALUES 🎀

openpam_borrow_cred() returns one of the following values:

  • PAM_SUCCESS — Success 🌟
  • PAM_BUF_ERR — Memory buffer error 😭
  • PAM_PERM_DENIED — Permission denied 🙈
  • PAM_SYSTEM_ERR — System error 💀

🌸 SEE ALSO 🌸

go read these next, iykyk 💅

⭐ STANDARDS ⭐

The openpam_borrow_cred() function is an OpenPAM extension. periodt. 💅

👑 AUTHORS 👑

The openpam_borrow_cred() function and this manual page were developed for the FreeBSD Project by ThinkSec AS and Network Associates Laboratories, the Security Research Division of Network Associates, Inc. under DARPA/SPAWAR contract N66001-01-C-8035 (“CBOSS”), as part of the DARPA CHATS research program. historical icon behavior, fr fr 🫶

The OpenPAM library is maintained by Dag-Erling Smørgrav <des@des.no>. bow down to the maintainer 👑

mwah 💋 — source/version: Debian; date: June 27, 2023; page: OPENPAM_BORROW_CRED(3). bye bestie 🫶

📦 where this page comes from