Imported Debian patch 0.60.1-1
[hcoop/debian/courier-authlib.git] / authtest.html
CommitLineData
d9898ee8 1<?xml version="1.0"?>
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.72.0"/><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"/><!--
3
4Copyright 1998 - 2007 Double Precision, Inc. See COPYING for distribution
5information.
6
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="id281711" shape="rect"> </a><h2>DESCRIPTION</h2><p>
8<span><strong class="command">authtest</strong></span> is a command-line diagnostic utility for the
9Courier Authentication Library.
10<span><strong class="command">authtest</strong></span> requires at least one argument:
11<em class="replaceable"><code>loginid</code></em>.
12<span><strong class="command">authtest</strong></span> sends the authentication request to the
13Courier Authentication Library, then displays the results.
14Only root may use
15<span><strong class="command">authtest</strong></span> utility, and the
16Courier Authentication Library daemon
17(<span><strong class="command">authdaemond</strong></span>) must already be started.</p><p>
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>