.TH DONKEY 1 "October 4, 1995" "" ""
.\" NAME should be all caps, SECTION should be 1-8, maybe w/ subsection
.\" other parms are allowed: see man(7), man(1)
.SH NAME
donkey \- alternative for S/KEY's "key" command.
.SH SYNOPSIS
.B donkey
.I "[options] sequence seed"
.br
.B donkey
.I "\-i"
.P
.B key
.I "[option] sequence seed"
.br
.B key
.I "\-i"
.SH "DESCRIPTION"
.PP
This manual page documents briefly the
.BR donkey ,
and
.B key
commands.
This manual page was written for the Debian GNU/Linux distribution
because the original program does not have a manual page.
Instead, it has documentation in /usr/share/doc/donkey
.PP
.B donkey
is an alternative for S/KEY's "key" command. The new feature that
the original key doesn't have is print an entry for skeykeys as
follows;

.nf
.RS
kazu 0099 al02004          115d83956f1089b6  Apr 26,1995 22:13:27
.RE
.fi

This means that donkey is also an alternative for "keyinit". Since the
entry is printed to stdout (not to /etc/skeykeys), you can easily sent
it to remote operator by e-mail (with PGP signature or something). So,
it possible to initiate S/KEY without login from the console of the
host.

.SH OPTIONS
.PP
A summary of options are included below.
.TP
.B \-n
.I num
specify number of keys to be calculated.
.TP
.B \-f
.I func
choose hash function from 
.B MD2
, 
.B MD4
, and 
.B MD5
.

.SH EXAMPLES
.PP
.SS (1) Calculate an One-Time-Password.
Execute Donkey with sequence and seed, then input your passphrase.

.nf
.RS
% donkey 80 is12345
Enter passphrase : xxxxxxxxxxxxxxxxxxxxxxx
SOFT O SAW SWAB CON RODE
.RE
.fi

You can choose hash function from MD2, MD4, and MD5.

.nf
.RS
% donkey 80 is12345
Enter passphrase : xxxxxxxxxxxxxxxxxxxxxxx
SOFT O SAW SWAB CON RODE

%donkey \-f md5 80 is12345
Enter passphrase : xxxxxxxxxxxxxxxxxxxxxxx
LACK WIN ROSE ANNA STUN REEK
.RE
.fi

The default hash function is MD4 due to the historical reason.

.SS (2) Calculate some One-Time-Passwords at once.
Use \-n option.

.nf
.RS
% donkey \-n 10 80 is12345
Enter passphrase : xxxxxxxxxxxxxxxxxxxxxxx
71: WORE HELL CUB FAR DORA MALE  
72: SAIL DAN DONE BEER DAYS MOS  
73: PAN TONE THAT TOUT BURY EST  
74: KEN ROAM HEAT NAN MEAN HEN   
75: MINI MARS HASH BOTH SITU SING
76: TOW SHIN FLUE ARID AHOY NE   
77: SLID LEEK NO TREE STOW BEY   
78: RUDY WINE GIFT FUSS AGEE SUE 
79: GELD THIN MAID THIN BUD TURF 
80: SOFT O SAW SWAB CON RODE     
.RE
.fi

Note that though "Enter passphrase" is printed out to stderr,
One-Time-Passwords is to stdout. So, you can redirect the output
safely.

.SS (3) Print skeykeys entry.
Use \-i option without argments. Then, enter login name, sequence and
seed. If you like default value, just type RET. Input your passphrase
twice to get the entry.

.nf
.RS
% donkey \-i
Enter login name [default kazu]: 
Enter sequence 1 to 999 [default 99]: 
Enter new seed [default ur18122]: 
Please choose passphrase between 8 and 256 characters.
Enter passphrase : xxxxxxxxxxxxxxxxxxxxxxxxxxx
Re-enter passphrase : xxxxxxxxxxxxxxxxxxxxxxxxxxx
kazu 0099 ur18122          fc5b023e684968ff  Oct 02,1995 16:15:30
WINK SEAM GRAB ROAD HELL FEST
.RE
.fi

.SH BUGS
.PP
Things to do:
.TP
Support other one time passwords such as OTP.
.TP
Support other secure hash functions. 

.SH AUTHOR
.PP
This program is developed by Kazuhiko Yamamoto <kazu@is.aist\-nara.ac.jp>.
This manual page was written by Fumitoshi UKAI <ukai@debian.or.jp>,
based on documents of this program, for the Debian GNU/Linux system 
(but may be used by others).