IBM 2 Computer Hardware User Manual


 
PKA_Public_Key_Hash_Register CCA Release 2.54
PKA_Public_Key_Hash_Register (CSNDPKH)
Platform/
Product
OS/2 AIX Win NT/
2000
OS/400
IBM 4758-2/23 X X X X
The PKA_Public_Key_Hash_Register verb is used to register a hash value for a
public key in anticipation of verifying the public key offered in a subsequent use of
the PKA_Public_Key_Register verb.
Restrictions
None
Format
CSNDPKH
return_code Output Integer
reason_code Output Integer
exit_data_length In/Output Integer
exit_data In/Output String exit_data_length bytes
rule_array_count Input Integer one or two
rule_array Input String
array
rule_array_count * 8 bytes
public_key_name Input String 64 bytes
hash_data_length Input Integer
hash_data Input String hash_data_length bytes
Parameters
For the definitions of the return_code, reason_code, exit_data_length, and exit_data
parameters, see “Parameters Common to All Verbs” on page 1-11.
rule_array_count
The rule_array_count parameter is a pointer to an integer variable containing
the number of elements in the rule_array variable. The value must be one or
two for this verb.
rule_array
The rule_array parameter is a pointer to a string variable containing an array of
keywords. The keywords are eight bytes in length, and must be left-justified
and padded on the right with space characters. The rule_array keywords are
shown below:
public_key_name
The public_key_name parameter is a pointer to a string variable containing the
name under which the registered public-key will be accessed.
Keyword Meaning
Hash type (required)
SHA-1 The hash algorithm used to create the hash value.
Special usage (optional)
CLONE Indicates that the public key associated with this hash value
can be employed in a CCA node-cloning process provided
that this usage is confirmed when the public key is registered.
3-26 IBM 4758 CCA Basic Services, Release 2.54, February 2005