mmsync_sync_error_type_t

mm-sync error types

Synopsis:

#include <mmsync/event.h>
typedef enum mmsync_sync_error_type {
    MMSYNC_SYNC_ERROR_NONE = 0,
    MMSYNC_SYNC_ERROR_MEDIABUSY,
    MMSYNC_SYNC_ERROR_READ,
    MMSYNC_SYNC_ERROR_NETWORK,
    MMSYNC_SYNC_ERROR_UNSUPPORTED,
    MMSYNC_SYNC_ERROR_USERCANCEL,
    MMSYNC_SYNC_ERROR_NOTSPECIFIED,
    MMSYNC_SYNC_ERROR_LIB_LIMIT,
    MMSYNC_SYNC_ERROR_MS_FOLDER_LIMIT,
    MMSYNC_SYNC_ERROR_FOLDER_LIMIT,
    MMSYNC_SYNC_ERROR_DATABASE,
    MMSYNC_SYNC_ERROR_FOLDER_DEPTH_LIMIT,
    MMSYNC_SYNC_ERROR_DB_LIMIT,
    MMSYNC_SYNC_ERROR_FOLDER_NONMEDIA_LIMIT,
    MMSYNC_SYNC_ERROR_FOLDER_MEDIA_LIMIT,
    MMSYNC_SYNC_ERROR_MEMORY_ALLOCATION,
    MMSYNC_SYNC_ERROR_DOTNOMEDIAFILE
} mmsync_sync_error_type_t;

Data:

MMSYNC_SYNC_ERROR_NONE

Name: MMSYNC_SYNC_ERROR_NONE

Description: No synchronization error.

Delivered when: Never (placeholder).

Event data: None.

DB tables updated: None.

MMSYNC_SYNC_ERROR_MEDIABUSY

Name: MMSYNC_SYNC_ERROR_MEDIABUSY

Description: The media was busy and the synchronization wasn't allowed to start on it because of concurrency rules.

Delivered when: The synchronization should have started (but didn't) on a device.

Event data: The mmsync_sync_error_t structure, which contains:
  • the synchronization operation ID
DB tables updated:
  • mediastores
MMSYNC_SYNC_ERROR_READ

Name: MMSYNC_SYNC_ERROR_READ

Description: A read error prevented the device from being synchronized. This can be caused by a scratched disc, for example.

Delivered when: The synchronization fails because of a read error.

Event data: The mmsync_sync_error_t structure, which contains:
  • the synchronization operation ID
DB tables updated:
  • mediastores
MMSYNC_SYNC_ERROR_NETWORK

Name: MMSYNC_SYNC_ERROR_NETWORK

Description: A network error occurred during the synchronization. This can be caused by a metadata lookup that couldn't access the network.

Delivered when: The synchronization experiences a network error.

Event data: The mmsync_sync_error_t structure, which contains:
  • the synchronization operation ID
DB tables updated:
  • mediastores
MMSYNC_SYNC_ERROR_UNSUPPORTED

Name: MMSYNC_SYNC_ERROR_UNSUPPORTED

Description: The type of mediastore to synchronize isn't supported by mm-sync.

Delivered when: The mm-sync service starts the synchronization but determines the device is unsupported.

Event data: The mmsync_sync_error_t structure, which contains:
  • the synchronization operation ID
DB tables updated:
  • mediastores
MMSYNC_SYNC_ERROR_USERCANCEL

Name: MMSYNC_SYNC_ERROR_USERCANCEL

Description: The synchronization was stopped by a client request.

Delivered when: A client requests to stop the synchronization.

Event data: The mmsync_sync_error_t structure, which contains:
  • the synchronization operation ID
DB tables updated:
  • mediastores
MMSYNC_SYNC_ERROR_NOTSPECIFIED

Name: MMSYNC_SYNC_ERROR_NOTSPECIFIED

Description: A nonspecified error occurred. This error isn't classified by other error types.

Delivered when: Any time during synchronization.

Event data: The mmsync_sync_error_t structure, which contains:
  • the synchronization operation ID

DB tables updated: None.

MMSYNC_SYNC_ERROR_LIB_LIMIT

Name: MMSYNC_SYNC_ERROR_LIB_LIMIT

Description: The files pass of synchronization reached a configuration limit; no more entries may be added to the files table.

Delivered when: The maximum number of database entries has been reached during the files pass.

Event data: The mmsync_sync_error_t structure, which contains:
  • the synchronization operation ID
  • the limit that the mediastore reached (in param)

DB tables updated: None.

MMSYNC_SYNC_ERROR_MS_FOLDER_LIMIT

Name: MMSYNC_SYNC_ERROR_MS_FOLDER_LIMIT

Description: The files pass of synchronization reached a configuration limit; no more entries may be added to the folders table.

Delivered when: The maximum number of database entries allowed in the folders table has been reached during the files pass.

Event data: The mmsync_sync_error_t structure, which contains:
  • the synchronization operation ID
  • the limit that the mediastore reached (in param)

DB tables updated: None

MMSYNC_SYNC_ERROR_FOLDER_LIMIT

Name: MMSYNC_SYNC_ERROR_FOLDER_LIMIT

Description: The files pass of synchronization reached a configuration limit; no more entries may be added to the files table.

Delivered when: When the maximum number of folder items presented to the synchronizer service has been reached.

Event data: The mmsync_sync_error_t structure, which contains:
  • the synchronization operation ID
  • the ID of the folder in which the limit was reached (in param)

DB tables updated: None.

MMSYNC_SYNC_ERROR_DATABASE

Name: MMSYNC_SYNC_ERROR_DATABASE

Description: The synchronization encountered a database problem.

Delivered when: A database operation fails during synchronization.

Event data: TBD.

DB tables updated: None.

MMSYNC_SYNC_ERROR_FOLDER_DEPTH_LIMIT

Name: MMSYNC_SYNC_ERROR_FOLDER_DEPTH_LIMIT

Description: The mm-sync service skipped synchronizing a folder to avoid exceeding the configured maximum folder depth.

Delivered when: The first time mm-sync skips a folder because it has reached the configured maximum folder depth.

Event data: The mmsync_sync_error_t structure, which contains:
  • the synchronization operation ID
  • the ID of the folder in which the limit was reached (in param)

DB tables updated: None.

MMSYNC_SYNC_ERROR_DB_LIMIT

Name: MMSYNC_SYNC_ERROR_DB_LIMIT

Description: The maximum database size has been reached; no further data may be added to the files and playlist tables.

Delivered when: When mm-sync notices that the maximum database size has been reached and stops the synchronization to keep the database size manageable.

Event data: The mmsync_sync_error_t structure, which contains:
  • the synchronization operation ID

DB tables updated: None.

MMSYNC_SYNC_ERROR_FOLDER_NONMEDIA_LIMIT

Name: MMSYNC_SYNC_ERROR_FOLDER_NONMEDIA_LIMIT

Description: The files pass of synchronization reached the limit for nonmedia files; no entries for this folder will be added to the files table.

Delivered when: When the maximum number of nonmedia items in a folder has reached the configured limit.

Event data: The mmsync_sync_error_t structure, which contains:
  • the synchronization operation ID
  • the ID of the folder in which the limit was reached (in param)

DB tables updated: None.

MMSYNC_SYNC_ERROR_FOLDER_MEDIA_LIMIT

Name: MMSYNC_SYNC_ERROR_FOLDER_MEDIA_LIMIT

Description: The files pass of synchronization reached the limit for media files; no more entries for this folder will be added to the files table.

Delivered when: When the maximum number of media items in a folder has reached the configured limit.

Event data: The mmsync_sync_error_t structure, which contains:
  • the synchronization operation ID
  • the ID of the folder in which the limit was reached (in param)

DB tables updated: None.

MMSYNC_SYNC_ERROR_MEMORY_ALLOCATION

Name: MMSYNC_SYNC_ERROR_MEMORY_ALLOCATION

Description: The service had problems allocating memory.

Delivered when: When the service can't allocate sufficient memory during a synchronization.

Event data: The mmsync_sync_error_t structure, which contains:
  • the synchronization operation ID

DB tables updated: None.

MMSYNC_SYNC_ERROR_DOTNOMEDIAFILE

Name: MMSYNC_SYNC_ERROR_DOTNOMEDIAFILE

Description: The folder to synchronize has a file named ".nomedia" and hence, is skipped by mm-sync.

Delivered when: When the synchronization starts and mm-sync detects a ".nomedia" file in the folder.

Event data: The mmsync_sync_error_t structure, which contains:
  • the synchronization operation ID
DB tables updated:
  • mediastores

Library:

mmsyncclient