From 0ffe70a929728415e1a84e63fa078d252112a224 Mon Sep 17 00:00:00 2001 From: Roman Bogorodskiy Date: Fri, 18 Jan 2019 18:42:02 +0400 Subject: [PATCH] docs: bhyve: document commandline element Document the element which allows to inject custom command line arguments for bhyve. Signed-off-by: Roman Bogorodskiy Reviewed-by: John Ferlan --- docs/drvbhyve.html.in | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/docs/drvbhyve.html.in b/docs/drvbhyve.html.in index b4d7df2edb..fb73b4819b 100644 --- a/docs/drvbhyve.html.in +++ b/docs/drvbhyve.html.in @@ -460,6 +460,28 @@ Example:

</cpu> ... </domain> + + +

Pass-through of arbitrary bhyve commands

+ +

Since 5.1.0, it's possible to pass additional command-line +arguments to the bhyve process when starting the domain using the +<bhyve:commandline> element under domain. +To supply an argument, use the element <bhyve:arg> with +the attribute value set to additional argument to be added. +The arg element may be repeated multiple times. To use this XML addition, it is necessary +to issue an XML namespace request (the special xmlns:name attribute) +that pulls in http://libvirt.org/schemas/domain/bhyve/1.0; +typically, the namespace is given the name of bhyve. +

+

Example:

+
+<domain type="bhyve" xmlns:bhyve="http://libvirt.org/schemas/domain/bhyve/1.0">
+  ...
+  <bhyve:commandline>
+    <bhyve:arg value='-somebhyvearg'/>
+  </bhyve:commandline>
+</domain>
-- GitLab