A pointer to a customized read function that secure transport calls to read data from the connection.
- iOS 5.0+
- macOS 10.2+
- Mac Catalyst 13.0+
- tvOS 9.0+
- watchOS 2.0+
A connection reference.
On return, your callback should overwrite the memory at this location with the data read from the connection.
On input, a pointer to an integer representing the length of the data in bytes. On return, your callback should overwrite that integer with the number of bytes actually transferred.
Your callback must return an appropriate result code. See Secure Transport Result Codes.
Before using the secure transport API, you must create a read function (conforming to the
SSLRead prototype) and a write function (conforming to the
SSLWrite prototype) and provide them to the library by calling the
You may configure the underlying connection to operate in a non-blocking manner; in that case, a read operation may well return
err, indicating less data than requested was transferred and nothing is wrong except that the requested I/O hasn’t completed. This result is returned to the caller from the functions