2 <html xmlns=
"http://www.w3.org/1999/xhtml"><head><meta http-equiv=
"Content-Type" content=
"text/html; charset=UTF-8"/><title>auth_passwd
</title><link rel=
"stylesheet" href=
"style.css" type=
"text/css"/><meta name=
"generator" content=
"DocBook XSL Stylesheets V1.72.0"/><link rel=
"start" href=
"#auth-passwd" title=
"auth_passwd"/><link xmlns=
"" rel=
"stylesheet" type=
"text/css" href=
"manpage.css"/><meta xmlns=
"" name=
"MSSmartTagsPreventParsing" content=
"TRUE"/><link xmlns=
"" rel=
"icon" href=
"icon.gif" type=
"image/gif"/><!--
4 Copyright 1998 - 2007 Double Precision, Inc. See COPYING for distribution
7 --></head><body><div class=
"refentry" lang=
"en" xml:
lang=
"en"><a id=
"auth-passwd" shape=
"rect"> </a><div class=
"titlepage"/><div class=
"refnamediv"><h2>Name
</h2><p>auth_passwd — Change account's password
</p></div><div class=
"refsynopsisdiv"><h2>Synopsis
</h2><div class=
"literallayout"><p><br clear=
"none"/>
8 #include
<courierauth.h
><br clear=
"none"/>
9 </p></div><div class=
"funcsynopsis"><table border=
"0" summary=
"Function synopsis" cellspacing=
"0" cellpadding=
"0"><tr><td rowspan=
"1" colspan=
"1"><code class=
"funcdef">int rc=
<b class=
"fsfunc">auth_passwd
</b>(
</code></td><td rowspan=
"1" colspan=
"1">const char *
</td><td rowspan=
"1" colspan=
"1"><var class=
"pdparam">service
</var>,
</td></tr><tr><td rowspan=
"1" colspan=
"1"> </td><td rowspan=
"1" colspan=
"1">const char *
</td><td rowspan=
"1" colspan=
"1"><var class=
"pdparam">username
</var>,
</td></tr><tr><td rowspan=
"1" colspan=
"1"> </td><td rowspan=
"1" colspan=
"1">const char *
</td><td rowspan=
"1" colspan=
"1"><var class=
"pdparam">oldpassword
</var>,
</td></tr><tr><td rowspan=
"1" colspan=
"1"> </td><td rowspan=
"1" colspan=
"1">const char *
</td><td rowspan=
"1" colspan=
"1"><var class=
"pdparam">newpassword
</var><code>)
</code>;
</td></tr></table></div></div><div class=
"refsect1" lang=
"en" xml:
lang=
"en"><a id=
"id282326" shape=
"rect"> </a><h2>DESCRIPTION
</h2><p>
10 If
<em class=
"parameter"><code>username
</code></em>'s password is
11 <em class=
"parameter"><code>oldpassword
</code></em>, it is replaced with
12 <em class=
"parameter"><code>newpassword
</code></em>.
13 <em class=
"parameter"><code>service
</code></em> identifies which so-called
"service"'s
14 password is changed; like “
<span class=
"quote">imap
</span>” or “
<span class=
"quote">pop3
</span>”.
15 Some Courier authentication library's back-end module can use different
16 passwords for different services.
17 <em class=
"parameter"><code>service
</code></em> is ignored if this is not the case.
</p></div><div class=
"refsect1" lang=
"en" xml:
lang=
"en"><a id=
"id282374" shape=
"rect"> </a><h2>RETURNS
</h2><p>
18 <code class=
"function">auth_passwd
</code> returns
0 if the password was
20 A non-
0 error code indicates a failure..
</p></div><div class=
"refsect1" lang=
"en" xml:
lang=
"en"><a id=
"id282585" shape=
"rect"> </a><h2>SEE ALSO
</h2><p>
21 <a href=
"authlib.html" target=
"_top" shape=
"rect"><span class=
"citerefentry"><span class=
"refentrytitle">authlib
</span>(
3)
</span></a>,
23 <a href=
"auth_generic.html" target=
"_top" shape=
"rect"><span class=
"citerefentry"><span class=
"refentrytitle">auth_generic
</span>(
3)
</span></a>,
25 <a href=
"auth_login.html" target=
"_top" shape=
"rect"><span class=
"citerefentry"><span class=
"refentrytitle">auth_login
</span>(
3)
</span></a>,
27 <a href=
"auth_getuserinfo.html" target=
"_top" shape=
"rect"><span class=
"citerefentry"><span class=
"refentrytitle">auth_getuserinfo
</span>(
3)
</span></a>,
29 <a href=
"auth_enumerate.html" target=
"_top" shape=
"rect"><span class=
"citerefentry"><span class=
"refentrytitle">auth_enumerate
</span>(
3)
</span></a>.
</p></div></div></body></html>