.tr ~
.TH CTKEY 1  "22 February 1992"
.SH NAME
ctkey - One-time password generator for CTRM terminal emulator
.SH SYNOPSIS
.PP
.B ctkey [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 ctkey
is a \s-1DOS\s0 program that works with the \s-1CTRM\s0 terminal emulator
and computes the required one-time password.  The
.B ctkey
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 ctkey
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.  This step is omitted
if the file
.SM "C:\\\\CTRMWORD"
exists, in which case the first line of this file is used as the secret
password.
.sp
The one-time password is calculated and is placed on the line with the
current user prompt.  This is expected to follow the \s-1UNIX\s0
.B "Password:"
prompt.  The user is instructed to press the \fIinsert\fP key that
causes \s-1CTRM\s0 to transmit the one-time password to the host system.
.in
.SH SEE ALSO
.BR key(1),
.BR popkey(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.