DONKEY(1)																 DONKEY(1)

NAME

       donkey - alternative for S/KEY's "key" command.

SYNOPSIS

       donkey [options] sequence seed
       donkey -i

       key [option] sequence seed
       key -i

DESCRIPTION

       This  manual  page  documents  briefly  the  donkey,  and 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

       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;

	      kazu 0099 al02004 	 115d83956f1089b6  Apr 26,1995 22:13:27

       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.

OPTIONS

       A summary of options are included below.

       -n     num specify number of keys to be calculated.

       -f     func choose hash function from MD2 , MD4 , and MD5

EXAMPLES

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

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

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

	      % 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

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

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

	      % 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

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

   (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.

	      % 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

BUGS

       Things to do:

       Support other one time passwords such as OTP.

       Support other secure hash functions.

AUTHOR

       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).

								  October 4, 1995							 DONKEY(1)