8:30 a.m.
As reviewing patches upstream it occurred to me, that we have two
functions doing nearly the same: virDomainParseMemory which
expects XML in the following format:
<memory unit='MiB'>1337</memory>
The other function being virDomainHugepagesParseXML expecting the
following format:
<someElement memory='1337' unit='MiB'/>
It wouldn't matter to have two functions handle two different
scenarios like this if we could only not copy code that handles
32bit arches around. So this code merges the common parts into
one by inventing new @units_xpath argument to
virDomainParseMemory which allows overriding the default location
of @unit attribute in XML. With this change both scenarios above
can be parsed with virDomainParseMemory. Sweet. Of course,
everything is commented as it should be.
Signed-off-by: Michal Privoznik <mprivozn(a)redhat.com>
---
src/conf/domain_conf.c | 137 +++++++++++++++++++++++++++++--------------------
1 file changed, 80 insertions(+), 57 deletions(-)
diff --git a/src/conf/domain_conf.c b/src/conf/domain_conf.c
index 21309b0..e097af7 100644
--- a/src/conf/domain_conf.c
+++ b/src/conf/domain_conf.c
@@ -6318,14 +6318,30 @@ virDomainDiskDefParseXML(virDomainXMLOptionPtr xmlopt,
goto cleanup;
}
-
-/* Parse a value located at XPATH within CTXT, and store the
- * result into val. If REQUIRED, then the value must exist;
- * otherwise, the value is optional. The value is in bytes.
- * Return 1 on success, 0 if the value was not present and
- * is not REQUIRED, -1 on failure after issuing error. */
+/**
+ * virDomainParseScaledValue:
+ * @bytes_xpath: XPath to memory amount
+ * @units_xpath: XPath to units attribute
+ * @ctxt: XPath context
+ * @val: scaled value is stored here
+ * @scale: default scale for @val
+ * @max: maximal @val allowed
+ * @required: is the value required?
+ *
+ * Parse a value located at @bytes_xpath within @ctxt, and store
+ * the result into @val. By default, if @units_xpath is NULL the
+ * unit attribute must be an attribute to @bytes_xpath.
+ * Otherwise, the unit attribute is looked for under specified
+ * path. If @required is set, then the value must exist;
+ * otherwise, the value is optional. The value is in bytes.
+ *
+ * Returns 1 on success,
+ * 0 if the value was not present and !@required,
+ * -1 on failure after issuing error.
+ */
static int
-virDomainParseScaledValue(const char *xpath,
+virDomainParseScaledValue(const char *bytes_xpath,
+ const char *units_xpath,
xmlXPathContextPtr ctxt,
unsigned long long *val,
unsigned long long scale,
@@ -6339,7 +6355,7 @@ virDomainParseScaledValue(const char *xpath,
unsigned long long bytes;
*val = 0;
- if (virAsprintf(&xpath_full, "string(%s)", xpath) < 0)
+ if (virAsprintf(&xpath_full, "string(%s)", bytes_xpath) < 0)
goto cleanup;
bytes_str = virXPathString(xpath_full, ctxt);
@@ -6348,8 +6364,8 @@ virDomainParseScaledValue(const char *xpath,
ret = 0;
} else {
virReportError(VIR_ERR_XML_ERROR,
- _("missing element %s"),
- xpath);
+ _("missing element or attribute '%s'"),
+ bytes_xpath);
}
goto cleanup;
}
@@ -6357,12 +6373,15 @@ virDomainParseScaledValue(const char *xpath,
if (virStrToLong_ullp(bytes_str, NULL, 10, &bytes) < 0) {
virReportError(VIR_ERR_XML_ERROR,
- _("Invalid value '%s' for element
'%s'"),
- bytes_str, xpath);
+ _("Invalid value '%s' for element or attribute
'%s'"),
+ bytes_str, bytes_xpath);
goto cleanup;
}
- if (virAsprintf(&xpath_full, "string(%s/@unit)", xpath) < 0)
+ if ((units_xpath &&
+ virAsprintf(&xpath_full, "string(%s)", units_xpath) < 0) ||
+ (!units_xpath &&
+ virAsprintf(&xpath_full, "string(%s/@unit)", bytes_xpath) <
0))
goto cleanup;
unit = virXPathString(xpath_full, ctxt);
@@ -6379,17 +6398,35 @@ virDomainParseScaledValue(const char *xpath,
}
-/* Parse a memory element located at XPATH within CTXT, and store the
- * result into MEM, in blocks of 1024. If REQUIRED, then the value
- * must exist; otherwise, the value is optional. The value must not
- * exceed VIR_DOMAIN_MEMORY_PARAM_UNLIMITED once scaled; additionally,
- * if CAPPED is true, the value must fit within an unsigned long (only
- * matters on 32-bit platforms).
+/**
+ * virDomainParseMemory:
+ * @bytes_xpath: XPath to memory amount
+ * @units_xpath: XPath to units attribute
+ * @ctxt: XPath context
+ * @mem: scaled memory amount is stored here
+ * @required: whether value is required
+ * @capped: whether scaled value must fit within unsigned long
*
- * Return 0 on success, -1 on failure after issuing error. */
+ * Parse a memory element or attribute located at @bytes_xpath
+ * within @ctxt, and store the result into @mem, in blocks of
+ * 1024. By default, if @units_xpath is NULL the unit attribute
+ * must be an attribute to @bytes_xpath. Otherwise, the unit
+ * attribute is looked for under specified path. If @required is
+ * set, then the value must exist; otherwise, the value is
+ * optional. The value must not exceed
+ * VIR_DOMAIN_MEMORY_PARAM_UNLIMITED once scaled; additionally,
+ * if @capped is true, the value must fit within an unsigned long
+ * (only matters on 32-bit platforms).
+ *
+ * Return 0 on success, -1 on failure after issuing error.
+ */
static int
-virDomainParseMemory(const char *xpath, xmlXPathContextPtr ctxt,
- unsigned long long *mem, bool required, bool capped)
+virDomainParseMemory(const char *bytes_xpath,
+ const char *units_xpath,
+ xmlXPathContextPtr ctxt,
+ unsigned long long *mem,
+ bool required,
+ bool capped)
{
int ret = -1;
unsigned long long bytes, max;
@@ -6401,7 +6438,8 @@ virDomainParseMemory(const char *xpath, xmlXPathContextPtr ctxt,
else
max = LLONG_MAX;
- ret = virDomainParseScaledValue(xpath, ctxt, &bytes, 1024, max, required);
+ ret = virDomainParseScaledValue(bytes_xpath, units_xpath, ctxt,
+ &bytes, 1024, max, required);
if (ret < 0)
goto cleanup;
@@ -6585,8 +6623,8 @@ virDomainControllerDefParseXML(xmlNodePtr node,
"should have index 0"));
goto error;
}
- if ((rc = virDomainParseScaledValue("./pcihole64", ctxt,
- &bytes, 1024,
+ if ((rc = virDomainParseScaledValue("./pcihole64", NULL,
+ ctxt, &bytes, 1024,
1024ULL * ULONG_MAX, false)) < 0)
goto error;
@@ -6684,14 +6722,14 @@ virDomainFSDefParseXML(xmlNodePtr node,
def->accessmode = VIR_DOMAIN_FS_ACCESSMODE_PASSTHROUGH;
}
- if (virDomainParseScaledValue("./space_hard_limit[1]", ctxt,
- &def->space_hard_limit, 1,
- ULLONG_MAX, false) < 0)
+ if (virDomainParseScaledValue("./space_hard_limit[1]",
+ NULL, ctxt, &def->space_hard_limit,
+ 1, ULLONG_MAX, false) < 0)
goto error;
- if (virDomainParseScaledValue("./space_soft_limit[1]", ctxt,
- &def->space_soft_limit, 1,
- ULLONG_MAX, false) < 0)
+ if (virDomainParseScaledValue("./space_soft_limit[1]",
+ NULL, ctxt, &def->space_soft_limit,
+ 1, ULLONG_MAX, false) < 0)
goto error;
cur = node->children;
@@ -9824,8 +9862,8 @@ virDomainShmemDefParseXML(xmlNodePtr node,
goto cleanup;
}
- if (virDomainParseScaledValue("./size[1]", ctxt, &def->size,
- 1, ULLONG_MAX, false) < 0)
+ if (virDomainParseScaledValue("./size[1]", NULL, ctxt,
+ &def->size, 1, ULLONG_MAX, false) < 0)
goto cleanup;
if ((server = virXPathNode("./server[1]", ctxt))) {
@@ -11965,30 +12003,15 @@ virDomainHugepagesParseXML(xmlNodePtr node,
{
int ret = -1;
xmlNodePtr oldnode = ctxt->node;
- unsigned long long bytes, max;
char *unit = NULL, *nodeset = NULL;
ctxt->node = node;
- /* On 32-bit machines, our bound is 0xffffffff * KiB. On 64-bit
- * machines, our bound is off_t (2^63). */
- if (sizeof(unsigned long) < sizeof(long long))
- max = 1024ull * ULONG_MAX;
- else
- max = LLONG_MAX;
-
- if (virXPathULongLong("string(./@size)", ctxt, &bytes) < 0) {
- virReportError(VIR_ERR_XML_DETAIL, "%s",
- _("unable to parse size attribute"));
- goto cleanup;
- }
-
- unit = virXPathString("string(./@unit)", ctxt);
-
- if (virScaleInteger(&bytes, unit, 1024, max) < 0)
+ if (virDomainParseMemory("./@size", "./@unit", ctxt,
+ &hugepage->size, true, false) < 0)
goto cleanup;
- if (!(hugepage->size = VIR_DIV_UP(bytes, 1024))) {
+ if (!hugepage->size) {
virReportError(VIR_ERR_XML_DETAIL, "%s",
_("hugepage size can't be zero"));
goto cleanup;
@@ -12225,11 +12248,11 @@ virDomainDefParseXML(xmlDocPtr xml,
goto error;
/* Extract domain memory */
- if (virDomainParseMemory("./memory[1]", ctxt,
+ if (virDomainParseMemory("./memory[1]", NULL, ctxt,
&def->mem.max_balloon, true, true) < 0)
goto error;
- if (virDomainParseMemory("./currentMemory[1]", ctxt,
+ if (virDomainParseMemory("./currentMemory[1]", NULL, ctxt,
&def->mem.cur_balloon, false, true) < 0)
goto error;
@@ -12349,19 +12372,19 @@ virDomainDefParseXML(xmlDocPtr xml,
VIR_FREE(nodes);
/* Extract other memory tunables */
- if (virDomainParseMemory("./memtune/hard_limit[1]", ctxt,
+ if (virDomainParseMemory("./memtune/hard_limit[1]", NULL, ctxt,
&def->mem.hard_limit, false, false) < 0)
goto error;
- if (virDomainParseMemory("./memtune/soft_limit[1]", ctxt,
+ if (virDomainParseMemory("./memtune/soft_limit[1]", NULL, ctxt,
&def->mem.soft_limit, false, false) < 0)
goto error;
- if (virDomainParseMemory("./memtune/min_guarantee[1]", ctxt,
+ if (virDomainParseMemory("./memtune/min_guarantee[1]", NULL, ctxt,
&def->mem.min_guarantee, false, false) < 0)
goto error;
- if (virDomainParseMemory("./memtune/swap_hard_limit[1]", ctxt,
+ if (virDomainParseMemory("./memtune/swap_hard_limit[1]", NULL, ctxt,
&def->mem.swap_hard_limit, false, false) < 0)
goto error;
--
2.0.4