openkylin
/
libvirt
mirror of https://gitee.com/openkylin/libvirt.git
9
0
Fork 0
Code Issues Projects Releases Wiki Activity

docs: document nmdm type console 

* Add nmdm type device to domain format documnetation
* Add a section about nmdm console usage to the bhyve driver
  documentation
This commit is contained in:
Roman Bogorodskiy 2014-04-21 17:16:58 +04:00
parent 9556681388
commit 6d0a617568
2 changed files with 61 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
docs/drvbhyve.html.in
View File

@ -79,5 +79,37 @@ in libvirt bhyve driver is yet to be implemented).
</domain> </domain>
</pre> </pre>
<h2><a name="usage">Guest usage / management</a></h2>
<h3><a name="console">Connecting to a guest console</a></h3>
<p>
Guest console connection is supported through the <code>nmdm</code> device. It could be enabled by adding
the following to the domain XML (<span class="since">Since 1.2.4</span>):
</p>
<pre>
...
&lt;devices&gt;
&lt;serial type="nmdm"&gt;
&lt;source master="/dev/nmdm0A" slave="/dev/nmdm0B"/&gt;
&lt;/serial&gt;
&lt;/devices&gt;
...</pre>
<p>
Then <code>virsh console</code> command can be used to connect to the text console
of a guest.</p>
<p><b>NB:</b> Some versions of bhyve have a bug that prevents guests from booting
until the console is opened by a client. This bug was fixed in FreeBSD
<a href="http://svnweb.freebsd.org/changeset/base/262884">r262884</a>. If
an older version is used, one either has to open a console manually with <code>virsh console</code>
to let a guest boot or start a guest using:</p>
<pre>start --console domname</pre>
</body> </body>
</html> </html>

29
docs/formatdomain.html.in
View File

@ -4782,6 +4782,35 @@ qemu-kvm -net nic,model=? /dev/null
&lt;/devices&gt; &lt;/devices&gt;
...</pre> ...</pre>
<h6><a name="elementsNmdm">Nmdm device</a></h6>
<p>
The nmdm device driver, available on FreeBSD, provides two
tty devices connected together by a virual null modem cable.
<span class="since">Since 1.2.4</span>
</p>
<pre>
...
&lt;devices&gt;
&lt;serial type="nmdm"&gt;
&lt;source master="/dev/nmdm0A" slave="/dev/nmdm0B"/&gt;
&lt;/serial&gt;
&lt;/devices&gt;
...</pre>
<p>
The <code>source</code> element has these attributes:
</p>
<dl>
<dt><code>master</code></dt>
<dd>Master device of the pair, that is passed to the hypervisor.</dd>
<dt><code>slave</code></dt>
<dd>Slave device of the pair, that is passed to the clients for connection
to the guest console.</dd>
</dl>
<h4><a name="elementsSound">Sound devices</a></h4> <h4><a name="elementsSound">Sound devices</a></h4>