Return to dhdemo.txt CVS log

Up to [rsaref] / rsaref / doc

Annotation of rsaref/doc/dhdemo.txt, revision 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.