.tr ~
.TH TERMKEY 1  "2 September 1992"
.SH NAME
termkey \- S/KEY one-time password generator for terminal emulators on PCs
.SH SYNOPSIS
.PP
.B termkey
[
.B dhu
]
.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 Termkey
is a \s-1DOS\s0 program that works with terminal emulators
and computes the required one-time password.  The
.B termkey
command plants a Terminate and Stay Resident (\s-1TSR\s0) program
and, in the interactive mode (see option 
.B d
below), prompts the user to define a 
.B "hot-key"
that will activate that program during the
.B login
process.  The
.B termkey
.SM TSR
will refuse to load if a previous copy of
.B termkey
has been loaded.  To change the
.B hot-key,
the earlier copy of
.B termkey
must be unloaded (see the
. B u
option below) and a new copy initiated.
.sp
The user activates the program by pressing the 
.B hot-key
when requested by the system to enter the \s-1S/KEY\s0 one-time
password. When
.B termkey
is activated, it performs the following steps:
.sp
.TP
1.
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 from the user.
.sp
2.
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
3.
The one-time password is calculated, and inserted into the input stream.
As this program is normally activated when the host system is expecting the
.SM S/KEY
one-time password, it correctly reads this password.   As echo is normalled
disabled when reading passwords,
.B termkey
displays the one-time password.  Should echo be enabled, the one-time
password will appear twice.
.sp
.SH OPTIONS
.TP
.B d
Use the default value of
.SM ALT-F10
as the hot-key.
.TP
.B h
Display the list of options.
.TP
.B u
Unload the
.B termkey
.SM TSR.
Note that
.SM DOS
will only allow the unloading of the last
.SM TSR
to be loaded.
.sp
.SH SEE ALSO
.BR key(1),
.BR popkey(1),
.BR skey(1)
.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.