OPENPAM_NULLCONV(3)

💅 openpam_nullconv(3) — null conversation function ✨

okay bestie, we’re in the Library Functions Manual and this page is all about openpam_nullconv(3) — the null conversation function. it’s giving “no dialog, no drama” energy 🫶.

---

🎀 NAME 🎀

openpam_nullconv — null conversation function. literally the icon of not asking the user anything 💅.

---

🌸 SYNOPSIS 🌸

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

int
openpam_nullconv(int n, const struct pam_message **msg,
    struct pam_response **resp, void *data);

---

✨ DESCRIPTION ✨

so like, the openpam_nullconv() function is a null conversation function — and it’s perfect for applications that want to use PAM but don’t support interactive dialog with the user. no cap, that’s the whole vibe 😌.

those applications should set PAM_AUTHTOK to whatever authentication token they’ve obtained on their own before calling pam_authenticate(3) and / or pam_chauthtok(3). and their PAM configuration should specify the use_first_pass option for all modules that require access to the authentication token, to make sure they use PAM_AUTHTOK rather than try to query the user. periodt 💖.

---

🔥 RETURN VALUES 🔥

the openpam_nullconv() function returns one of the following values:

• PAM_SUCCESS — success. slay ✨
• PAM_CONV_ERR — conversation failure. oof 😭

---

🦋 SEE ALSO 🦋

go read these too, bestie — they’re all part of the lore:

• openpam_ttyconv(3)
• pam(3)
• pam_authenticate(3)
• pam_chauthtok(3)
• pam_prompt(3)
• pam_set_item(3)
• pam_strerror(3)
• pam_vprompt(3)

---

👑 STANDARDS 👑

the openpam_nullconv() function is an OpenPAM extension. that’s it, that’s the standard 💅.

---

🌈 AUTHORS 🌈

so the openpam_nullconv() 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. iconic research behavior fr fr 🧚.

the OpenPAM library is maintained by Dag-Erling Smørgrav <des@des.no>. we love a maintainer 🫶.

---

xoxo bestie 💖 — this page is from Debian, dated June 27, 2023, and it’s serving OPENPAM_NULLCONV(3) energy ✨👑