Commit | Line | Data |
---|---|---|
b0322a85 | 1 | '\" t |
d9898ee8 | 2 | .\" <!-- Copyright 2004 Double Precision, Inc. See COPYING for --> |
3 | .\" <!-- distribution information. --> | |
4 | .\" Title: auth_passwd | |
0e333c05 CE |
5 | .\" Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author] |
6 | .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> | |
7 | .\" Date: 09/08/2017 | |
d9898ee8 | 8 | .\" Manual: Double Precision, Inc. |
9 | .\" Source: Double Precision, Inc. | |
b0322a85 | 10 | .\" Language: English |
d9898ee8 | 11 | .\" |
0e333c05 | 12 | .TH "AUTH_PASSWD" "3" "09/08/2017" "Double Precision, Inc." "Double Precision, Inc." |
b0322a85 CE |
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 | .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
20 | .ie \n(.g .ds Aq \(aq | |
21 | .el .ds Aq ' | |
22 | .\" ----------------------------------------------------------------- | |
23 | .\" * set default formatting | |
24 | .\" ----------------------------------------------------------------- | |
d9898ee8 | 25 | .\" disable hyphenation |
26 | .nh | |
27 | .\" disable justification (adjust text to left margin only) | |
28 | .ad l | |
b0322a85 CE |
29 | .\" ----------------------------------------------------------------- |
30 | .\" * MAIN CONTENT STARTS HERE * | |
31 | .\" ----------------------------------------------------------------- | |
d9898ee8 | 32 | .SH "NAME" |
b0322a85 | 33 | auth_passwd \- Change account\*(Aqs password |
d9898ee8 | 34 | .SH "SYNOPSIS" |
35 | .sp | |
d9898ee8 | 36 | .nf |
b0322a85 | 37 | #include <courierauth\&.h> |
d9898ee8 | 38 | .fi |
b0322a85 | 39 | .HP \w'int\ rc=auth_passwd('u |
d9898ee8 | 40 | .BI "int rc=auth_passwd(const\ char\ *" "service" ", const\ char\ *" "username" ", const\ char\ *" "oldpassword" ", const\ char\ *" "newpassword" ");" |
41 | .SH "DESCRIPTION" | |
42 | .PP | |
43 | If | |
b0322a85 | 44 | \fIusername\fR\*(Aqs password is |
d9898ee8 | 45 | \fIoldpassword\fR, it is replaced with |
b0322a85 | 46 | \fInewpassword\fR\&. |
d9898ee8 | 47 | \fIservice\fR |
b0322a85 | 48 | identifies which so\-called "service"\*(Aqs password is changed; like |
d9898ee8 | 49 | \(lqimap\(rq |
50 | or | |
b0322a85 | 51 | \(lqpop3\(rq\&. Some Courier authentication library\*(Aqs back\-end module can use different passwords for different services\&. |
d9898ee8 | 52 | \fIservice\fR |
b0322a85 | 53 | is ignored if this is not the case\&. |
d9898ee8 | 54 | .SH "RETURNS" |
55 | .PP | |
d9898ee8 | 56 | \fBauth_passwd\fR |
b0322a85 | 57 | returns 0 if the password was succesfully changed\&. A non\-0 error code indicates a failure\&.\&. |
d9898ee8 | 58 | .SH "SEE ALSO" |
59 | .PP | |
b0322a85 CE |
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\&. | |
8d138742 | 65 | .SH "NOTES" |
d9898ee8 | 66 | .IP " 1." 4 |
67 | \fBauthlib\fR(3) | |
68 | .RS 4 | |
d50284c4 | 69 | \%http://www.courier-mta.org/authlib/authlib.html |
d9898ee8 | 70 | .RE |
71 | .IP " 2." 4 | |
72 | \fBauth_generic\fR(3) | |
73 | .RS 4 | |
d50284c4 | 74 | \%http://www.courier-mta.org/authlib/auth_generic.html |
d9898ee8 | 75 | .RE |
76 | .IP " 3." 4 | |
77 | \fBauth_login\fR(3) | |
78 | .RS 4 | |
d50284c4 | 79 | \%http://www.courier-mta.org/authlib/auth_login.html |
d9898ee8 | 80 | .RE |
81 | .IP " 4." 4 | |
82 | \fBauth_getuserinfo\fR(3) | |
83 | .RS 4 | |
d50284c4 | 84 | \%http://www.courier-mta.org/authlib/auth_getuserinfo.html |
d9898ee8 | 85 | .RE |
86 | .IP " 5." 4 | |
87 | \fBauth_enumerate\fR(3) | |
88 | .RS 4 | |
d50284c4 | 89 | \%http://www.courier-mta.org/authlib/auth_enumerate.html |
d9898ee8 | 90 | .RE |