2009-12-18 13:44:55 +00:00
|
|
|
/*
|
|
|
|
* cpu_conf.h: CPU XML handling
|
|
|
|
*
|
2014-05-22 07:13:05 +00:00
|
|
|
* Copyright (C) 2009-2011, 2013, 2014 Red Hat, Inc.
|
2009-12-18 13:44:55 +00:00
|
|
|
*
|
|
|
|
* 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
|
2012-09-20 22:30:55 +00:00
|
|
|
* License along with this library. If not, see
|
2012-07-21 10:06:23 +00:00
|
|
|
* <http://www.gnu.org/licenses/>.
|
2009-12-18 13:44:55 +00:00
|
|
|
*/
|
|
|
|
|
2019-06-07 20:20:21 +00:00
|
|
|
#pragma once
|
2009-12-18 13:44:55 +00:00
|
|
|
|
2019-06-07 20:20:21 +00:00
|
|
|
#include "virbuffer.h"
|
|
|
|
#include "virxml.h"
|
|
|
|
#include "virbitmap.h"
|
|
|
|
#include "virarch.h"
|
|
|
|
#include "numa_conf.h"
|
|
|
|
#include "virenum.h"
|
|
|
|
#include "virhostcpu.h"
|
2009-12-18 13:44:55 +00:00
|
|
|
|
2019-06-07 20:20:21 +00:00
|
|
|
#define VIR_CPU_VENDOR_ID_LENGTH 12
|
2012-06-28 10:21:17 +00:00
|
|
|
|
2014-04-28 00:15:21 +00:00
|
|
|
typedef enum {
|
2009-12-18 13:44:55 +00:00
|
|
|
VIR_CPU_TYPE_HOST,
|
|
|
|
VIR_CPU_TYPE_GUEST,
|
2011-05-27 09:47:30 +00:00
|
|
|
VIR_CPU_TYPE_AUTO,
|
|
|
|
|
|
|
|
VIR_CPU_TYPE_LAST
|
2014-04-28 00:15:21 +00:00
|
|
|
} virCPUType;
|
2009-12-18 13:44:55 +00:00
|
|
|
|
2019-01-20 16:04:56 +00:00
|
|
|
VIR_ENUM_DECL(virCPU);
|
2011-05-27 09:47:30 +00:00
|
|
|
|
2014-04-28 00:15:21 +00:00
|
|
|
typedef enum {
|
2011-08-18 10:14:36 +00:00
|
|
|
VIR_CPU_MODE_CUSTOM,
|
|
|
|
VIR_CPU_MODE_HOST_MODEL,
|
|
|
|
VIR_CPU_MODE_HOST_PASSTHROUGH,
|
|
|
|
|
|
|
|
VIR_CPU_MODE_LAST
|
2014-04-28 00:15:21 +00:00
|
|
|
} virCPUMode;
|
2011-08-18 10:14:36 +00:00
|
|
|
|
2019-01-20 16:04:56 +00:00
|
|
|
VIR_ENUM_DECL(virCPUMode);
|
2011-08-18 10:14:36 +00:00
|
|
|
|
2014-04-28 00:15:21 +00:00
|
|
|
typedef enum {
|
2009-12-18 13:44:55 +00:00
|
|
|
VIR_CPU_MATCH_EXACT,
|
2019-11-12 14:26:23 +00:00
|
|
|
VIR_CPU_MATCH_MINIMUM,
|
2009-12-18 13:44:55 +00:00
|
|
|
VIR_CPU_MATCH_STRICT,
|
|
|
|
|
|
|
|
VIR_CPU_MATCH_LAST
|
2014-04-28 00:15:21 +00:00
|
|
|
} virCPUMatch;
|
2009-12-18 13:44:55 +00:00
|
|
|
|
2019-01-20 16:04:56 +00:00
|
|
|
VIR_ENUM_DECL(virCPUMatch);
|
2009-12-18 13:44:55 +00:00
|
|
|
|
2017-03-01 14:18:22 +00:00
|
|
|
typedef enum {
|
|
|
|
VIR_CPU_CHECK_DEFAULT,
|
|
|
|
VIR_CPU_CHECK_NONE,
|
|
|
|
VIR_CPU_CHECK_PARTIAL,
|
|
|
|
VIR_CPU_CHECK_FULL,
|
|
|
|
|
|
|
|
VIR_CPU_CHECK_LAST
|
|
|
|
} virCPUCheck;
|
|
|
|
|
2019-01-20 16:04:56 +00:00
|
|
|
VIR_ENUM_DECL(virCPUCheck);
|
2017-03-01 14:18:22 +00:00
|
|
|
|
2014-04-28 00:15:21 +00:00
|
|
|
typedef enum {
|
2011-12-21 13:27:16 +00:00
|
|
|
VIR_CPU_FALLBACK_ALLOW,
|
|
|
|
VIR_CPU_FALLBACK_FORBID,
|
|
|
|
|
|
|
|
VIR_CPU_FALLBACK_LAST
|
2014-04-28 00:15:21 +00:00
|
|
|
} virCPUFallback;
|
2011-12-21 13:27:16 +00:00
|
|
|
|
2019-01-20 16:04:56 +00:00
|
|
|
VIR_ENUM_DECL(virCPUFallback);
|
2011-12-21 13:27:16 +00:00
|
|
|
|
2014-04-28 00:15:21 +00:00
|
|
|
typedef enum {
|
2009-12-18 13:44:55 +00:00
|
|
|
VIR_CPU_FEATURE_FORCE,
|
|
|
|
VIR_CPU_FEATURE_REQUIRE,
|
|
|
|
VIR_CPU_FEATURE_OPTIONAL,
|
|
|
|
VIR_CPU_FEATURE_DISABLE,
|
|
|
|
VIR_CPU_FEATURE_FORBID,
|
|
|
|
|
|
|
|
VIR_CPU_FEATURE_LAST
|
2014-04-28 00:15:21 +00:00
|
|
|
} virCPUFeaturePolicy;
|
2009-12-18 13:44:55 +00:00
|
|
|
|
2019-01-20 16:04:56 +00:00
|
|
|
VIR_ENUM_DECL(virCPUFeaturePolicy);
|
2009-12-18 13:44:55 +00:00
|
|
|
|
|
|
|
typedef struct _virCPUFeatureDef virCPUFeatureDef;
|
|
|
|
typedef virCPUFeatureDef *virCPUFeatureDefPtr;
|
|
|
|
struct _virCPUFeatureDef {
|
|
|
|
char *name;
|
|
|
|
int policy; /* enum virCPUFeaturePolicy */
|
|
|
|
};
|
|
|
|
|
2011-11-11 12:51:45 +00:00
|
|
|
|
2017-04-24 13:40:07 +00:00
|
|
|
typedef enum {
|
|
|
|
VIR_CPU_CACHE_MODE_EMULATE,
|
|
|
|
VIR_CPU_CACHE_MODE_PASSTHROUGH,
|
|
|
|
VIR_CPU_CACHE_MODE_DISABLE,
|
|
|
|
|
|
|
|
VIR_CPU_CACHE_MODE_LAST
|
|
|
|
} virCPUCacheMode;
|
|
|
|
|
|
|
|
VIR_ENUM_DECL(virCPUCacheMode);
|
|
|
|
|
|
|
|
typedef struct _virCPUCacheDef virCPUCacheDef;
|
|
|
|
typedef virCPUCacheDef *virCPUCacheDefPtr;
|
|
|
|
struct _virCPUCacheDef {
|
|
|
|
int level; /* -1 for unspecified */
|
|
|
|
virCPUCacheMode mode;
|
|
|
|
};
|
|
|
|
|
|
|
|
|
2009-12-18 13:44:55 +00:00
|
|
|
typedef struct _virCPUDef virCPUDef;
|
|
|
|
typedef virCPUDef *virCPUDefPtr;
|
|
|
|
struct _virCPUDef {
|
2019-11-29 11:00:26 +00:00
|
|
|
int refs;
|
2009-12-18 13:44:55 +00:00
|
|
|
int type; /* enum virCPUType */
|
2011-08-18 10:14:36 +00:00
|
|
|
int mode; /* enum virCPUMode */
|
2009-12-18 13:44:55 +00:00
|
|
|
int match; /* enum virCPUMatch */
|
2017-03-01 14:18:22 +00:00
|
|
|
virCPUCheck check;
|
2012-12-11 12:58:54 +00:00
|
|
|
virArch arch;
|
2009-12-18 13:44:55 +00:00
|
|
|
char *model;
|
2012-06-28 10:21:17 +00:00
|
|
|
char *vendor_id; /* vendor id returned by CPUID in the guest */
|
2011-12-21 13:27:16 +00:00
|
|
|
int fallback; /* enum virCPUFallback */
|
2010-07-02 15:51:59 +00:00
|
|
|
char *vendor;
|
2017-12-12 15:23:40 +00:00
|
|
|
unsigned int microcodeVersion;
|
2009-12-18 13:44:55 +00:00
|
|
|
unsigned int sockets;
|
2019-12-16 11:16:51 +00:00
|
|
|
unsigned int dies;
|
2009-12-18 13:44:55 +00:00
|
|
|
unsigned int cores;
|
|
|
|
unsigned int threads;
|
2010-08-17 21:41:51 +00:00
|
|
|
size_t nfeatures;
|
|
|
|
size_t nfeatures_max;
|
2009-12-18 13:44:55 +00:00
|
|
|
virCPUFeatureDefPtr features;
|
2017-04-24 13:40:07 +00:00
|
|
|
virCPUCacheDefPtr cache;
|
2019-05-30 19:47:49 +00:00
|
|
|
virHostCPUTscInfoPtr tsc;
|
2020-06-02 10:29:57 +00:00
|
|
|
virTristateSwitch migratable; /* for host-passthrough mode */
|
2009-12-18 13:44:55 +00:00
|
|
|
};
|
|
|
|
|
2019-11-29 11:00:26 +00:00
|
|
|
virCPUDefPtr virCPUDefNew(void);
|
2009-12-18 13:44:55 +00:00
|
|
|
|
2017-03-16 11:21:58 +00:00
|
|
|
void ATTRIBUTE_NONNULL(1)
|
|
|
|
virCPUDefFreeFeatures(virCPUDefPtr def);
|
|
|
|
|
2011-12-19 14:41:16 +00:00
|
|
|
void ATTRIBUTE_NONNULL(1)
|
|
|
|
virCPUDefFreeModel(virCPUDefPtr def);
|
|
|
|
|
2019-11-29 11:00:26 +00:00
|
|
|
void
|
|
|
|
virCPUDefRef(virCPUDefPtr def);
|
2009-12-18 13:44:55 +00:00
|
|
|
void
|
|
|
|
virCPUDefFree(virCPUDefPtr def);
|
2019-09-26 16:41:42 +00:00
|
|
|
G_DEFINE_AUTOPTR_CLEANUP_FUNC(virCPUDef, virCPUDefFree);
|
2009-12-18 13:44:55 +00:00
|
|
|
|
2011-12-19 14:41:16 +00:00
|
|
|
int ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(2)
|
|
|
|
virCPUDefCopyModel(virCPUDefPtr dst,
|
maint: avoid 'const fooPtr' in cpu files
'const fooPtr' is the same as 'foo * const' (the pointer won't
change, but it's contents can). But in general, if an interface
is trying to be const-correct, it should be using 'const foo *'
(the pointer is to data that can't be changed).
Fix up offenders in src/cpu.
* src/cpu/cpu.h (cpuArchDecode, cpuArchEncode, cpuArchUpdate)
(cpuArchHasFeature, cpuDecode, cpuEncode, cpuUpdate)
(cpuHasFeature): Use intended type.
* src/conf/cpu_conf.h (virCPUDefCopyModel, virCPUDefCopy):
Likewise.
(virCPUDefParseXML): Drop const.
* src/cpu/cpu.c (cpuDecode, cpuEncode, cpuUpdate, cpuHasFeature):
Fix fallout.
* src/cpu/cpu_x86.c (x86ModelFromCPU, x86ModelSubtractCPU)
(x86DecodeCPUData, x86EncodePolicy, x86Encode, x86UpdateCustom)
(x86UpdateHostModel, x86Update, x86HasFeature): Likewise.
* src/cpu/cpu_s390.c (s390Decode): Likewise.
* src/cpu/cpu_arm.c (ArmDecode): Likewise.
* src/cpu/cpu_powerpc.c (ppcModelFromCPU, ppcCompute, ppcDecode)
(ppcUpdate): Likewise.
* src/conf/cpu_conf.c (virCPUDefCopyModel, virCPUDefCopy)
(virCPUDefParseXML): Likewise.
Signed-off-by: Eric Blake <eblake@redhat.com>
2013-10-05 20:01:02 +00:00
|
|
|
const virCPUDef *src,
|
2011-12-19 14:41:16 +00:00
|
|
|
bool resetPolicy);
|
|
|
|
|
2016-06-28 08:44:20 +00:00
|
|
|
/*
|
|
|
|
* Returns true if feature @name should copied, false otherwise.
|
|
|
|
*/
|
|
|
|
typedef bool (*virCPUDefFeatureFilter)(const char *name,
|
2019-11-07 15:25:47 +00:00
|
|
|
virCPUFeaturePolicy policy,
|
2016-06-28 08:44:20 +00:00
|
|
|
void *opaque);
|
|
|
|
|
|
|
|
int
|
|
|
|
virCPUDefCopyModelFilter(virCPUDefPtr dst,
|
|
|
|
const virCPUDef *src,
|
|
|
|
bool resetPolicy,
|
|
|
|
virCPUDefFeatureFilter filter,
|
|
|
|
void *opaque)
|
|
|
|
ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(2);
|
|
|
|
|
2016-06-23 10:54:19 +00:00
|
|
|
void
|
|
|
|
virCPUDefStealModel(virCPUDefPtr dst,
|
2016-11-10 09:26:03 +00:00
|
|
|
virCPUDefPtr src,
|
|
|
|
bool keepVendor);
|
2016-06-23 10:54:19 +00:00
|
|
|
|
2010-03-23 08:34:04 +00:00
|
|
|
virCPUDefPtr
|
maint: avoid 'const fooPtr' in cpu files
'const fooPtr' is the same as 'foo * const' (the pointer won't
change, but it's contents can). But in general, if an interface
is trying to be const-correct, it should be using 'const foo *'
(the pointer is to data that can't be changed).
Fix up offenders in src/cpu.
* src/cpu/cpu.h (cpuArchDecode, cpuArchEncode, cpuArchUpdate)
(cpuArchHasFeature, cpuDecode, cpuEncode, cpuUpdate)
(cpuHasFeature): Use intended type.
* src/conf/cpu_conf.h (virCPUDefCopyModel, virCPUDefCopy):
Likewise.
(virCPUDefParseXML): Drop const.
* src/cpu/cpu.c (cpuDecode, cpuEncode, cpuUpdate, cpuHasFeature):
Fix fallout.
* src/cpu/cpu_x86.c (x86ModelFromCPU, x86ModelSubtractCPU)
(x86DecodeCPUData, x86EncodePolicy, x86Encode, x86UpdateCustom)
(x86UpdateHostModel, x86Update, x86HasFeature): Likewise.
* src/cpu/cpu_s390.c (s390Decode): Likewise.
* src/cpu/cpu_arm.c (ArmDecode): Likewise.
* src/cpu/cpu_powerpc.c (ppcModelFromCPU, ppcCompute, ppcDecode)
(ppcUpdate): Likewise.
* src/conf/cpu_conf.c (virCPUDefCopyModel, virCPUDefCopy)
(virCPUDefParseXML): Likewise.
Signed-off-by: Eric Blake <eblake@redhat.com>
2013-10-05 20:01:02 +00:00
|
|
|
virCPUDefCopy(const virCPUDef *cpu);
|
2010-03-23 08:34:04 +00:00
|
|
|
|
2016-06-17 07:44:43 +00:00
|
|
|
virCPUDefPtr
|
|
|
|
virCPUDefCopyWithoutModel(const virCPUDef *cpu);
|
|
|
|
|
2019-09-19 20:25:04 +00:00
|
|
|
int
|
|
|
|
virCPUDefParseXMLString(const char *xml,
|
|
|
|
virCPUType type,
|
2020-10-07 08:54:55 +00:00
|
|
|
virCPUDefPtr *cpu,
|
|
|
|
bool validateXML);
|
2019-09-19 20:25:04 +00:00
|
|
|
|
2017-05-23 07:29:36 +00:00
|
|
|
int
|
|
|
|
virCPUDefParseXML(xmlXPathContextPtr ctxt,
|
|
|
|
const char *xpath,
|
|
|
|
virCPUType mode,
|
2020-10-07 08:54:55 +00:00
|
|
|
virCPUDefPtr *cpu,
|
|
|
|
bool validateXML);
|
2009-12-18 13:44:55 +00:00
|
|
|
|
2011-05-27 09:47:30 +00:00
|
|
|
bool
|
|
|
|
virCPUDefIsEqual(virCPUDefPtr src,
|
2017-05-31 14:42:42 +00:00
|
|
|
virCPUDefPtr dst,
|
|
|
|
bool reportError);
|
2009-12-18 13:44:55 +00:00
|
|
|
|
|
|
|
char *
|
2011-08-18 10:14:36 +00:00
|
|
|
virCPUDefFormat(virCPUDefPtr def,
|
2017-06-30 13:47:23 +00:00
|
|
|
virDomainNumaPtr numa);
|
2009-12-18 13:44:55 +00:00
|
|
|
|
|
|
|
int
|
2010-02-10 12:22:36 +00:00
|
|
|
virCPUDefFormatBuf(virBufferPtr buf,
|
2017-06-30 13:47:23 +00:00
|
|
|
virCPUDefPtr def);
|
2011-09-21 23:42:07 +00:00
|
|
|
int
|
|
|
|
virCPUDefFormatBufFull(virBufferPtr buf,
|
2011-08-18 10:14:36 +00:00
|
|
|
virCPUDefPtr def,
|
2017-06-30 13:47:23 +00:00
|
|
|
virDomainNumaPtr numa);
|
2009-12-18 13:44:55 +00:00
|
|
|
|
|
|
|
int
|
2010-02-10 12:22:36 +00:00
|
|
|
virCPUDefAddFeature(virCPUDefPtr cpu,
|
2009-12-18 13:44:55 +00:00
|
|
|
const char *name,
|
|
|
|
int policy);
|
|
|
|
|
2013-07-15 12:36:09 +00:00
|
|
|
int
|
|
|
|
virCPUDefUpdateFeature(virCPUDefPtr cpu,
|
|
|
|
const char *name,
|
|
|
|
int policy);
|
|
|
|
|
2017-10-09 14:20:43 +00:00
|
|
|
virCPUFeatureDefPtr
|
|
|
|
virCPUDefFindFeature(virCPUDefPtr def,
|
|
|
|
const char *name);
|
|
|
|
|
2019-06-07 12:07:10 +00:00
|
|
|
int
|
|
|
|
virCPUDefFilterFeatures(virCPUDefPtr cpu,
|
|
|
|
virCPUDefFeatureFilter filter,
|
|
|
|
void *opaque);
|
|
|
|
|
2019-06-19 17:01:30 +00:00
|
|
|
int
|
|
|
|
virCPUDefCheckFeatures(virCPUDefPtr cpu,
|
|
|
|
virCPUDefFeatureFilter filter,
|
|
|
|
void *opaque,
|
|
|
|
char ***features);
|
|
|
|
|
2017-09-13 13:23:43 +00:00
|
|
|
virCPUDefPtr *
|
|
|
|
virCPUDefListParse(const char **xmlCPUs,
|
|
|
|
unsigned int ncpus,
|
|
|
|
virCPUType cpuType);
|
|
|
|
void
|
|
|
|
virCPUDefListFree(virCPUDefPtr *cpus);
|