22.10.2013 Views

System i: Programming Secure Sockets APIs - IBM

System i: Programming Secure Sockets APIs - IBM

System i: Programming Secure Sockets APIs - IBM

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

Error Conditions<br />

When the gsk_attribute_set_callback() API fails with return code [GSK_ERROR_IO], errno can be set to:<br />

[EINTR]<br />

Interrupted function call.<br />

[EDEADLK]<br />

Resource deadlock avoided.<br />

[ETERM]<br />

Operation terminated.<br />

If an errno is returned that is not in this list, look in “Errno Values for UNIX-Type Functions” on page 103<br />

for a description of the errno.<br />

Usage Notes<br />

1. The following GSK_CALLBACK_ID values may be set in the SSL environment after<br />

gsk_environment_open() and before gsk_environment_init(). They are used as defaults for<br />

subsequent secure sessions:<br />

v GSK_ENVIRONMENT_CLOSE_CALLBACK<br />

v GSK_CERT_VALIDATION_CALLBACK<br />

2. The following GSK_CALLBACK_ID values currently are not supported in the i5/OS ®<br />

implementation:<br />

v GSK_IO_CALLBACK<br />

v GSK_SID_CACHE_CALLBACK<br />

v GSK_CLIENT_CERT_CALLBACK<br />

v GSK_PKCS11_CALLBACK<br />

Related Information<br />

v “gsk_attribute_set_enum()—Set enumerated information for a secure session or an SSL environment”<br />

on page 24—Set enumerated information for a secure session or an SSL environment.<br />

v “gsk_attribute_set_buffer()—Set character information for a secure session or an SSL environment” on<br />

page 16—Set character string information for a secure session or an SSL environment.<br />

v “gsk_attribute_set_numeric_value()—Set numeric information for a secure session or an SSL<br />

environment” on page 28—Set numeric information for a secure session or an SSL environment<br />

v “gsk_environment_init()—Initialize an SSL environment” on page 32—Initialize an SSL environment<br />

v “gsk_environment_open()—Get a handle for an SSL environment” on page 34—Get a handle for an<br />

SSL environment<br />

v “gsk_secure_soc_init()—Negotiate a secure session” on page 38—Negotiate a secure session<br />

v “gsk_secure_soc_misc()—Perform miscellaneous functions for a secure session” on page 41—Perform<br />

miscellaneous functions for a secure session<br />

v “gsk_secure_soc_open()—Get a handle for a secure session” on page 44—Get a handle for a secure<br />

session<br />

v “gsk_strerror()—Retrieve GSKit runtime error message” on page 62—Retrieve GSK runtime error<br />

message<br />

API introduced: V5R3<br />

Top | UNIX-Type <strong>APIs</strong> | <strong>APIs</strong> by category<br />

<strong>Secure</strong> <strong>Sockets</strong> <strong>APIs</strong> 23

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!