pklogin_finder(1)

💖 pklogin_finder(1) 💖

okay bestie, welcome to the PAM-PKCS#11 section of the manual, and today's main character is pklogin_finder — she maps certificates into a user and she does it flawlessly. ✨

---

🌸 NAME 🌸

pklogin_finder — maps certificates into a user 🫶

---

✨ SYNTAX ✨

pklogin_finder [debug] [config_file=<filename>]

that's it. that's the whole vibe check. 💅

---

🦋 DESCRIPTION 🦋

so here's the tea: pklogin_finder uses the pam_pkcs11 library infrastructure to interactively map a PKCS#11 provided certificate to a user. like, it goes and figures out who you are, no cap. 👑

she uses the same configuration file and the same arguments as the pam_pkcs11(8) PAM module — not similar, the same. she loads the defined mapper modules and tries to find a map between the found certificates and a user login. it's giving matchmaker but for certs and logins. 💘

---

🎀 OPTIONS 🎀

• debug — turns on debugging output. Default is no debug. so if you want the receipts, you gotta ask for them. 🔍
• config_file=<configuration file> — sets which configuration file to use. Default value is /etc/pam_pkcs11/pam_pkcs11.conf. 🗂️

because she runs off the same configuration file as pam_pkcs11, all pam_pkcs11 options are also available to you. but heads up: some of them have absolutely no sense in a non-PAM environment, so they will just be ignored. they're not invited to the party, bestie. 🚫🎉

---

🧚 RETURN VALUE 🧚

• on success, pklogin_finder prints the login name on stdout and exits returning 0. slay. ✅
• on user mapping error, she returns 1. 😭
• on no user match, she prints nothing and returns 2. the silence is loud fr fr. 💀

---

🌈 FILES 🌈

• /etc/pam_pkcs11/pam_pkcs11.conf

---

⭐ EXAMPLES ⭐

to run this program the standard way, insert a smart card into the reader and type:

pklogin_finder

alternatively you can specify options:

pklogin_finder debug config_file=${HOME}/.pam_pkcs11.conf

iconic behavior honestly. 🪪✨

---

👑 AUTHORS 👑

Juan Antonio Martinez <jonsito@teleline.es> — the legend herself. 💜

---

🔥 SEE ALSO 🔥

• pam_pkcs11(8)
• pkcs11_inspect(1)
• PAM-PKCS11 User Manual

---

written by Juan Antonio Martinez, dating all the way back to Aug 2005 🕰️ — yeah she's vintage, she's an OG, and she's still out here mapping certs to users with main character energy. go read the page, bestie, ily, bye! 💖🎀🦋🌸💅🫶