mirror of
https://gitlab.com/libvirt/libvirt.git
synced 2024-08-28 03:21:19 +00:00
565bcb5d79
When deleting external snapshots the operation may fail at any point which could lead to situation that some disks finished the block commit operation but for some disks it failed and the libvirt job ends. In order to make sure that the qcow2 images are in consistent state introduce new element "<snapshotDeleteInProgress/>" that will mark the disk in snapshot metadata as invalid until the snapshot delete is completed successfully. This will prevent deleting snapshot with the invalid disk and in future reverting to snapshot with the invalid disk. Signed-off-by: Pavel Hrdina <phrdina@redhat.com> Reviewed-by: Peter Krempa <pkrempa@redhat.com>
133 lines
5.0 KiB
C
133 lines
5.0 KiB
C
/*
|
|
* snapshot_conf.h: domain snapshot XML processing
|
|
*
|
|
* Copyright (C) 2006-2019 Red Hat, Inc.
|
|
* Copyright (C) 2006-2008 Daniel P. Berrange
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2.1 of the License, or (at your option) any later version.
|
|
*
|
|
* This library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with this library. If not, see
|
|
* <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include "internal.h"
|
|
#include "domain_conf.h"
|
|
#include "moment_conf.h"
|
|
#include "virenum.h"
|
|
|
|
/**
|
|
* This enum has to map all known domain states from the public enum
|
|
* virDomainState, before adding one additional state possible only
|
|
* for snapshots.
|
|
*/
|
|
typedef enum {
|
|
/* Mapped to public enum */
|
|
VIR_DOMAIN_SNAPSHOT_NOSTATE = VIR_DOMAIN_NOSTATE,
|
|
VIR_DOMAIN_SNAPSHOT_RUNNING = VIR_DOMAIN_RUNNING,
|
|
VIR_DOMAIN_SNAPSHOT_BLOCKED = VIR_DOMAIN_BLOCKED,
|
|
VIR_DOMAIN_SNAPSHOT_PAUSED = VIR_DOMAIN_PAUSED,
|
|
VIR_DOMAIN_SNAPSHOT_SHUTDOWN = VIR_DOMAIN_SHUTDOWN,
|
|
VIR_DOMAIN_SNAPSHOT_SHUTOFF = VIR_DOMAIN_SHUTOFF,
|
|
VIR_DOMAIN_SNAPSHOT_CRASHED = VIR_DOMAIN_CRASHED,
|
|
VIR_DOMAIN_SNAPSHOT_PMSUSPENDED = VIR_DOMAIN_PMSUSPENDED,
|
|
/* Additional enum values local to snapshots */
|
|
VIR_DOMAIN_SNAPSHOT_DISK_SNAPSHOT,
|
|
VIR_DOMAIN_SNAPSHOT_LAST
|
|
} virDomainSnapshotState;
|
|
G_STATIC_ASSERT((int)VIR_DOMAIN_SNAPSHOT_DISK_SNAPSHOT == VIR_DOMAIN_LAST);
|
|
|
|
/* Stores disk-snapshot information */
|
|
typedef struct _virDomainSnapshotDiskDef virDomainSnapshotDiskDef;
|
|
struct _virDomainSnapshotDiskDef {
|
|
char *name; /* name matching the <target dev='...' of the domain */
|
|
virDomainSnapshotLocation snapshot;
|
|
bool snapshotDeleteInProgress;
|
|
|
|
/* details of wrapper external file. src is always non-NULL.
|
|
* XXX optimize this to allow NULL for internal snapshots? */
|
|
virStorageSource *src;
|
|
};
|
|
|
|
void
|
|
virDomainSnapshotDiskDefFree(virDomainSnapshotDiskDef *disk);
|
|
|
|
G_DEFINE_AUTOPTR_CLEANUP_FUNC(virDomainSnapshotDiskDef, virDomainSnapshotDiskDefFree);
|
|
|
|
/* Stores the complete snapshot metadata */
|
|
struct _virDomainSnapshotDef {
|
|
virDomainMomentDef parent;
|
|
|
|
/* Additional public XML. */
|
|
int state; /* virDomainSnapshotState */
|
|
|
|
virDomainSnapshotLocation memory;
|
|
char *memorysnapshotfile; /* memory state file when snapshot is external */
|
|
|
|
size_t ndisks; /* should not exceed dom->ndisks */
|
|
virDomainSnapshotDiskDef *disks;
|
|
|
|
virObject *cookie;
|
|
};
|
|
|
|
G_DEFINE_AUTOPTR_CLEANUP_FUNC(virDomainSnapshotDef, virObjectUnref);
|
|
|
|
|
|
typedef enum {
|
|
VIR_DOMAIN_SNAPSHOT_PARSE_REDEFINE = 1 << 0,
|
|
VIR_DOMAIN_SNAPSHOT_PARSE_INTERNAL = 1 << 1,
|
|
VIR_DOMAIN_SNAPSHOT_PARSE_OFFLINE = 1 << 2,
|
|
VIR_DOMAIN_SNAPSHOT_PARSE_VALIDATE = 1 << 3,
|
|
} virDomainSnapshotParseFlags;
|
|
|
|
typedef enum {
|
|
VIR_DOMAIN_SNAPSHOT_FORMAT_SECURE = 1 << 0,
|
|
VIR_DOMAIN_SNAPSHOT_FORMAT_INTERNAL = 1 << 1,
|
|
VIR_DOMAIN_SNAPSHOT_FORMAT_CURRENT = 1 << 2,
|
|
} virDomainSnapshotFormatFlags;
|
|
|
|
unsigned int virDomainSnapshotFormatConvertXMLFlags(unsigned int flags);
|
|
|
|
virDomainSnapshotDef *virDomainSnapshotDefParseString(const char *xmlStr,
|
|
virDomainXMLOption *xmlopt,
|
|
void *parseOpaque,
|
|
bool *current,
|
|
unsigned int flags);
|
|
virDomainSnapshotDef *
|
|
virDomainSnapshotDefParse(xmlXPathContextPtr ctxt,
|
|
virDomainXMLOption *xmlopt,
|
|
void *parseOpaque,
|
|
bool *current,
|
|
unsigned int flags);
|
|
|
|
virDomainSnapshotDef *virDomainSnapshotDefNew(void);
|
|
char *virDomainSnapshotDefFormat(const char *uuidstr,
|
|
virDomainSnapshotDef *def,
|
|
virDomainXMLOption *xmlopt,
|
|
unsigned int flags);
|
|
int virDomainSnapshotAlignDisks(virDomainSnapshotDef *snapshot,
|
|
virDomainDef *existingDomainDef,
|
|
virDomainSnapshotLocation default_snapshot,
|
|
bool uniform_internal_snapshot);
|
|
|
|
bool virDomainSnapshotDefIsExternal(virDomainSnapshotDef *def);
|
|
bool virDomainSnapshotIsExternal(virDomainMomentObj *snap);
|
|
|
|
int virDomainSnapshotRedefinePrep(virDomainObj *vm,
|
|
virDomainSnapshotDef *snapdef,
|
|
virDomainMomentObj **snap,
|
|
virDomainXMLOption *xmlopt,
|
|
unsigned int flags);
|
|
|
|
VIR_ENUM_DECL(virDomainSnapshotState);
|