AUTHTEST(1)

📦
version 0.73.1 · 2 versions
, in ubuntu stonking

💖 AUTHTEST(1) 💖

okay bestie, welcome to the authtest page — it's a manual page, it's about the Courier Authentication Library, and the whole thing was written by S. Varshavchik. pull up a chair, we're testing auth stuff 🎀

✨ NAME ✨

authtest — Test the Courier Authentication Library

✨ SYNOPSIS ✨

authtest {loginid} [password] [newpassword]

✨ DESCRIPTION ✨

so authtest is a command-line diagnostic utility for the Courier Authentication Library, and it is literally the girl who tells you what's going on with your auth setup 🫶

the way it works: authtest needs at least one argument, and that argument is loginid. no cap, one is the bare minimum. then it sends the authentication request off to the Courier Authentication Library and shows you the results it gets back. 💅

⚠️ two things you gotta know before you even try, bestie: only root may use the authtest utility, and the Courier Authentication Library daemon — that's authdaemond — must already be started. like, it has to be up and running already. no daemon, no vibes. 💀

now, the amount of arguments you hand over changes the entire vibe of the request:

  • one argument — just loginid. the authentication request displays the account information for loginid, if found. if it's not found… well. it's not found 🙈
  • two arguments — loginid and password. here's the thing: password must match loginid's existing password. that's the whole test.
  • three arguments — loginid, password, and newpassword. this one changes loginid's password to newpassword, but only if password matches the existing password. so like, the old password has to be correct first, obviously. no skipping steps 🔥

and here's the icon behavior: these three basic authentication requests can be used to troubleshoot the authentication library's configuration. that's the whole point, that's the assignment, and it ate. 👑

that's the page!! go test your auth, bestie, and remember: root only, daemon up, arguments in order. 🦋✨

— written by S. Varshavchik., dated 01/11/2026, and this is AUTHTEST(1) signing off 💜🌸

📦 where this page comes from