gsk_get_all_cipher

Returns the available SSL cipher suites.

Format

   #include <gskssl.h>

   gsk_status gsk_get_all_cipher_suites (
                                           gsk_all_cipher_suites *     cipher_suites)

Parameters

cipher_suites: Returns the runtime version, release, security level, and cipher suites.

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. These are some possible errors:

[GSK_ERR_STRUCTURE_TOO_SMALL]: Size specified for supplied structure is too small.

Usage

The gsk_get_all_cipher_suites() routine returns the System SSL runtime version, release, security level, and available cipher suites. The current System SSL run time is Version 4 Release 1. The cipher suites are static null-terminated character strings which must not be modified or freed by the application. The available cipher suites for protocols SSL V3.0, TLS V1.0, and higher are returned in both 2-character and 4-character formats.

The cipher lists include all supported ciphers. As new ciphers are added, the lists will be modified to contain the newly added ciphers. The adding of ciphers may cause cipher selection to be modified as new ciphers are added, and different ciphers to be selected if the lists are being used as the cipher list strings.

If executing in FIPS mode, the cipher suites are those that meet FIPS 140-2 criteria. For more information about the FIPS cipher suites, see gsk_environment_open().

The application must initialize the size field in the gsk_all_cipher_suites structure to the size of the gsk_all_ciphers_suites structure before using this function.