X-Git-Url: https://git.hcoop.net/hcoop/debian/courier-authlib.git/blobdiff_plain/2c58f61c7faca7723da35ffd7924af764108e9fd..4bc1ba6f5ecc4e62b1cd99eec25a9a0f510a3d70:/authtest.1 diff --git a/authtest.1 b/authtest.1 index d485856..57d34c6 100644 --- a/authtest.1 +++ b/authtest.1 @@ -1,48 +1,63 @@ -.\" +'\" t .\" .\" .\" Title: authtest -.\" Author: -.\" Generator: DocBook XSL Stylesheets v1.73.2 -.\" Date: 08/23/2008 +.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] +.\" Generator: DocBook XSL Stylesheets v1.78.1 +.\" Date: 06/20/2015 .\" Manual: Double Precision, Inc. .\" Source: Double Precision, Inc. +.\" Language: English .\" -.TH "AUTHTEST" "1" "08/23/2008" "Double Precision, Inc." "Double Precision, Inc." +.TH "AUTHTEST" "1" "06/20/2015" "Double Precision, Inc." "Double Precision, Inc." +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- .SH "NAME" -authtest - Test the Courier Authentication Library +authtest \- Test the Courier Authentication Library .SH "SYNOPSIS" -.HP 9 +.HP \w'\fBauthtest\fR\ 'u \fBauthtest\fR {loginid} [password] [newpassword] .SH "DESCRIPTION" .PP - \fBauthtest\fR -is a command\-line diagnostic utility for the Courier Authentication Library\. +is a command\-line diagnostic utility for the Courier Authentication Library\&. \fBauthtest\fR requires at least one argument: -\fIloginid\fR\. +\fIloginid\fR\&. \fBauthtest\fR -sends the authentication request to the Courier Authentication Library, then displays the results\. Only root may use +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\. +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\. +\fIloginid\fR, if found\&. .PP If two arguments are provided, \fIpassword\fR must match -\fIloginid\fR\'s existing password\. +\fIloginid\fR\*(Aqs existing password\&. .PP If three arguments are provided, -\fIloginid\fR\'s password is changed to +\fIloginid\fR\*(Aqs password is changed to \fInewpassword\fR, but only if \fIpassword\fR -matches the existing psasword\. +matches the existing psasword\&. .PP -These three basic authentication requests can be used to troubleshoot the authentication library\'s configuration\. +These three basic authentication requests can be used to troubleshoot the authentication library\*(Aqs configuration\&.