Merge branch 'debian'
[hcoop/debian/courier-authlib.git] / authtest.html
CommitLineData
d9898ee8 1<?xml version="1.0"?>
8d138742 2<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/><title>authtest</title><link rel="stylesheet" href="style.css" type="text/css"/><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"/><link rel="start" href="#authtest" title="authtest"/><link xmlns="" rel="stylesheet" type="text/css" href="manpage.css"/><meta xmlns="" name="MSSmartTagsPreventParsing" content="TRUE"/><link xmlns="" rel="icon" href="icon.gif" type="image/gif"/><!--
d9898ee8 3
4Copyright 1998 - 2007 Double Precision, Inc. See COPYING for distribution
5information.
6
8d138742
CE
7--></head><body><div class="refentry" lang="en" xml:lang="en"><a id="authtest" shape="rect"> </a><div class="titlepage"/><div class="refnamediv"><h2>Name</h2><p>authtest — Test the Courier Authentication Library</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">authtest</code> {loginid} [password] [newpassword]</p></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="id315812" shape="rect"> </a><h2>DESCRIPTION</h2><p>
8<span class="command"><strong>authtest</strong></span> is a command-line diagnostic utility for the
d9898ee8 9Courier Authentication Library.
8d138742 10<span class="command"><strong>authtest</strong></span> requires at least one argument:
d9898ee8 11<em class="replaceable"><code>loginid</code></em>.
8d138742 12<span class="command"><strong>authtest</strong></span> sends the authentication request to the
d9898ee8 13Courier Authentication Library, then displays the results.
14Only root may use
8d138742 15<span class="command"><strong>authtest</strong></span> utility, and the
d9898ee8 16Courier Authentication Library daemon
8d138742 17(<span class="command"><strong>authdaemond</strong></span>) must already be started.</p><p>
d9898ee8 18If only one argument is provided, the authentication request displays the
19account information for <em class="replaceable"><code>loginid</code></em>, if found.</p><p>
20If two arguments are provided,
21<em class="replaceable"><code>password</code></em> must match
22<em class="replaceable"><code>loginid</code></em>'s
23existing password.</p><p>
24If three arguments are provided,
25<em class="replaceable"><code>loginid</code></em>'s password is changed to
26<em class="replaceable"><code>newpassword</code></em>, but only if
27<em class="replaceable"><code>password</code></em> matches the existing psasword.</p><p>
28These three basic authentication requests can be used to troubleshoot
29the authentication library's configuration.</p></div></div></body></html>