.tr ~
.TH POPKEY 1  "22 February 1992"
.SH NAME
popkey  -  One-time password generator for the
.SM S/KEY
system.
.SH SYNOPSIS
.PP
.B popkey [d]
.fi
.SH DESCRIPTION
The \s-1S/KEY\u\s-4TM\s0\d\s+1 one-time password system is used to
protect host systems from potential intruders who might capture
passwords by eavesdropping on networks.  The \s-1S/KEY\s0 system
works by using a sequence of one-time passwords that are generated
by a single secret key known only to the user.
.sp
.B popkey
is a \s-1DOS\s0 program that works with any terminal emulator
and computes the required one-time password.  The
.B popkey
command plants a Terminate and Stay Resident (\s-1TSR\s0) program
that prompts the user to define a 
.B "hot key"
that will activate the program during the
.B login
process. If the argument
.B d
is specified, the default value of \s-1ALT-F10\s0 is used as the hot-key.
.sp
The user activates the program by pressing the hot-key when requested
by the system to enter the \s-1S/KEY\s0 one-time password. When
.B popkey
is activated, it performs the following steps:
.sp
.in +2
Scan the screen for the \s-1S/KEY\s0 prompt.  If the prompt is found,
the \fIseed\fP and \fIcount\fP fields from that prompt are used.  Otherwise
a window pops up to request this information.
.sp
The user is prompted to supply the secret password in a popped up window.
.sp
The one-time password is calculated and is placed in a popped up window
for the user to copy.
.SH SEE ALSO
.BR key(1),
.BR ctkey(1)
.SH BUGS
There is no way to remove the
.SM TSR
from memory other than re-booting the system.  As with any
.SM TSR,
there is a potential for conflict with other memory resident programs.
.SH AUTHOR
Written by Neil Haller based on the \fBkey\fP command the original
version of which was written by Phil Karn and John Walden.