Updated for commits direct to README

This commit is contained in:
Phil Clifford 2022-08-19 20:10:21 +01:00 committed by Martin Wimpress
parent d669c4ca2a
commit 8bb24f69c0
8 changed files with 228 additions and 90 deletions

View file

@ -1,4 +1,4 @@
.\" Automatically generated by Pandoc 2.18
.\" Automatically generated by Pandoc 2.19
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
@ -14,7 +14,7 @@
. ftr VB CB
. ftr VBI CBI
.\}
.TH "QUICKEMU" "1" "August 1, 2022" "quickemu" "Quickemu User Manual"
.TH "QUICKEMU" "1" "August 19, 2022" "quickemu" "Quickemu User Manual"
.hy
.SH NAME
.PP
@ -75,8 +75,8 @@ Do not commit any changes to disk/snapshot.
Print version
.SH EXAMPLES
.TP
\f[B]quickemu \[en]vm ubuntu-mate-22.04-.conf\f[R]
Launches the VM specified in the file \f[I]ubuntu-mate-22.04-.conf\f[R]
\f[B]quickemu \[en]vm ubuntu-mate-22.04.conf\f[R]
Launches the VM specified in the file \f[I]ubuntu-mate-22.04.conf\f[R]
.SS Introduction
.PP
Quickly create and run highly optimised desktop virtual machines for
@ -88,7 +88,7 @@ For example:
.nf
\f[C]
quickget ubuntu-mate 22.04
quickemu --vm ubuntu-mate-22.04-.conf
quickemu --vm ubuntu-mate-22.04.conf
\f[R]
.fi
.PP
@ -400,6 +400,8 @@ All the official Ubuntu flavours are supported, just replace
.IP \[bu] 2
\f[V]popos\f[R] (Pop!_OS)
.IP \[bu] 2
\f[V]reactos\f[R] (ReactOS)
.IP \[bu] 2
\f[V]regolith\f[R] (Regolith Linux)
.IP \[bu] 2
\f[V]rockylinux\f[R] (Rocky Linux)
@ -585,17 +587,40 @@ XHCI (USB 3.0) on macOS Big Sur and newer.
.IP \[bu] 2
Display resolution can only be changed via macOS System Preferences.
.IP \[bu] 2
Full Duplex audio works on macOS High Sierra, Mojave and Catalina.
.RS 2
\f[B]Full Duplex audio requires VoodooHDA
OC (https://github.com/chris1111/VoodooHDA-OC) or pass-through a USB
audio-device to the macOS guest VM\f[R].
.IP \[bu] 2
\f[B]macOS Big Sur and Monterey have no audio at all\f[R].
.RE
NOTE!
Gatekeeper (https://disable-gatekeeper.github.io/) and System Integrity
Protection
(SIP) (https://developer.apple.com/documentation/security/disabling_and_enabling_system_integrity_protection)
need to be disabled to install VoodooHDA OC
.IP \[bu] 2
File sharing between guest and host is available via
virtio-9p (https://wiki.qemu.org/Documentation/9psetup) and SPICE
webdavd (https://gitlab.gnome.org/GNOME/phodav/-/merge_requests/24).
.IP \[bu] 2
Copy/paste via SPICE agent is \f[B]not available on macOS\f[R].
.SS macOS App Store
.PP
If you see \f[I]\[lq]Your device or computer could not be
verified\[rq]\f[R] when you try to login to the App Store, make sure
that your wired ethernet device is \f[V]en0\f[R].
Use \f[V]ifconfig\f[R] in a terminal to verify this.
.PP
If the wired ethernet device is not \f[V]en0\f[R], then then go to
\f[I]System Preferences\f[R] -> \f[I]Network\f[R], delete all the
network devices and apply the changes.
Next, open a terminal and run the following:
.IP
.nf
\f[C]
sudo rm /Library/Preferences/SystemConfiguration/NetworkInterfaces.plist
\f[R]
.fi
.PP
Now reboot, and the App Store should work.
.SS Windows 8.1, 10 & 11 Guests
.PP
\f[V]quickget\f[R] can automatically download Windows 8.1, Windows