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