authtest.1

   1 .\"  <!-- $Id: authtest.sgml,v 1.4 2007/04/22 15:05:16 mrsam Exp $ -->
   2 .\"  <!-- Copyright 2004 Double Precision, Inc.  See COPYING for -->
   3 .\"  <!-- distribution information. -->
   4 .\"     Title: authtest
   5 .\"    Author:
   6 .\" Generator: DocBook XSL Stylesheets v1.72.0 <http://docbook.sf.net/>
   7 .\"      Date: 04/22/2007
   8 .\"    Manual: Double Precision, Inc.
   9 .\"    Source: Double Precision, Inc.
  10 .\"
  11 .TH "AUTHTEST" "1" "04/22/2007" "Double Precision, Inc." "Double Precision, Inc."
  12 .\" disable hyphenation
  13 .nh
  14 .\" disable justification (adjust text to left margin only)
  15 .ad l
  16 .SH "NAME"
  17 authtest \- Test the Courier Authentication Library
  18 .SH "SYNOPSIS"
  19 .HP 9
  20 \fBauthtest\fR {loginid} [password] [newpassword]
  21 .SH "DESCRIPTION"
  22 .PP
  23
  24 \fBauthtest\fR
  25 is a command\-line diagnostic utility for the Courier Authentication Library.
  26 \fBauthtest\fR
  27 requires at least one argument:
  28 \fIloginid\fR.
  29 \fBauthtest\fR
  30 sends the authentication request to the Courier Authentication Library, then displays the results. Only root may use
  31 \fBauthtest\fR
  32 utility, and the Courier Authentication Library daemon (\fBauthdaemond\fR) must already be started.
  33 .PP
  34 If only one argument is provided, the authentication request displays the account information for
  35 \fIloginid\fR, if found.
  36 .PP
  37 If two arguments are provided,
  38 \fIpassword\fR
  39 must match
  40 \fIloginid\fR's existing password.
  41 .PP
  42 If three arguments are provided,
  43 \fIloginid\fR's password is changed to
  44 \fInewpassword\fR, but only if
  45 \fIpassword\fR
  46 matches the existing psasword.
  47 .PP
  48 These three basic authentication requests can be used to troubleshoot the authentication library's configuration.