mco_backup

Internal function. This is a low-level runtime routine used by mco_backup_create() to perform database backup operations.

For an overview see page Incremental Online Backup in C

Prototype

    MCO_RET mco_backup(
        /*IN*/ mco_db_h connection,
        /*IN*/ const char *label,
        /*IN*/ mco_backup_type backup_type,
        /*IN*/ mco_backup_info_proc_t proc_info,
        /*IN*/ mco_backup_chunk_proc_t proc_chunk,
        /*IN*/ void *proc_arg
    );

Arguments

Description

This internal function implements the core logic for creating snapshot and incremental backups of an eXtremeDB database. It is invoked by the public API function mco_backup_create() and should not be called directly by applications.

The function performs the following steps:

• Validates that incremental backup is enabled in the database configuration,
• Determines the appropriate backup type based on existing backup history,
• Iteratively scans memory and disk pages, collecting modified data since the last mark,
• Invokes proc_info to report backup metadata,
• Invokes proc_chunk repeatedly to deliver data chunks (pages, dictionary, indexes, transaction logs, etc.).

Backup progress can be monitored via the database’s backup context structure. The function supports both full (snapshot) and differential (incremental) backup modes.

See Incremental Backup and Restore in C for usage examples.

Return Codes

Files