mme_resync_mediastore()

Re-synchronize a mediastore

Synopsis:

#include <mme/mme.h>

int mme_resync_mediastore( mme_hdl_t *hdl,
                           uint64_t msid,
                           uint64_t folderid,
                           uint32_t options );

Arguments:

hdl
An MME connection handle.
msid
The ID of the mediastore to resynchronize.
folderid
Specifies the folder to synchronize. A value of 0 means synchronize all folders.
options
A mask that sets synchronization options. The options can be any combination of:

Library:

mme

Description:

The function mme_resync_mediastore() attempts to start synchronization of a mediastore. It returns immediately, with synchronization continuing in the background.

When a particular pass is specified, if that pass was previously marked as complete in the MME database, the MME first marks that pass as not complete, then attempts the new synchronization. Any previously completed synchronization passes that are not being redone are left untouched.


Caution: A clean up of invalid copied_id fields can take a long time. Use the MME_SYNC_OPTION_CLR_INV_COPIED flag judiciously — only when synchronizing after deleting media files from your database.

Events

The function mme_resync_mediastore() may deliver any event of the class MME_EVENT_CLASS_SYNC, and any of the MME_SYNC_ERROR_* error events.

Blocking and validation

This function verifies that the msid and folderid are valid. It returns, then requests a synchronization in the background at the earliest possible time. If all synchronization threads are busy, this request is queued until a synchronization thread becomes available.

See the chapter Configuring Synchronization in the MME Configuration Guide.

Returns:

0
Success.
-1
An error occurred (errno is set).

Classification:

QNX Neutrino

Safety:
Interrupt handler No
Signal handler No
Thread Yes

See also:

mme_directed_sync_cancel(), mme_playlist_sync(), mme_setpriorityfolder(), mme_sync_cancel(), mme_sync_directed(), mme_sync_file(), mme_sync_get_msid_status(), mme_sync_get_status()