OPENPAM_TTYCONV(3)

πŸ“¦
version 14.5 Β· 2 versions
, in freebsd 14.5, nixos 26.05, nixpkgs unstable

🌸 NAME 🌸

openpam_ttyconv β€” simple tty-based conversation function. This is the OPENPAM_TTYCONV(3) page from the Library Functions Manual, bestie, and it's giving "let's talk to the terminal" energy. πŸ’…

✨ SYNOPSIS ✨

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

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

πŸ’– DESCRIPTION πŸ’–

Okay so openpam_ttyconv() is a standard conversation function suitable for use on TTY devices. It should be adequate for the needs of most text-based interactive programs β€” like, it's the reliable bestie for terminal chats. 🫢

The openpam_ttyconv() function lets the application specify a timeout for user input by setting the global integer variable openpam_ttyconv_timeout to the length of the timeout in seconds. So yes, set that integer, and the timeout is in seconds β€” no cap. ⏳

🌈 RETURN VALUES 🌈

The openpam_ttyconv() function returns one of the following values:

  • PAM_SUCCESS β€” Success. iconic. πŸ‘‘
  • PAM_BUF_ERR β€” Memory buffer error. 😭
  • PAM_CONV_ERR β€” Conversation failure. πŸ’€
  • PAM_SYSTEM_ERR β€” System error. 🚨

πŸ¦‹ SEE ALSO πŸ¦‹

openpam_nullconv(3), pam(3), pam_prompt(3), pam_strerror(3), pam_vprompt(3) β€” go read these too, bestie. πŸ“š

⭐ STANDARDS ⭐

The openpam_ttyconv() function is an OpenPAM extension. periodt. ✨

πŸŽ€ AUTHORS πŸŽ€

The openpam_ttyconv() 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. That's a whole lot of lore, fr fr. 🧚

The OpenPAM library is maintained by Dag-Erling SmΓΈrgrav <des@des.no>. Say hi to the maintainer! πŸ’Œ


Okay so that's the whole page, and this cutie came from Debian, dated June 27, 2023 β€” that's the source/version and date from the footer, folded into this little sign-off. bye bestie! πŸ’–πŸŽ€βœ¨

πŸ“¦ where this page comes from