# backupInfo

> List the contents of a backup file.

> ### For an overview see page Incremental_Backup

> ### Prototype

>         void backupInfo(McoSql::String* file,
>                     SyntheticTable* table,
>                     Allocator* allocator);

> ### Arguments

> file | The path and filename for the backup file
> table | The table to receive the list of backup record descriptors
> allocator | A dynamic memory allocator

> ### Description

> > This method lists the contents of a backup file by calling the C API mco_backup_list(). (Please refer to the mco_backup_list() reference page for further details.)

> ### Return Codes

> Runtime Exception | In case of error a runtime exception will be thrown with the appropriate error message

> ### Example

>         {
>             MCO_RET rc;
>             mco_device_t       dev[4];
>             McoSqlEngine engine;
>             McoSqlOpenParameters params;
>             char * backup_file = "SimpleDb_backup.dbs";
>             SyntheticTable * table = SyntheticTable();
>             Allocator * allocator = Allocator();

>             ...
>             rc = engine.open(params);
>             if ( MCO_S_OK == rc )
>             {
>                 rc = engine.backupInfo( backup_file, table, allocator);
>                 engine.close();
>             }
>             ...
>         }