<!-- Copyright 2004 Double Precision, Inc. See COPYING for -->
<!-- distribution information. -->
Title: auth_passwd
Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
Date: 10/28/2020
Manual: Double Precision, Inc.
Source: Double Precision, Inc.
Language: English
* Define some portability stuff
-----------------------------------------------------------------
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
http://bugs.debian.org/507673
http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-----------------------------------------------------------------
* set default formatting
-----------------------------------------------------------------
disable hyphenation
disable justification (adjust text to left margin only)
-----------------------------------------------------------------
* MAIN CONTENT STARTS HERE *
-----------------------------------------------------------------
#include <courierauth.h>
\w'int rc=auth_passwd('u "int rc=auth_passwd(const char *" "service" ", const char *" "username" ", const char *" "oldpassword" ", const char *" "newpassword" ");"
If username\*(Aqs password is oldpassword, it is replaced with newpassword. service identifies which so-called "service"\*(Aqs password is changed; like "imap" or "pop3". Some Courier authentication library\*(Aqs back-end module can use different passwords for different services. service is ignored if this is not the case.
auth_passwd returns 0 if the password was succesfully changed. A non-0 error code indicates a failure..
\m[blue]authlib(3)\m[]\s-2\u[1]\d\s+2, \m[blue]auth_generic_meta(3)\m[]\s-2\u[2]\d\s+2, \m[blue]auth_login_meta(3)\m[]\s-2\u[3]\d\s+2, \m[blue]auth_getuserinfo_meta(3)\m[]\s-2\u[4]\d\s+2, \m[blue]auth_enumerate(3)\m[]\s-2\u[5]\d\s+2.
\%http://www.courier-mta.org/authlib/authlib.html
\%http://www.courier-mta.org/authlib/auth_generic.html
\%http://www.courier-mta.org/authlib/auth_login.html