AUTH_PASSWD(3)

📦
version 0.73.1 · 2 versions
, in ubuntu stonking

💅 AUTH_PASSWD — the auth_passwd(3) glow-up

okay bestie, so this is auth_passwd from the Courier authentication library (courierauth.h), and it does exactly one dramatic thing: it changes an account's password. no cap. let's get into it ✨

🎀 NAME

auth_passwd — change an account's password 🔑

like. it rotates the password. that's the whole job. iconic behaviour honestly.

✨ SYNOPSIS

#include <courierauth.h>

int rc=auth_passwd(const char *service, const char *username,
                   const char *oldpassword, const char *newpassword);

so yeah, you pull in <courierauth.h>, you call auth_passwd with four things, and it hands you back an int that you catch in rc. that's the whole vibe check 🫶

🌸 DESCRIPTION

okay so here's the tea ☕ — if username's current password is genuinely oldpassword, then it gets swapped out for newpassword. old one out, new one in, slay 💅

and service is the lil' label for which so-called "service"'s password is getting changed — think stuff like “imap” or “pop3”. some of the Courier authentication library's back-end modules lowkey keep different passwords for different services, which is a whole situation, but they do it.

heads up bestie: service gets ignored if the back-end doesn't do that per-service thing. so don't spiral if it seems like it's not doing anything — for some modules it literally just doesn't matter 🙈

🦋 RETURNS

auth_passwd returns 0 when the password was successfully changed — that's the win, that's the moment, we love to see it 💖

a non-0 error code means a failure. not the serve. not the moment. 😭

👑 SEE ALSO

📝 NOTES

  1. authlib(3) https://www.courier-mta.org/authlib/authlib.html
  2. auth_generic_meta(3) https://www.courier-mta.org/authlib/auth_generic.html
  3. auth_login_meta(3) https://www.courier-mta.org/authlib/auth_login.html
  4. auth_getuserinfo_meta(3) https://www.courier-mta.org/authlib/auth_getuserinfo.html
  5. auth_enumerate(3) https://www.courier-mta.org/authlib/auth_enumerate.html

and that's the page!! written by S. Varshavchik, dated 06/18/2026, and it's the AUTH_PASSWD(3) manpage, periodt 💜✨ go change a password, bestie, you've got this 🎀

📦 where this page comes from