1
.\" <!-- $Id: auth_passwd.sgml,v 1.3 2007/04/01 00:21:34 mrsam Exp $ -->
2
2
.\" <!-- Copyright 2004 Double Precision, Inc. See COPYING for -->
3
3
.\" <!-- distribution information. -->
4
4
.\" Title: auth_passwd
6
.\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/>
5
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
6
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
8
8
.\" Manual: Double Precision, Inc.
9
9
.\" Source: Double Precision, Inc.
11
.TH "AUTH_PASSWD" "3" "08/23/2008" "Double Precision, Inc." "Double Precision, Inc."
12
.TH "AUTH_PASSWD" "3" "08/25/2013" "Double Precision, Inc." "Double Precision, Inc."
13
.\" -----------------------------------------------------------------
14
.\" * Define some portability stuff
15
.\" -----------------------------------------------------------------
16
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
17
.\" http://bugs.debian.org/507673
18
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
19
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
22
.\" -----------------------------------------------------------------
23
.\" * set default formatting
24
.\" -----------------------------------------------------------------
12
25
.\" disable hyphenation
14
27
.\" disable justification (adjust text to left margin only)
29
.\" -----------------------------------------------------------------
30
.\" * MAIN CONTENT STARTS HERE *
31
.\" -----------------------------------------------------------------
17
auth_passwd - Change account's password
33
auth_passwd \- Change account\*(Aqs password
22
#include <courierauth\.h>
37
#include <courierauth\&.h>
39
.HP \w'int\ rc=auth_passwd('u
26
40
.BI "int rc=auth_passwd(const\ char\ *" "service" ", const\ char\ *" "username" ", const\ char\ *" "oldpassword" ", const\ char\ *" "newpassword" ");"
30
\fIusername\fR\'s password is
44
\fIusername\fR\*(Aqs password is
31
45
\fIoldpassword\fR, it is replaced with
34
identifies which so\-called "service"\'s password is changed; like
48
identifies which so\-called "service"\*(Aqs password is changed; like
37
\(lqpop3\(rq\. Some Courier authentication library\'s back\-end module can use different passwords for different services\.
51
\(lqpop3\(rq\&. Some Courier authentication library\*(Aqs back\-end module can use different passwords for different services\&.
39
is ignored if this is not the case\.
53
is ignored if this is not the case\&.
44
returns 0 if the password was succesfully changed\. A non\-0 error code indicates a failure\.\.
57
returns 0 if the password was succesfully changed\&. A non\-0 error code indicates a failure\&.\&.
48
\fI\fBauthlib\fR(3)\fR\&[1],
49
\fI\fBauth_generic\fR(3)\fR\&[2],
50
\fI\fBauth_login\fR(3)\fR\&[3],
51
\fI\fBauth_getuserinfo\fR(3)\fR\&[4],
52
\fI\fBauth_enumerate\fR(3)\fR\&[5]\.
60
\m[blue]\fB\fBauthlib\fR(3)\fR\m[]\&\s-2\u[1]\d\s+2,
61
\m[blue]\fB\fBauth_generic\fR(3)\fR\m[]\&\s-2\u[2]\d\s+2,
62
\m[blue]\fB\fBauth_login\fR(3)\fR\m[]\&\s-2\u[3]\d\s+2,
63
\m[blue]\fB\fBauth_getuserinfo\fR(3)\fR\m[]\&\s-2\u[4]\d\s+2,
64
\m[blue]\fB\fBauth_enumerate\fR(3)\fR\m[]\&\s-2\u[5]\d\s+2\&.
69
\%[set $man.base.url.for.relative.links]/authlib.html
60
72
\fBauth_generic\fR(3)
74
\%[set $man.base.url.for.relative.links]/auth_generic.html
65
77
\fBauth_login\fR(3)
79
\%[set $man.base.url.for.relative.links]/auth_login.html
70
82
\fBauth_getuserinfo\fR(3)
72
\%auth_getuserinfo.html
84
\%[set $man.base.url.for.relative.links]/auth_getuserinfo.html
75
87
\fBauth_enumerate\fR(3)
89
\%[set $man.base.url.for.relative.links]/auth_enumerate.html