Client interface

The client interface API section defines the functions that client applications can use to connect to mm-sync, start and monitor synchronizations, and set debugging levels. This API section also defines synchronization option flags and data types used in function parameters.

The client functions allow your application to synchronize some or all of the media content on a device and to suspend, cancel, or resume an ongoing synchronization.

Your application must connect to the multimedia synchronizer service before it can synchronize any content. When your application connects to mm-sync by calling mm_sync_connect(), the API function returns a connection handle (mmsync_hdl_t). Your code must use this handle to access that same connection in all subsequent function calls, such as calls to mm_sync_start() or mm_sync_statuts_get(). When it has finished synchronizing the media, your application can disconnect from mm-sync by calling mm_sync_disconnect().

There's also a function for setting the debugging and verbosity levels (mm_sync_debug_set()) so you can see useful troubleshooting information in the stderr file stream and sloginfo logging utility.