release
[hcoop/debian/courier-authlib.git] / authtest.html
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.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"/><!--
3
4 Copyright 1998 - 2007 Double Precision, Inc. See COPYING for distribution
5 information.
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="id315812" shape="rect"> </a><h2>DESCRIPTION</h2><p>
8 <span class="command"><strong>authtest</strong></span> is a command-line diagnostic utility for the
9 Courier Authentication Library.
10 <span class="command"><strong>authtest</strong></span> requires at least one argument:
11 <em class="replaceable"><code>loginid</code></em>.
12 <span class="command"><strong>authtest</strong></span> sends the authentication request to the
13 Courier Authentication Library, then displays the results.
14 Only root may use
15 <span class="command"><strong>authtest</strong></span> utility, and the
16 Courier Authentication Library daemon
17 (<span class="command"><strong>authdaemond</strong></span>) must already be started.</p><p>
18 If only one argument is provided, the authentication request displays the
19 account information for <em class="replaceable"><code>loginid</code></em>, if found.</p><p>
20 If two arguments are provided,
21 <em class="replaceable"><code>password</code></em> must match
22 <em class="replaceable"><code>loginid</code></em>'s
23 existing password.</p><p>
24 If 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>
28 These three basic authentication requests can be used to troubleshoot
29 the authentication library's configuration.</p></div></div></body></html>