libimobiledevice  1.3.0
API Documentation - Return to Homepage

◆ lockdownd_client_new_with_handshake()

lockdownd_error_t lockdownd_client_new_with_handshake ( idevice_t  device,
lockdownd_client_t client,
const char *  label 
)

Creates a new lockdownd client for the device and starts initial handshake.

The handshake consists out of query_type, validate_pair, pair and start_session calls. It uses the internal pairing record management.

Note
The device disconnects automatically if the lockdown connection idles for more than 10 seconds. Make sure to call lockdownd_client_free() as soon as the connection is no longer needed.
Parameters
deviceThe device to create a lockdownd client for
clientThe pointer to the location of the new lockdownd_client
labelThe label to use for communication. Usually the program name. Pass NULL to disable sending the label in requests to lockdownd.
Returns
LOCKDOWN_E_SUCCESS on success, LOCKDOWN_E_INVALID_ARG when client is NULL, LOCKDOWN_E_INVALID_CONF if configuration data is wrong