RSA Security 5 manual AIRC2CBCPadPEM

AI_RC2_CBCPadPEM

AI_RC2_CBCPadPEM

Purpose:

This AI is similar to AI_RC2_CBCPad except that it uses the Privacy Enhanced Mail (PEM) format. This AI allows you to parse and create PEM algorithm identifiers such as used in PEM protocol. You call B_SetAlgorithmInfo to initialize an algorithm object from the encoded algorithm identifier, which includes PEM encoding of the A_RC2_CBC_PARAMS structure defined in the description of AI_RC2_CBCPad. You call B_GetAlgorithmInfo with this AI to create an encoded algorithm identifier from an algorithm object that was created using AI_RC2_CBCPad, AI_RC2_CBCPadBER, or AI_RC2_CBCPadPEM.

Type of information this allows you to use:

an RFC 1423-style identifier that specifies the RC2-CBC With Padding encryption algorithm. This algorithm info type is intended to process the value of a DEK-Info field in a PEM-encapsulated header.

Format of info supplied to B_SetAlgorithmInfo:

pointer to a null-terminated string (char *) that gives the RC2-CBC identifier and parameters. For example, “RC2-CBC,BAgRIjNEVWZ3iA==”. Space and tab characters are removed from the string before it is copied to the algorithm object. B_SetAlgorithmInfo returns BE_WRONG_ALGORITHM_INFO if the algorithm identifier specifies an identifier other than RC2-CBC.

Format of info returned by B_GetAlgorithmInfo:

pointer to a null-terminated string that gives the RC2-CBC identifier and parameters.

Crypto-C procedures to use with algorithm object:

B_EncryptInit, B_EncryptUpdate, B_EncryptFinal, B_DecryptInit,

B_DecryptUpdate, and B_DecryptFinal. You may pass (B_ALGORITHM_OBJ)NULL_PTR for all randomAlgorithm arguments.

Algorithm methods to include in application’s algorithm chooser:

AM_RC2_CBC_ENCRYPT for encryption and AM_RC2_CBC_DECRYPT for decryption.

1 8 6 R S A B S A F E C r y p t o - C L i b r a r y R e f e r e n c e M a n u a l