Copyright Digital Equipment Corp. All rights reserved.

Arguments

 

algorithm-name

   type:      char_string
   access:    read only
   mechanism: by descriptor
   The name of the algorithm that will use the generated key.
 

key-length

   type:      word unsigned
   access:    read only
   mechanism: by reference
   Unsigned integer indicating the size of the key to be generated.
   The key-length argument is the address of an unsigned word
   containing a value that indicates the length of the key.

   For AES, the key-length argument takes values as increments of
   AES block size: 16 bytes, 32, bytes, and 48 bytes, and so on.
 

factor-a, factor-b, factor-c

   type:      char_string
   access:    read only
   mechanism: by descriptor
   Optional arguments. The factor-a, factor-b, and factor-c
   arguments are operation-dependent data used as randomizing
   factors when the routine generates a key value. For example,
   the factors might be:

   o  Time an operation started

   o  Size of a certain stack

   o  Copy of the last command line
 

key-buffer

   type:      char_string
   access:    write
   mechanism: by descriptor
   Buffer into which the generated key is to be placed. The key-
   buffer argument is the address of a string descriptor referencing
   the appropriate buffer.

   If you specify a class D descriptor, dynamic memory is allocated
   to contain the entire key.