Return to rdemo.txt CVS log

Up to [rsaref] / rsaref / doc

Annotation of rsaref/doc/rdemo.txt, revision 1.1

1.1     ! root        1:                                 RDEMO:
        !             2:                    Demonstration program for RSAREF
        !             3:                             User's manual
        !             4: 
        !             5:                            RSA Laboratories
        !             6:                             March 2, 1992
        !             7: 
        !             8:     Copyright (C) 1991-2 RSA Laboratories, a division of RSA Data
        !             9:                             Security, Inc.
        !            10: 
        !            11: 
        !            12: This note describes RDEMO, a demonstration program included with the
        !            13: RSAREF cryptographic toolkit.
        !            14: 
        !            15: RDEMO is a simple program that exercises RSAREF's cryptographic
        !            16: operations. With RDEMO three "users" can perform the cryptographic
        !            17: operations of signing, sealing, verifying, and opening files, as well
        !            18: as generating key pairs.
        !            19: 
        !            20: RDEMO has a main menu with six commands. The main menu is displayed
        !            21: when you start up RDEMO, and is displayed again after RDEMO performs
        !            22: a command. After you select a command RDEMO prompts for parameters
        !            23: such as file names.
        !            24: 
        !            25: RDEMO's commands and their parameters are summarized in the following
        !            26: table.
        !            27: 
        !            28: 
        !            29:           RDEMO COMMAND                       PARAMETERS
        !            30: 
        !            31: S - Sign a file                 name of file
        !            32:   sign contents with private    whether you want content encoded
        !            33:     key                         which user you want to sign as
        !            34:   optionally encode contents    name of file in which to save
        !            35:     in PEM character set(*)       signature
        !            36:                                 name of file in which to save encoded
        !            37:                                   content(**)
        !            38: 
        !            39: E - sEal a file                 name of file
        !            40:   sign contents with private    which user you want to sign as
        !            41:     key                         which user you want to seal for
        !            42:   generate random DES key       names of four files in which to save
        !            43:     IV(***)                       encrypted signature, encrypted key,
        !            44:   encrypt content, signature      IV and encrypted content
        !            45:     with DES key         
        !            46: 
        !            47: V - Verify a signed file        whether content is encoded
        !            48:   decode contents if encoded    names of two files in which (possibly
        !            49:     in PEM character set          encoded) content and signature are
        !            50:   verify signature on             saved
        !            51:     contents with public key    which user signed the file
        !            52:                                 name of file in which to save
        !            53:                                   recovered content(**)
        !            54: 
        !            55: O - Open a sealed file          names of four files in which encrypted
        !            56:   decrypt encrypted DES key       content, encrypted signature,
        !            57:     with private key,             encrypted key and IV are saved
        !            58:   decrypt encrypted content     which user signed the file
        !            59:     signature with DES key      which user the file was sealed for
        !            60:   verify signature on           name of file in which to save
        !            61:     contents with public key      recovered content
        !            62: 
        !            63: G - Generate a keypair          length of key in bits (508-1024)
        !            64:   generate RSA public/          name of file in which to save key pair
        !            65:     private key pair
        !            66: 
        !            67: Q - Quit
        !            68: 
        !            69: 
        !            70: (*) A 65-character subset of ASCII defined in RFC 1113. Most other
        !            71:     quantities are encoded in this set automatically.
        !            72: (**) Only if content is encoded.
        !            73: (***) Initialization vector for cipher-block chaining mode of DES.
        !            74: 
        !            75: 
        !            76: NOTES
        !            77: 
        !            78:   1. You select a user by number: '1', '2', or '3'. The first two
        !            79:      users have built-in RSA key pairs. The third user's key pair is
        !            80:      the one generated by RDEMO's 'Generate a key pair' command. The
        !            81:      third user is not active until the key pair is generated.
        !            82: 
        !            83:   2. How you specify file names to RDEMO depends on your operating
        !            84:      system. RDEMO recognizes the special file name '-' as the
        !            85:      standard output stream (typically the screen display). You can
        !            86:      usually cancel an RDEMO command by giving a blank line in
        !            87:      response to a prompt for a parameter.
        !            88: 
        !            89:   3. RDEMO reads most files and writes all files in binary mode. The
        !            90:      only exceptions are the files containing contents to be signed
        !            91:      or sealed. Those files are read in text mode, one line at a
        !            92:      time, with RDEMO replacing any <CR> and <LF> delimiters with a
        !            93:      <CR><LF> pair before encrypting, computing a message digest, or
        !            94:      encoding in printable ASCII. The <CR><LF> processing compensates
        !            95:      for differences in line delimiters in different operating
        !            96:      systems. RDEMO has a maximum file size of 1000 bytes.
        !            97: 
        !            98:   4. RDEMO defaults to the MD5 message-digest algorithm for all
        !            99:      signatures. If you want the MD2 message-digest algorithm, put
        !           100:      the string '-2' on the command line when you start RDEMO.
        !           101: 
        !           102:   5. If you want RDEMO not to display the main menu or any prompts,
        !           103:      put the string '-s' on the command line when you start RDEMO.
        !           104:      This is useful when RDEMO's input stream comes from a script
        !           105:      file.
        !           106: 
        !           107:   6. RDEMO seeds RSAREF's random number generator with a fixed value.
        !           108:      As a result, RDEMO sessions with the same commands and
        !           109:      parameters produce the same results. The use of a fixed seed
        !           110:      value is not recommended for non-demonstration applications.

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