Imported Upstream version 0.66.1
[hcoop/debian/courier-authlib.git] / authtest.html
CommitLineData
d9898ee8 1<?xml version="1.0"?>
b0322a85 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" type="text/css" href="style.css"/><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"/><link rel="home" 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
b0322a85 4Copyright 1998 - 2009 Double Precision, Inc. See COPYING for distribution
d9898ee8 5information.
6
b0322a85 7--></head><body><div class="refentry"><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"><a id="idm247858422432" shape="rect"> </a><h2>DESCRIPTION</h2><p>
8d138742 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>