← Back to branch summary

~ubuntu-branches/ubuntu/utopic/courier-authlib/utopic

« back to all changes in this revision

Viewing changes to auth_passwd.3

  • Committer: Package Import Robot
  • Author(s): Stefan Hornburg (Racke), Willi Mann
  • Date: 2013-10-28 11:38:37 UTC
  • mfrom: (1.1.7) (0.1.13 sid)
  • Revision ID: package-import@ubuntu.com-20131028113837-v4xfdtmp0z14k8j1
Tags: 0.66.1-1
* New upstream release.

[Willi Mann <willi@debian.org>]

* Fix libtool breakage by explicitly using /bin/bash in debian/rules.

Show diffs side-by-side

added added

removed removed

Lines of Context:
auth_passwd.3
1
 
.\"  <!-- $Id: auth_passwd.sgml,v 1.3 2007/04/01 00:21:34 mrsam Exp $ -->
 
1
'\" t
2
2
.\"  <!-- Copyright 2004 Double Precision, Inc.  See COPYING for -->
3
3
.\"  <!-- distribution information. -->
4
4
.\"     Title: auth_passwd
5
 
.\"    Author: 
6
 
.\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/>
7
 
.\"      Date: 08/23/2008
 
5
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
 
6
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
 
7
.\"      Date: 08/25/2013
8
8
.\"    Manual: Double Precision, Inc.
9
9
.\"    Source: Double Precision, Inc.
 
10
.\"  Language: English
10
11
.\"
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
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
20
.ie \n(.g .ds Aq \(aq
 
21
.el       .ds Aq '
 
22
.\" -----------------------------------------------------------------
 
23
.\" * set default formatting
 
24
.\" -----------------------------------------------------------------
12
25
.\" disable hyphenation
13
26
.nh
14
27
.\" disable justification (adjust text to left margin only)
15
28
.ad l
 
29
.\" -----------------------------------------------------------------
 
30
.\" * MAIN CONTENT STARTS HERE *
 
31
.\" -----------------------------------------------------------------
16
32
.SH "NAME"
17
 
auth_passwd - Change account's password
 
33
auth_passwd \- Change account\*(Aqs password
18
34
.SH "SYNOPSIS"
19
35
.sp
20
 
.RS 4
21
36
.nf
22
 
#include <courierauth\.h>
 
37
#include <courierauth\&.h>
23
38
.fi
24
 
.RE
25
 
.HP 19
 
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" ");"
27
41
.SH "DESCRIPTION"
28
42
.PP
29
43
If
30
 
\fIusername\fR\'s password is
 
44
\fIusername\fR\*(Aqs password is
31
45
\fIoldpassword\fR, it is replaced with
32
 
\fInewpassword\fR\.
 
46
\fInewpassword\fR\&.
33
47
\fIservice\fR
34
 
identifies which so\-called "service"\'s password is changed; like
 
48
identifies which so\-called "service"\*(Aqs password is changed; like
35
49
\(lqimap\(rq
36
50
or
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\&.
38
52
\fIservice\fR
39
 
is ignored if this is not the case\.
 
53
is ignored if this is not the case\&.
40
54
.SH "RETURNS"
41
55
.PP
42
 
 
43
56
\fBauth_passwd\fR
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\&.\&.
45
58
.SH "SEE ALSO"
46
59
.PP
47
 
 
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\&.
53
65
.SH "NOTES"
54
66
.IP " 1." 4
55
67
\fBauthlib\fR(3)
56
68
.RS 4
57
 
\%authlib.html
 
69
\%[set $man.base.url.for.relative.links]/authlib.html
58
70
.RE
59
71
.IP " 2." 4
60
72
\fBauth_generic\fR(3)
61
73
.RS 4
62
 
\%auth_generic.html
 
74
\%[set $man.base.url.for.relative.links]/auth_generic.html
63
75
.RE
64
76
.IP " 3." 4
65
77
\fBauth_login\fR(3)
66
78
.RS 4
67
 
\%auth_login.html
 
79
\%[set $man.base.url.for.relative.links]/auth_login.html
68
80
.RE
69
81
.IP " 4." 4
70
82
\fBauth_getuserinfo\fR(3)
71
83
.RS 4
72
 
\%auth_getuserinfo.html
 
84
\%[set $man.base.url.for.relative.links]/auth_getuserinfo.html
73
85
.RE
74
86
.IP " 5." 4
75
87
\fBauth_enumerate\fR(3)
76
88
.RS 4
77
 
\%auth_enumerate.html
 
89
\%[set $man.base.url.for.relative.links]/auth_enumerate.html
78
90
.RE