gsk_get_cipher

Returns the supported cipher specifications.

Format

   #include <gskssl.h>

   gsk_status gsk_get_cipher_info(
                                   int                 level
                                   gsk_sec_level *     sec_level,              
                                   void *              rsvd)

Parameters

level: Specifies GSK_LOW_SECURITY to return just the export cipher specifications or GSK_HIGH_SECURITY to return the United States only cipher specifications including the export cipher specifications.
sec_level: Returns the cipher specifications.
rsvd: Reserved for future use. Specify NULL for this parameter.

Results

The function return value will be 0 (GSK_OK) if no error is detected. Otherwise, it will be one of the return codes listed in the gskssl.h include file. This is a possible error:

[GSK_BAD_PARAMETER]: The level value is not valid or a NULL address is specified for sec_level.

Usage

The gsk_get_cipher_info() routine returns the available cipher specifications. Both United States only and export ciphers will be included if GSK_HIGH_SECURITY is specified while only export ciphers will be included if GSK_LOW_SECURITY is specified. The gsk_get_cipher_info() routine can be called at any time and does not require the gsk_initialize() routine to be called first.

The SSL V2 cipher specifications returned for GSK_HIGH_SECURITY are "713642" while the SSL V3 cipher specifications are "050435363738392F303132330A1613100D0915120F0C0306020100" if not in FIPS mode, and "35363738392F303132330A1613100D" in FIPS mode. If the Security Level 3 FMID is not installed, the SSL V2 cipher specifications are "642", the SSL V3 cipher specifications are "0915120F0C0306020100" and FIPS mode is not supported.

The SSL V2 cipher specifications returned for GSK_LOW SECURITY are "642" while the SSL V3 cipher specifications are "0915120F0C0306020100" in non-FIPS mode and "" in FIPS mode.

Format

Parameters

Results

Usage

Related Topics