System i: Programming Secure Sockets APIs - IBM

The gsk_strerror() function is used to retrieve an error message and associated text string that describes a
return value that was returned from calling a GSKit API.
Parameters
gsk_return_value (Input)
The return value received from a GSKit API.
Authorities
No authorization is required.
Return Value
gsk_strerror() returns a pointer to the return value text.
Usage Notes
1. gsk_strerror() returns a pointer to the string. The null-terminated string is stored in the CCSID of the
job.
2. If a gsk_return_value is specified for which there is no corresponding description, an Unknown Error
string is returned.
Related Information
v “gsk_attribute_get_buffer()—Get character information about a secure session or an SSL environment”
on page 3—Get character information about a secure session or an SSL environment.
v “gsk_attribute_get_cert_info()—Get information about a local or partner certificate” on page 6—Get
information about a local or partner certificate.
v “gsk_attribute_get_enum()—Get enumerated information about a secure session or an SSL
environment” on page 10—Get enumerated information about a secure session or an SSL environment.
v “gsk_attribute_get_numeric_value()—Get numeric information about a secure session or an SSL
environment” on page 14—Get numeric information about a secure session or an SSL environment.
v “gsk_attribute_set_buffer()—Set character information for a secure session or an SSL environment” on
page 16—Set character information for a secure session or an SSL environment.
v “gsk_attribute_set_enum()—Set enumerated information for a secure session or an SSL environment”
on page 24—Set enumerated information for a secure session or an SSL environment.
v “gsk_attribute_set_numeric_value()—Set numeric information for a secure session or an SSL
environment” on page 28—Set numeric information for a secure session or an SSL environment
v “gsk_environment_close()—Close an SSL environment” on page 30—Close the SSL environment
v “gsk_environment_init()—Initialize an SSL environment” on page 32—Initialize a SSL environment
v “gsk_environment_open()—Get a handle for an SSL environment” on page 34—Get a handle for an
SSL environment
v “gsk_secure_soc_close()—Close a secure session” on page 37—Close a secure session
v “gsk_secure_soc_init()—Negotiate a secure session” on page 38—Negotiate a secure session
v “gsk_secure_soc_misc()—Perform miscellaneous functions for a secure session” on page 41—Perform
miscellaneous functions for a secure session
v “gsk_secure_soc_open()—Get a handle for a secure session” on page 44—Get a handle for a secure
session
v “gsk_secure_soc_read()—Receive data on a secure session” on page 46—Receive data on a secure
session
v “gsk_secure_soc_write()—Send data on a secure session” on page 60—Send data on a secure session
Secure Sockets APIs 63