File: authtest.1

package info (click to toggle)
courier-authlib 0.58-4%2Betch3
  • links: PTS
  • area: main
  • in suites: etch
  • size: 16,212 kB
  • ctags: 1,896
  • sloc: ansic: 21,550; sh: 14,071; makefile: 866; perl: 842; cpp: 284
file content (44 lines) | stat: -rw-r--r-- 1,608 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
.\"  <!-- $Id: authtest.sgml,v 1.1 2005/07/13 00:54:22 mrsam Exp $ -->
.\"  <!-- Copyright 2004 Double Precision, Inc.  See COPYING for -->
.\"  <!-- distribution information. -->
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "AUTHTEST" "1" "15 July 2005" "Double Precision, Inc." ""

.SH NAME
authtest \- Test the Courier Authentication Library
.SH SYNOPSIS

\fBauthtest\fR \fBloginid\fR [ \fBpassword\fR ] [ \fBnewpassword\fR ]

.SH "DESCRIPTION"
.PP
\fBauthtest\fR is a command-line diagnostic utility for the
Courier Authentication Library.
\fBauthtest\fR requires at least one argument:
\fIloginid\fR\&.
\fBauthtest\fR sends the authentication request to the
Courier Authentication Library, then displays the results.
Only root may use
\fBauthtest\fR utility, and the
Courier Authentication Library daemon
(\fBauthdaemond\fR) must already be started.
.PP
If only one argument is provided, the authentication request displays the
account information for \fIloginid\fR, if found.
.PP
If two arguments are provided, 
\fIpassword\fR must match
\fIloginid\fR\&'s
existing password.
.PP
If three arguments are provided,
\fIloginid\fR\&'s password is changed to
\fInewpassword\fR, but only if
\fIpassword\fR matches the existing psasword.
.PP
These three basic authentication requests can be used to troubleshoot
the authentication library's configuration.