mme_delete_mediastores()

Prune unavailable mediastores

Synopsis:

#include <mme/mme.h>

int mme_delete_mediastores( mme_hdl_t *hdl,
                            uint32_t flags );

Arguments:

hdl
An MME connection handle.
flags
A flag determining if the function should delete mediastores marked as permanent. Set to a value defined by MME_DB_DELETION_*.

Library:

mme

Description:

The function mme_delete_mediastores() prunes from the MME database entries for mediastores whose state is unavailable. It deletes entries only for mediastores whose type (MME_STORAGETYPE_*) matches the storage types set by <MediastoreMatching> configuration elements. See About pruning ejected mediastores.

The function mme_delete_mediastores() can be called at any time, but it is usually used after a system startup to delete mediastores entries for mediastores whose states are set to unavailable because they were removed while the system was shut down. See Sample script mme_del_unav in the MME Configuration Guide.

The default behavior of mme_delete_mediastores() is to not delete entries for mediastores whose library entries mark them as permanent. However, you can set the flag argument to override this restriction and have mme_delete_mediastores() delete all entries for unavailable mediastores of the types permitted by the <MediastoreMatching> configuration elements.


Note: The <WhenUnavailable> configuration has no affect on mme_delete_mediastores().

MME_DB_DELETION_*

The MME defines the following values in interface.h that determine the behavior of mme_delete_mediastores():

Events

None delivered.

Blocking and validation

This function doesn't block.

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_resync_mediastore