mme_mediacopier_cleanup()

Clean up partially copied or ripped files

Synopsis:

#include <mme/mme.h>

int mme_mediacopier_cleanup( mme_hdl_t *hdl );

Arguments:

hdl
An MME connection handle.

Library:

mme

Description:

The function mme_mediacopier_cleanup() cleans up partially copied or ripped files from the MME database and the system HDD. You should use this function when starting up after a media copying or ripping operation has been aborted or was stopped unexpectedly, in order to to ensure that the MME does not keep entries for incompletely ripped files in its database.

The function mme_mediacopier_cleanup() can be called only if the mediacopier is disabled. An attempt to call this function while the mediacopier is enabled causes it to return an EBUSY error.

Events

None delivered.

Blocking and validation

This function checks that the mediacopier is disabled; it doesn't block.

Returns:

0
Success.
-1
An error occurred (errno is set). An EBUSY error indicates that the mediacopier is enabled.

Classification:

QNX Neutrino

Safety:
Interrupt handler No
Signal handler No
Thread Yes

See also:

mme_mediacopier_add(), mme_mediacopier_clear(), mme_mediacopier_disable(), mme_mediacopier_enable(), mme_mediacopier_get_status(), mme_mediacopier_remove()