Commit | Line | Data |
---|---|---|
d9898ee8 | 1 | .\" <!-- $Id: authtest.sgml,v 1.4 2007/04/22 15:05:16 mrsam Exp $ --> |
2 | .\" <!-- Copyright 2004 Double Precision, Inc. See COPYING for --> | |
3 | .\" <!-- distribution information. --> | |
4 | .\" Title: authtest | |
5 | .\" Author: | |
8d138742 CE |
6 | .\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/> |
7 | .\" Date: 08/23/2008 | |
d9898ee8 | 8 | .\" Manual: Double Precision, Inc. |
9 | .\" Source: Double Precision, Inc. | |
10 | .\" | |
8d138742 | 11 | .TH "AUTHTEST" "1" "08/23/2008" "Double Precision, Inc." "Double Precision, Inc." |
d9898ee8 | 12 | .\" disable hyphenation |
13 | .nh | |
14 | .\" disable justification (adjust text to left margin only) | |
15 | .ad l | |
16 | .SH "NAME" | |
8d138742 | 17 | authtest - Test the Courier Authentication Library |
d9898ee8 | 18 | .SH "SYNOPSIS" |
19 | .HP 9 | |
20 | \fBauthtest\fR {loginid} [password] [newpassword] | |
21 | .SH "DESCRIPTION" | |
22 | .PP | |
23 | ||
24 | \fBauthtest\fR | |
8d138742 | 25 | is a command\-line diagnostic utility for the Courier Authentication Library\. |
d9898ee8 | 26 | \fBauthtest\fR |
27 | requires at least one argument: | |
8d138742 | 28 | \fIloginid\fR\. |
d9898ee8 | 29 | \fBauthtest\fR |
8d138742 | 30 | sends the authentication request to the Courier Authentication Library, then displays the results\. Only root may use |
d9898ee8 | 31 | \fBauthtest\fR |
8d138742 | 32 | utility, and the Courier Authentication Library daemon (\fBauthdaemond\fR) must already be started\. |
d9898ee8 | 33 | .PP |
34 | If only one argument is provided, the authentication request displays the account information for | |
8d138742 | 35 | \fIloginid\fR, if found\. |
d9898ee8 | 36 | .PP |
37 | If two arguments are provided, | |
38 | \fIpassword\fR | |
39 | must match | |
8d138742 | 40 | \fIloginid\fR\'s existing password\. |
d9898ee8 | 41 | .PP |
42 | If three arguments are provided, | |
8d138742 | 43 | \fIloginid\fR\'s password is changed to |
d9898ee8 | 44 | \fInewpassword\fR, but only if |
45 | \fIpassword\fR | |
8d138742 | 46 | matches the existing psasword\. |
d9898ee8 | 47 | .PP |
8d138742 | 48 | These three basic authentication requests can be used to troubleshoot the authentication library\'s configuration\. |