z/OS Open Cryptographic Services Facility Application Programming
Previous topic | Next topic | Contents | Index | Contact z/OS | Library | PDF


CSSM_CONTEXT_ATTRIBUTE

z/OS Open Cryptographic Services Facility Application Programming
SC24-5899-01 

typedef struct cssm_context_attribute{
    uint32 AttributeType;
    uint32 AttributeLength;
    union {
        char *String;
        uint32 Uint32;
        CSSM_CRYPTO_DATA_PTR Crypto;
        CSSM_KEY_PTR Key;
        CSSM_DATA_PTR Data;
        CSSM_DATE_PTR Date;
        CSSM_RANGE_PTR Range;
        CSSM_VERSION_PTR Version;
        CSSM_KR_PROFILE_PTR KRProfile; 
    } Attribute;
} CSSM_CONTEXT_ATTRIBUTE, *CSSM_CONTEXT_ATTRIBUTE_PTR;

Definitions:

AttributeType
An identifier describing the type of attribute. Valid attribute types are as follows in Table 26.
Table 26. Attribute Types
ValueDescriptionData Type
CSSM_ATTRIBUTE_NONENo attributeNone
CSSM_ATTRIBUTE_CUSTOMCustom dataOpaque pointer
CSSM_ATTRIBUTE_DESCRIPTIONDescription of attributeString
CSSM_ATTRIBUTE_KEYKey DataCSSM_KEY
CSSM_ATTRIBUTE_INIT_VECTORInitialization vectorCSSM_DATA
CSSM_ATTRIBUTE_SALTSaltCSSM_DATA
CSSM_ATTRIBUTE_PADDINGPadding informationuint32
CSSM_ATTRIBUTE_RANDOMRandom dataCSSM_DATA
CSSM_ATTRIBUTE_SEEDSeedCSSM_CRYPTO_DATA
CSSM_ATTRIBUTE_PASSPHRASEPassphraseCSSM_CRYPTO_DATA
CSSM_ATTRIBUTE_KEY_LENGTHKey length specified in bitsuint32
CSSM_ATTRIBUTE_KEY_LENGTH_RANGEKey length range specified in bitsCSSM_RANGE
CSSM_ATTRIBUTE_BLOCK_SIZEBlock sizeuint32
CSSM_ATTRIBUTE_OUTPUT_SIZEOutput sizeuint32
CSSM_ATTRIBUTE_ROUNDSNumber of runs or roundsuint32
CSSM_ATTRIBUTE_IV_SIZESize of initialization vectoruint32
CSSM_ATTRIBUTE_ALG_PARAMSAlgorithm parametersCSSM_DATA
CSSM_ATTRIBUTE_LABELLabel placed on an object when it is createdCSSM_DATA
CSSM_ATTRIBUTE_KEY_TYPEType of key to generate or deriveuint32
CSSM_ATTRIBUTE_MODEAlgorithm mode to use for encryptionuint32
CSSM_ATTRIBUTE_EFFECTIVE_BITSNumber of effective bits used in the RC2 cipheruint32
CSSM_ATTRIBUTE_START_DATEStarting date for an object's validityCSSM_DATE
CSSM_ATTRIBUTE_END_DATEEnding date for an object's validityCSSM_DATE
CSSM_ATTRIBUTE_KEYUSAGEKey usageuint32
CSSM_ATTRIBUTE_KEYATTRKey attributesuint32
CSSM_ATTRIBUTE_VERSIONObject versionCSSM_VERSION
CSSM_ATTRIBUTE_ALG_IDAlgorithm IDuint32
CSSM_ATTRIBUTE_ITERATION_COUNTNumber of iterationsuint32
CSSM_ATTRIBUTE_ROUNDS_RANGEMinimum and maximum number of roundsCSSM_RANGE
CSSM_ATTRIBUTE_KRPROFILE_LOCALKey Recovery Profile for the local userCSSM_KR_PROFILE
CSSM_ATTRIBUTE_KRPROFILE_REMOTEKey Recovery Profile for the remote userCSSM_KR_PROFILE

The data referenced by a CSSM_ATTRIBUTE_CUSTOM attribute must be a single continuous memory block. This allows the OCSF to appropriately release all dynamically allocated memory resources.

Definitions:

AttributeLength
Length of the attribute data.
Attribute
Union representing the attribute data. The union member used is named after the type of data contained in the attribute. See Table 26 for the data types associated with each attribute type.

Go to the previous page Go to the next page

Notices | Terms of use | Support | Contact z/OS | zFavorites



Copyright IBM Corporation 1990, 2014