Document the <bhyve:commandline> element which allows
to inject custom command line arguments for bhyve.

Signed-off-by: Roman Bogorodskiy <bogorodskiy@gmail.com>
---
 docs/drvbhyve.html.in | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/docs/drvbhyve.html.in b/docs/drvbhyve.html.in
index b4d7df2edb..d3c1585e33 100644
--- a/docs/drvbhyve.html.in
+++ b/docs/drvbhyve.html.in
@@ -460,6 +460,26 @@ Example:</p>
     &lt;/cpu&gt;
     ...
 &lt;/domain&gt;
+</pre>
+
+<h3><a id="bhyvecommand">Pass-through of arbitrary bhyve commands</a></h3>
+
+<p><span class="since">Since 5.1.0</span>, it's possible to pass additional command-line
+arguments to the bhyve process when starting the domain using the
+<code>&lt;bhyve:commandline&gt;</code> element under <code>domain</code>.
+This element could be repeated multiple times. To use this XML addition, it is necessary
+to issue an XML namespace request (the special <code>xmlns:<i>name</i></code> attribute)
+that pulls in <code>http://libvirt.org/schemas/domain/bhyve/1.0</code>;
+typically, the namespace is given the name of <code>bhyve</code>.
+</p>
+<p>Example:</p>
+<pre>
+&lt;domain type="bhyve" xmlns:bhyve="http://libvirt.org/schemas/domain/bhyve/1.0"&gt;
+  ...
+  &lt;bhyve:commandline&gt;
+    &lt;bhyve:arg value='-somebhyvearg'/&gt;
+  &lt;/bhyve:commandline&gt;
+&lt;/domain&gt;
 </pre>
 
   </body>
-- 
2.20.1

--
libvir-list mailing list
libvir-list@redhat.com
https://www.redhat.com/mailman/listinfo/libvir-list

On 1/18/19 10:41 AM, Roman Bogorodskiy wrote:
> Document the <bhyve:commandline> element which allows
> to inject custom command line arguments for bhyve.
> 
> Signed-off-by: Roman Bogorodskiy <bogorodskiy@gmail.com>
> ---
>  docs/drvbhyve.html.in | 20 ++++++++++++++++++++
>  1 file changed, 20 insertions(+)
> 
> diff --git a/docs/drvbhyve.html.in b/docs/drvbhyve.html.in
> index b4d7df2edb..d3c1585e33 100644
> --- a/docs/drvbhyve.html.in
> +++ b/docs/drvbhyve.html.in
> @@ -460,6 +460,26 @@ Example:</p>
>      &lt;/cpu&gt;
>      ...
>  &lt;/domain&gt;
> +</pre>
> +
> +<h3><a id="bhyvecommand">Pass-through of arbitrary bhyve commands</a></h3>
> +
> +<p><span class="since">Since 5.1.0</span>, it's possible to pass additional command-line
> +arguments to the bhyve process when starting the domain using the
> +<code>&lt;bhyve:commandline&gt;</code> element under <code>domain</code>.

To supply an argument, use the element <code>&lt;bhyve:arg</code> with
the attribute <code>value</code> set to addition argument to be added.

> +This element could be repeated multiple times. To use this XML addition, it is necessary

s/This element could be/The arg element may be/

Reviewed-by: John Ferlan <jferlan@redhat.com>

John

> +to issue an XML namespace request (the special <code>xmlns:<i>name</i></code> attribute)
> +that pulls in <code>http://libvirt.org/schemas/domain/bhyve/1.0</code>;
> +typically, the namespace is given the name of <code>bhyve</code>.
> +</p>
> +<p>Example:</p>
> +<pre>
> +&lt;domain type="bhyve" xmlns:bhyve="http://libvirt.org/schemas/domain/bhyve/1.0"&gt;
> +  ...
> +  &lt;bhyve:commandline&gt;
> +    &lt;bhyve:arg value='-somebhyvearg'/&gt;
> +  &lt;/bhyve:commandline&gt;
> +&lt;/domain&gt;
>  </pre>
>  
>    </body>
> 

--
libvir-list mailing list
libvir-list@redhat.com
https://www.redhat.com/mailman/listinfo/libvir-list

On Fri, Jan 18, 2019 at 07:41:01PM +0400, Roman Bogorodskiy wrote:
> Document the <bhyve:commandline> element which allows
> to inject custom command line arguments for bhyve.
> 
> Signed-off-by: Roman Bogorodskiy <bogorodskiy@gmail.com>
> ---
>  docs/drvbhyve.html.in | 20 ++++++++++++++++++++
>  1 file changed, 20 insertions(+)
> 
> diff --git a/docs/drvbhyve.html.in b/docs/drvbhyve.html.in
> index b4d7df2edb..d3c1585e33 100644
> --- a/docs/drvbhyve.html.in
> +++ b/docs/drvbhyve.html.in
> @@ -460,6 +460,26 @@ Example:</p>
>      &lt;/cpu&gt;
>      ...
>  &lt;/domain&gt;
> +</pre>
> +
> +<h3><a id="bhyvecommand">Pass-through of arbitrary bhyve commands</a></h3>
> +
> +<p><span class="since">Since 5.1.0</span>, it's possible to pass additional command-line
> +arguments to the bhyve process when starting the domain using the
> +<code>&lt;bhyve:commandline&gt;</code> element under <code>domain</code>.
> +This element could be repeated multiple times. To use this XML addition, it is necessary
> +to issue an XML namespace request (the special <code>xmlns:<i>name</i></code> attribute)
> +that pulls in <code>http://libvirt.org/schemas/domain/bhyve/1.0</code>;
> +typically, the namespace is given the name of <code>bhyve</code>.


Can you expand this text to mention that when using this feature there
is zero guarantee that the usage will work the same way in future libvirt
releases. It is something that is valid to use for experimenting with
features prior to implementing official support in libvirt, but should
not be used in production deployments.

> +</p>
> +<p>Example:</p>
> +<pre>
> +&lt;domain type="bhyve" xmlns:bhyve="http://libvirt.org/schemas/domain/bhyve/1.0"&gt;
> +  ...
> +  &lt;bhyve:commandline&gt;
> +    &lt;bhyve:arg value='-somebhyvearg'/&gt;
> +  &lt;/bhyve:commandline&gt;
> +&lt;/domain&gt;
>  </pre>
>  
>    </body>
> -- 
> 2.20.1
> 
> --
> libvir-list mailing list
> libvir-list@redhat.com
> https://www.redhat.com/mailman/listinfo/libvir-list

Regards,
Daniel
-- 
|: https://berrange.com      -o-    https://www.flickr.com/photos/dberrange :|
|: https://libvirt.org         -o-            https://fstop138.berrange.com :|
|: https://entangle-photo.org    -o-    https://www.instagram.com/dberrange :|

--
libvir-list mailing list
libvir-list@redhat.com
https://www.redhat.com/mailman/listinfo/libvir-list