From 1832e5ec6d65a61654963eb8d5645189a4a797a6 Mon Sep 17 00:00:00 2001 From: Peter Krempa Date: Thu, 10 Mar 2022 17:57:53 +0100 Subject: [PATCH] docs: Convert 'drvvmware' page to rST Signed-off-by: Peter Krempa Reviewed-by: Erik Skultety --- docs/drvvmware.html.in | 89 ------------------------------------------ docs/drvvmware.rst | 72 ++++++++++++++++++++++++++++++++++ docs/meson.build | 2 +- 3 files changed, 73 insertions(+), 90 deletions(-) delete mode 100644 docs/drvvmware.html.in create mode 100644 docs/drvvmware.rst diff --git a/docs/drvvmware.html.in b/docs/drvvmware.html.in deleted file mode 100644 index d581ad1d1c..0000000000 --- a/docs/drvvmware.html.in +++ /dev/null @@ -1,89 +0,0 @@ - - - - -

VMware Workstation / Player / Fusion hypervisors driver

-

- The libvirt VMware driver should be able to manage any Workstation, - Player, Fusion version supported by the VMware VIX API. See the - compatibility list - here. -

-

- This driver uses the "vmrun" utility which is distributed with the VMware VIX API. - You can download the VIX API - from here. -

- -

Project Links

- - - -

Connections to VMware driver

- -

- The libvirt VMware driver provides per-user drivers (the "session" instance). - Three uris are available: -

-
    -
  • "vmwareplayer" for VMware Player
    • -
  • "vmwarews" for VMware Workstation
    • -
  • "vmwarefusion" for VMware Fusion
    • -
-

- Some example connection URIs for the driver are: -

- -
-vmwareplayer:///session                  (local access to VMware Player per-user instance)
-vmwarews:///session                      (local access to VMware Workstation per-user instance)
-vmwarefusion:///session                      (local access to VMware Fusion per-user instance)
-vmwarews+tcp://user@example.com/session  (remote access to VMware Workstation, SASl/Kerberos)
-vmwarews+ssh://user@example.com/session  (remote access to VMware Workstation, SSH tunnelled)
-
- -

Example domain XML config

- -
-<domain type='vmware'>
-  <name>vmware</name>
-  <uuid>bea92244-8885-4562-828b-3b086731c5b1</uuid>
-
-  <os>
-    <type>hvm</type>
-  </os>
-
-  <memory>524288</memory>
-  <vcpu>1</vcpu>
-
-  <features>
-    <pae/>
-    <acpi/>
-  </features>
-
-  <devices>
-    <disk type='file' device='disk'>
-      <source file='/home/user/tmp/disk.vmdk'/>
-      <target bus='ide' dev='hda'/>
-    </disk>
-
-    <interface type='bridge'>
-      <target dev='/dev/vmnet1'/>
-      <source bridge=''/>
-      <mac address='00:16:3e:5d:c7:9e'/>
-    </interface>
-  </devices>
-</domain>
-
- - - diff --git a/docs/drvvmware.rst b/docs/drvvmware.rst new file mode 100644 index 0000000000..6db1a78a17 --- /dev/null +++ b/docs/drvvmware.rst @@ -0,0 +1,72 @@ +======================================================= +VMware Workstation / Player / Fusion hypervisors driver +======================================================= + +The libvirt VMware driver should be able to manage any Workstation, Player, +Fusion version supported by the VMware VIX API. See the compatibility list +`here `__. + +This driver uses the "vmrun" utility which is distributed with the VMware VIX +API. You can download the VIX API from +`here `__. + +Project Links +------------- + +- The `VMware Workstation and Player `__ hypervisors +- The `VMware Fusion `__ hypervisor + +Connections to VMware driver +---------------------------- + +The libvirt VMware driver provides per-user drivers (the "session" instance). +Three uris are available: + +- "vmwareplayer" for VMware Player +- "vmwarews" for VMware Workstation +- "vmwarefusion" for VMware Fusion + +Some example connection URIs for the driver are: + +:: + + vmwareplayer:///session (local access to VMware Player per-user instance) + vmwarews:///session (local access to VMware Workstation per-user instance) + vmwarefusion:///session (local access to VMware Fusion per-user instance) + vmwarews+tcp://user@example.com/session (remote access to VMware Workstation, SASl/Kerberos) + vmwarews+ssh://user@example.com/session (remote access to VMware Workstation, SSH tunnelled) + +Example domain XML config +------------------------- + +:: + + + vmware + bea92244-8885-4562-828b-3b086731c5b1 + + + hvm + + + 524288 + 1 + + + + + + + + + + + + + + + + + + + diff --git a/docs/meson.build b/docs/meson.build index 99732f57ba..940fbedcfa 100644 --- a/docs/meson.build +++ b/docs/meson.build @@ -22,7 +22,6 @@ docs_html_in_files = [ 'csharp', 'dbus', 'docs', - 'drvvmware', 'drvxen', 'firewall', 'format', @@ -81,6 +80,7 @@ docs_rst_files = [ 'drvtest', 'drvvbox', 'drvvirtuozzo', + 'drvvmware', 'errors', 'formatbackup', 'formatcheckpoint',