Skip to content

Commit

Permalink
[docs] Update the docs
Browse files Browse the repository at this point in the history
  • Loading branch information
binary-manu committed Sep 7, 2022
1 parent 382206f commit 2170b2a
Show file tree
Hide file tree
Showing 2 changed files with 11 additions and 12 deletions.
12 changes: 8 additions & 4 deletions docs/defaults.md
Original file line number Diff line number Diff line change
Expand Up @@ -337,11 +337,15 @@ virtguest_supported_hypervisors:
virtguest_virtualbox_packages:
- virtualbox-guest-utils

# If set to yes, mplugd (https://github.com/anyc/mplugd) will be installed and
# used to handle guest screen resizing in place of VBoxClient.
# These variables were used to control the installation of mplugd to handle
# guest screen resizing when the host window is resized.
# Since mplugd is no longer available due to missing dependencies, a new
# way to handle resizing has been devised, and these settings have been
# deprecated in v0.2.10. However, they are kept for compatibility, so that
# if other user-defined settings reference them, they will not throw an error.
# Setting them to true has no effect.
virtguest_virtualbox_use_mplugd: "{{ '{{' }} virtguest_use_mplugd }}" # Deprecated alias
virtguest_use_mplugd: no
```
virtguest_use_mplugd: no```

## roles/virtguest_force/defaults/main.yaml

Expand Down
11 changes: 3 additions & 8 deletions docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -900,14 +900,10 @@ hypervisor, as reported by Ansible and potentially overridden by
`virtguest_force`. It installs guest additions and any other package
required for optimal execution under an hypervisor.

When installing under VirtualBox 6.0 and above, and the VM uses the
`VBoxVGA` adapter, automatic guest screen resizing will no longer work
reliably. As a workaround, `virtguest` can be instructed to install the
`mplugd` daemon, configured to handle screen resizing. You can read more
[here][mplugd-blog-post].

When provisioning a QEMU VM, the QEMU guest agent and the SPICE agent are
installed.
installed. Also, an autostarted desktop entry is created to handle screen
autoresize inside the guest when the host window is resized. This is not
required for VirtualBox when using the `VMSVGA` adapter.

#### wireless

Expand Down Expand Up @@ -1272,7 +1268,6 @@ These paths are:
* `$PROJECT_ROOT/ansible/extra_toles`


[mplugd-blog-post]: https://binary-manu.github.io/binary-is-better/virtualbox/resize-vbox-screen-with-mplugd
[arch-way]: https://wiki.archlinux.org/index.php/Arch_Linux#Principles
[changelog]: {{ site.repository_url }}/blob/master/CHANGELOG.md
[defaults]: {{ site.baseurl }}/{% link defaults.md %}
Expand Down

0 comments on commit 2170b2a

Please sign in to comment.