Reads from a secure connection in SRB mode.

Parameters

SOCHNDLE

Specifies a 4-byte word containing the gsk_soc_data address returned by the gsk_secure_soc_init() routine.

BUFPTR

Specifies a 4-byte word containing the address of the data buffer.

BUFSIZE

Specifies a 4-byte word containing the length of the data buffer.

RSNCODE

Specifies a 4-byte word which will contain the reason code if an error is detected. In most cases, this will be the errno value at the completion of the read request.

Results

The return value will be the number of bytes read if no error is detected. Otherwise, it will be a negative value representing one of the return codes listed in the gskssl.h include file. See the description of the gsk_secure_soc_read() routine for more information.

Usage

The GSKSRBRD routine is called to read from a secure connection in SRB mode. The gsk_srb_initialize() routine must have been called previously to initialize the SRB support. All of the parameters must be in the application storage key and must reside in the primary address space. The GSKSRBRD routine will pass the read request to one of the SRB service tasks. The service task will then call the gsk_secure_soc_read() routine. The GSKSRBRD routine will not return until the gsk_secure_soc_read() routine has completed.

Related Topics

GSKSRBWT

gsk_initialize()

gsk_secure_soc_close()

gsk_secure_soc_init()

gsk_secure_soc_write()

gsk_srb_initialize()