summaryrefslogtreecommitdiffstats
path: root/src/pam_rps.8.in
diff options
context:
space:
mode:
authorNalin Dahyabhai <nalin@dahyabhai.net>2010-04-29 12:38:03 -0400
committerNalin Dahyabhai <nalin@dahyabhai.net>2010-04-29 12:38:03 -0400
commit2d98af25d3968223e27c3f438013bd12beaffe1f (patch)
tree0b0aaff548b0175397600fb900323a5ddbbffd14 /src/pam_rps.8.in
parent25304d87f30ebcc5f6382f89d5f99b498dd7ceef (diff)
downloadpam_rps-2d98af25d3968223e27c3f438013bd12beaffe1f.tar.gz
pam_rps-2d98af25d3968223e27c3f438013bd12beaffe1f.tar.xz
pam_rps-2d98af25d3968223e27c3f438013bd12beaffe1f.zip
- okay, the basic stuff is working again
- add "best_of" - add options to control conversation semantics - add "echo" option
Diffstat (limited to 'src/pam_rps.8.in')
-rw-r--r--src/pam_rps.8.in33
1 files changed, 23 insertions, 10 deletions
diff --git a/src/pam_rps.8.in b/src/pam_rps.8.in
index a6e1990..111236e 100644
--- a/src/pam_rps.8.in
+++ b/src/pam_rps.8.in
@@ -1,29 +1,42 @@
-.TH pam_rps 8 2010/4/20 "Red Hat Linux" "System Administrator's Manual"
+.TH pam_rps 8 2010/4/29 "Red Hat Linux" "System Administrator's Manual"
.SH NAME
pam_rps \- challenge-response authentication
.SH SYNOPSIS
-.B auth sufficient pam_rps.so
+.B auth required pam_rps.so
.SH DESCRIPTION
pam_rps.so is designed to provide an easy-to-test challenge-response
authentication mechanism for PAM-enabled applications.
Without pam_rps, successful authentication can only occur for a user if the
-user has previously established an authentication token for use with the
-server. Using pam_rps removes this limitation.
+user has previously established some sort of means of authenticating to the
+local system or a trusted server. Using pam_rps removes this limitation.
.SH ARGUMENTS
.IP debug
-Enable module debugging. The module will log its progress to syslog.
-.IP throw=\fInumber\fP
-The challenge issued to the user is derived from a random number. This
-argument allows the administrator to control which challenge will be presented
-to the user. This argument is meant for use only when debugging.
+Enable module debugging. The module will log its progress to syslog with
+"debug" priority.
+
+.IP best_of=\fInumber\fP
+The user will be issued multiple challenges, and must "win" against more than
+one half of them. If the supplied number is not odd, it will be incremented.
+
+.IP echo
+Signal to the calling application that the user should be able to see
+the response as it is being typed in.
+
+.IP sun
+Follow the conversation conventions consistent with Solaris PAM and not
+Linux-PAM. The default is to attempt to accomodate both.
+
+.IP linux
+Follow the conversation conventions consistent with Linux-PAM and not
+Solaris PAM. The default is to attempt to accomodate both.
.SH NOTES
-Never use this module.
+Do not use this module in production.
.SH BUGS
Let's hope not, but if you find any, please report them via the "Bug Track"