2 .\" <!-- Copyright 2004 Double Precision, Inc. See COPYING for -->
3 .\" <!-- distribution information. -->
5 .\" Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
6 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
8 .\" Manual: Double Precision, Inc.
9 .\" Source: Double Precision, Inc.
12 .TH "AUTHTEST" "1" "09/08/2017" "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 .\" -----------------------------------------------------------------
25 .\" disable hyphenation
27 .\" disable justification (adjust text to left margin only)
29 .\" -----------------------------------------------------------------
30 .\" * MAIN CONTENT STARTS HERE *
31 .\" -----------------------------------------------------------------
33 authtest \- Test the Courier Authentication Library
35 .HP \w'\fBauthtest\fR\ 'u
36 \fBauthtest\fR {loginid} [password] [newpassword]
40 is a command\-line diagnostic utility for the Courier Authentication Library\&.
42 requires at least one argument:
45 sends the authentication request to the Courier Authentication Library, then displays the results\&. Only root may use
47 utility, and the Courier Authentication Library daemon (\fBauthdaemond\fR) must already be started\&.
49 If only one argument is provided, the authentication request displays the account information for
50 \fIloginid\fR, if found\&.
52 If two arguments are provided,
55 \fIloginid\fR\*(Aqs existing password\&.
57 If three arguments are provided,
58 \fIloginid\fR\*(Aqs password is changed to
59 \fInewpassword\fR, but only if
61 matches the existing psasword\&.
63 These three basic authentication requests can be used to troubleshoot the authentication library\*(Aqs configuration\&.