mirror of
https://gitlab.com/libvirt/libvirt.git
synced 2024-09-19 22:21:27 +00:00
238fef920f
Refactor the code to use proper types for the memory and disk snapshot location and fix the parsing code to be compatible with an unsigned type. Signed-off-by: Peter Krempa <pkrempa@redhat.com> Reviewed-by: Ján Tomko <jtomko@redhat.com>
131 lines
5.1 KiB
C
131 lines
5.1 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;
|
|
|
|
/* 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 *virDomainSnapshotDefParseNode(xmlDocPtr xml,
|
|
xmlNodePtr root,
|
|
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);
|