<!-- Copyright 2004 Double Precision, Inc. See COPYING for -->
<!-- distribution information. -->
Title: authtest
Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
Date: 10/28/2020
Manual: Double Precision, Inc.
Source: Double Precision, Inc.
Language: English
* Define some portability stuff
-----------------------------------------------------------------
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
http://bugs.debian.org/507673
http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-----------------------------------------------------------------
* set default formatting
-----------------------------------------------------------------
disable hyphenation
disable justification (adjust text to left margin only)
-----------------------------------------------------------------
* MAIN CONTENT STARTS HERE *
-----------------------------------------------------------------
\w'authtest 'u authtest {loginid} [password] [newpassword]
authtest is a command-line diagnostic utility for the Courier Authentication Library. authtest requires at least one argument: loginid. authtest sends the authentication request to the Courier Authentication Library, then displays the results. Only root may use authtest utility, and the Courier Authentication Library daemon (authdaemond) must already be started.
If only one argument is provided, the authentication request displays the account information for loginid, if found.
If two arguments are provided, password must match loginid\*(Aqs existing password.
If three arguments are provided, loginid\*(Aqs password is changed to newpassword, but only if password matches the existing password.
These three basic authentication requests can be used to troubleshoot the authentication library\*(Aqs configuration.