Return to dhdemo.txt CVS log

Up to [rsaref] / rsaref / doc

Annotation of rsaref/doc/dhdemo.txt, revision 1.1.1.1

1.1       root        1:                                DHDEMO:
                      2:     Demonstration program for Diffie-Hellman extensions to RSAREF
                      3:                             User's manual
                      4: 
                      5:                            RSA Laboratories
                      6:                             March 21, 1994
                      7: 
                      8:                              Version 2.0
                      9: 
                     10:     Copyright (C) 1993-4 RSA Laboratories, a division of RSA Data
                     11:                             Security, Inc.
                     12: 
                     13: 
                     14: This note describes DHDEMO, a program that demonstrates the
                     15: Diffie-Hellman part of the RSAREF cryptographic toolkit.
                     16: 
                     17: DHDEMO is a simple program that exercises the Diffie-Hellman
                     18: extensions to RSAREF. With DHDEMO users can perform the
                     19: Diffie-Hellman key agreements, as well as generating parameters.
                     20: 
                     21: DHDEMO has a main menu with four commands. The main menu is displayed
                     22: when you start up DHDEMO, and is displayed again after DHDEMO
                     23: performs a command. After you select a command DHDEMO prompts for
                     24: parameters such as file names.
                     25: 
                     26: DHDEMO's commands and their parameters are summarized in the
                     27: following table.
                     28: 
                     29: 
                     30:           DHDEMO COMMAND                       PARAMETERS
                     31: 
                     32: S - Set up key agreement        which parameters to use
                     33:   generate private value        length of private value
                     34:   compute public value          name of two files in which to save
                     35:     from private value            public, private values
                     36: 
                     37: C - Compute agreed-upon key     which parameters to use
                     38:   compute Diffie-Hellman        name of two files in which other
                     39:     key from private value,       party's public value, and private  
                     40:     other party's public          value are saved
                     41:     value                       name of file in which to save agreed-
                     42:                                   upon key
                     43: 
                     44: G - Generate parameters         length of prime in bits (16-1024)
                     45:   generate Diffie-Hellman       length of "subprime" in bits
                     46:     prime and generator         name of file in which to save
                     47:                                   parameters
                     48: 
                     49: Q - Quit
                     50: 
                     51: 
                     52: NOTES
                     53: 
                     54:   1. You select parameters by number: '1' or '2'. The first parameters
                     55:      are built in. The second is the one generated by DHDEMO's 'Generate
                     56:      parameters' command. The second parameters are not active until
                     57:      they are generated.
                     58: 
                     59:   2. How you specify file names to DHDEMO depends on your operating
                     60:      system. DHDEMO recognizes the special file name '-' as the
                     61:      standard output stream (typically the screen display). You can
                     62:      usually cancel an DHDEMO command by giving a blank line in
                     63:      response to a prompt for a parameter.
                     64: 
                     65:   3. DHDEMO reads and writes all files except the parameters file
                     66:      (which it only writes) in binary mode.
                     67: 
                     68:   4. If you want DHDEMO not to display the main menu or any prompts,
                     69:      put the string '-s' on the command line when you start DHDEMO.
                     70:      This is useful when DHDEMO's input stream comes from a script
                     71:      file.
                     72: 
                     73:   5. DHDEMO seeds RSAREF's random number generator with a fixed value.
                     74:      As a result, DHDEMO sessions with the same commands and
                     75:      parameters produce the same results. The use of a fixed seed
                     76:      value is not recommended for non-demonstration applications.
                     77: 
                     78:   6. Two test scripts exercise DHDEMO's commands. '512dh.in' uses
                     79:      the built-in parameters to agree on a key; the resulting files
                     80:      '512dha.key' and '512dhb.key' should match. '256dh.in' generates
                     81:      new parameters, then agrees on a key. It writes the parameters
                     82:      to the file '256dh.par'. You can compare the results against
                     83:      reference files in the 'rdemo/scripts' directory.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.