System i: Programming Secure Sockets APIs - IBM

v “gsk_secure_soc_read()—Receive data on a secure session” on page 46 (Receive data on a secure
session) is used by a program to receive data from a secure session.
v “gsk_secure_soc_startInit()—Start asynchronous operation to negotiate a secure session” on page 48
(Start asynchronous operation to negotiate a secure session) initiates an asynchronous negotiation of a
secure session, using the attributes set for the SSL environment and the secure session.
v “gsk_secure_soc_startRecv()—Start asynchronous receive operation on a secure session” on page 52
(Start asynchronous receive operation on a secure session) is used to initiate an asynchronous receive
operation on a secure session.
v “gsk_secure_soc_startSend()—Start asynchronous send operation on a secure session” on page 56 (Start
asynchronous send operation on a secure session) is used to initiate an asynchronous send operation
on a secure session.
v “gsk_secure_soc_write()—Send data on a secure session” on page 60 (Send data on a secure session) is
used by a program to write data on a secure session.
v “gsk_strerror()—Retrieve GSKit runtime error message” on page 62 (Retrieve GSKit runtime error
message) is used to retrieve an error message and associated text string that describes a return value
that was returned from calling a GSKit API.
Note: These functions use header (include) files from the library QSYSINC, which is optionally
installable. Make sure QSYSINC is installed on your system before using any of the functions. See
“Header Files for UNIX-Type Functions” on page 100 for the file and member name of each header file.
See the following examples in the Socket programming topic collection for more information:
v Example: GSKit secure server with asynchronous data receive
v Example: GSKit secure server with asynchronous handshake
v Example: Establishing a secure client with Global Secure ToolKit APIs
Top | UNIX-Type APIs | APIs by category
gsk_attribute_get_buffer()—Get character information about a secure
session or an SSL environment
Syntax
#include
int gsk_attribute_get_buffer(gsk_handle my_gsk_handle,
GSK_BUF_ID bufID,
const char **buffer,
int *bufSize);
Service Program Name: QSYS/QSOSSLSR
Default Public Authority: *USE
Threadsafe: Yes
The gsk_attribute_get_buffer() function is used to obtain specific character string information about a
secure session or an SSL environment. It can be used to obtain values such as certificate store file,
certificate store password, application ID, and ciphers.
Parameters
my_gsk_handle (Input)
Indicates one of the following handles:
v The handle for the secure session (my_session_handle)
v The handle for the SSL environment (my_env_handle)
Secure Sockets APIs 3