Skip to content

Commit a2d06e4

Browse files
philcliffordphilclifford
committed
docs: align manual pages with release 4.9.8
Signed-off-by: Phil Clifford <philip.clifford@gmail.com>
1 parent e03e29d commit a2d06e4

File tree

7 files changed

+140
-109
lines changed

7 files changed

+140
-109
lines changed

‎build-docs‎

‎docs/quickemu.1‎

Lines changed: 42 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
.\" Automatically generated by Pandoc 3.7.0.2
1+
.\" Automatically generated by Pandoc 3.8.3
22
.\"
3-
.TH "QUICKEMU" "1" "July 31, 2025" "quickemu" "Quickemu User Manual"
3+
.TH "QUICKEMU" "1" "January 28, 2026" "quickemu" "Quickemu User Manual"
44
.SH NAME
55
quickemu \- A quick VM builder and manager
66
.SH SYNOPSIS
@@ -191,6 +191,9 @@ Mojave
191191
.IP \(bu 2
192192
\f[B]Windows Server\f[R] 2022 2019 2016
193193
.IP \(bu 2
194+
\f[B]ARM64 guest support\f[R] for running aarch64 VMs (native on ARM
195+
hosts, emulated on x86_64)
196+
.IP \(bu 2
194197
\c
195198
.UR https://ubuntu.com/desktop
196199
Ubuntu
@@ -570,18 +573,19 @@ wiki
570573
You can also use \f[CR]quickget\f[R] with advanced options :
571574
.IP
572575
.EX
573-
\-\-download <os> <release> [edition] : Download image; no VM configuration
574-
\-\-create\-config <os> [path/url] [flags] : Create VM config for an OS image
575-
\-\-open\-homepage <os> : Open homepage for the OS
576-
\-\-show [os] : Show OS information
577-
\-\-version : Show version
578-
\-\-help : Show this help message
579-
\-\-disable\-unattended : Force quickget not to set up an unattended installation
580-
\-\-url [os] [release] [edition] : Show image URL(s)
581-
\-\-check [os] [release] [edition] : Check image URL(s)
582-
\-\-list : List all supported systems
583-
\-\-list\-csv : List everything in csv format
584-
\-\-list\-json : List everything in json format
576+
\-\-arch <arch> : Set architecture (arm64, aarch64, amd64, x86_64)
577+
\-\-download <os> <release> [edition] : Download image; no VM configuration
578+
\-\-create\-config <os> [path/url] [flags] : Create VM config for an OS image
579+
\-\-open\-homepage <os> : Open homepage for the OS
580+
\-\-show [os] : Show OS information
581+
\-\-version : Show version
582+
\-\-help : Show this help message
583+
\-\-url [os] [release] [edition] : Show image URL(s)
584+
\-\-check [os] [release] [edition] : Check image URL(s)
585+
\-\-check\-all\-arch [os] [release] [edition]: Check downloads for all architectures (amd64 and arm64)
586+
\-\-list : List all supported systems
587+
\-\-list\-csv : List everything in csv format
588+
\-\-list\-json : List everything in json format
585589
.EE
586590
.PP
587591
Here are some typical uses
@@ -622,7 +626,7 @@ wiki
622626
.IP \(bu 2
623627
\f[CR]artixlinux\f[R] (Artix Linux)
624628
.IP \(bu 2
625-
\f[CR]athenaos\f[R] (Athena OS)
629+
\f[CR]azurelinux\f[R] (Azure Linux)
626630
.IP \(bu 2
627631
\f[CR]batocera\f[R] (Batocera)
628632
.IP \(bu 2
@@ -678,8 +682,6 @@ wiki
678682
.IP \(bu 2
679683
\f[CR]haiku\f[R] (Haiku)
680684
.IP \(bu 2
681-
\f[CR]holoiso\f[R] (HoloISO)
682-
.IP \(bu 2
683685
\f[CR]kali\f[R] (Kali)
684686
.IP \(bu 2
685687
\f[CR]kdeneon\f[R] (KDE Neon)
@@ -752,26 +754,22 @@ wiki
752754
.IP \(bu 2
753755
\f[CR]solus\f[R] (Solus)
754756
.IP \(bu 2
757+
\f[CR]sparkylinux\f[R] (SparkyLinux)
758+
.IP \(bu 2
755759
\f[CR]spirallinux\f[R] (SpiralLinux)
756760
.IP \(bu 2
757761
\f[CR]tails\f[R] (Tails)
758762
.IP \(bu 2
759763
\f[CR]tinycore\f[R] (Tiny Core Linux)
760764
.IP \(bu 2
761-
\f[CR]trisquel\f[R] (Trisquel\-)
762-
.IP \(bu 2
763-
\f[CR]truenas\-core\f[R] (TrueNAS Core)
764-
.IP \(bu 2
765-
\f[CR]truenas\-scale\f[R] (TrueNAS Scale)
765+
\f[CR]trisquel\f[R] (Trisquel)
766766
.IP \(bu 2
767767
\f[CR]tuxedo\-os\f[R] (Tuxedo OS)
768768
.IP \(bu 2
769769
\f[CR]vanillaos\f[R] (Vanilla OS)
770770
.IP \(bu 2
771771
\f[CR]void\f[R] (Void Linux)
772772
.IP \(bu 2
773-
\f[CR]vxlinux\f[R] (VX Linux)
774-
.IP \(bu 2
775773
\f[CR]zorin\f[R] (Zorin OS)
776774
.SS \c
777775
.UR https://github.com/quickemu-project/quickemu/wiki/02-Create-Linux-virtual-machines#manually-create-linux-guests
@@ -827,6 +825,17 @@ check the Discussions
827825
.PP
828826
\f[CR]quickget\f[R] automatically downloads a macOS recovery image and
829827
creates a virtual machine configuration.
828+
.PP
829+
Note: Some VPN users may need to \c
830+
.UR https://github.com/quickemu-project/quickemu/issues/1391#issuecomment-3506845235
831+
turn off their VPN
832+
.UE \c
833+
\ in order to download a recovery image.
834+
Some other users may find \c
835+
.UR https://github.com/quickemu-project/quickemu/issues/1391#issuecomment-2429146013
836+
using a VPN
837+
.UE \c
838+
\ necessary in order to download a recovery image.
830839
.IP
831840
.EX
832841
quickget macos big\-sur
@@ -931,16 +940,16 @@ The default macOS configuration looks like this:
931940
.IP
932941
.EX
933942
guest_os=\(dqmacos\(dq
934-
img=\(dqmacos\- big\-sur/RecoveryImage.img\(dq
935-
disk_img=\(dqmacos\- big\-sur/disk.qcow2\(dq
936-
macos_release=\(dq big\-sur\(dq
943+
img=\(dqmacos\-big\-sur/RecoveryImage.img\(dq
944+
disk_img=\(dqmacos\-big\-sur/disk.qcow2\(dq
945+
macos_release=\(dqbig\-sur\(dq
937946
.EE
938947
.IP \(bu 2
939948
\f[CR]guest_os=\(dqmacos\(dq\f[R] instructs Quickemu to optimise for
940949
macOS.
941950
.IP \(bu 2
942-
\f[CR]macos_release=\(dq big\-sur\(dq\f[R] instructs Quickemu to
943-
optimise for a particular macOS release.
951+
\f[CR]macos_release=\(dqbig\-sur\(dq\f[R] instructs Quickemu to optimise
952+
for a particular macOS release.
944953
.RS 2
945954
.IP \(bu 2
946955
For example VirtIO Network and Memory Ballooning are available in Big
@@ -1144,11 +1153,13 @@ Usage
11441153
Arguments
11451154
\-\-access : Enable remote spice access support. \(aqlocal\(aq (default), \(aqremote\(aq, \(aqclientipaddress\(aq
11461155
\-\-braille : Enable braille support. Requires SDL.
1156+
\-\-cpu\-pinning : Choose which host cores correspond to which guest cores.
11471157
\-\-delete\-disk : Delete the disk image and EFI variables
11481158
\-\-delete\-vm : Delete the entire VM and its configuration
1149-
\-\-display : Select display backend. \(aqsdl\(aq (default), \(aqcocoa\(aq, \(aqgtk\(aq, \(aqnone\(aq, \(aqspice\(aq or \(aqspice\-app\(aq
1159+
\-\-display : Select display backend. \(aqgtk\(aq (default), \(aqsdl\(aq, \(aqcocoa\(aq, \(aqnone\(aq, \(aqspice\(aq or \(aqspice\-app\(aq
11501160
\-\-fullscreen : Starts VM in full screen mode (Ctl+Alt+f to exit)
11511161
\-\-ignore\-msrs\-always : Configure KVM to always ignore unhandled machine\-specific registers
1162+
\-\-ignore\-tsc\-warning : Skip TSC stability warning for macOS VMs on AMD
11521163
\-\-kill : Kill the VM process if it is running
11531164
\-\-offline : Override all network settings and start the VM offline
11541165
\-\-shortcut : Create a desktop shortcut
@@ -1174,7 +1185,7 @@ Arguments
11741185
\-\-keyboard_layout <layout> : Set keyboard layout: \(aqen\-us\(aq (default)
11751186
\-\-mouse <type> : Set mouse. \(atOptions: \(aqtablet\(aq (default), \(aqps2\(aq, \(aqusb\(aq, \(aqvirtio\(aq
11761187
\-\-usb\-controller <type> : Set usb\-controller. \(atOptions: \(aqehci\(aq (default), \(aqxhci\(aq, \(aqnone\(aq
1177-
\-\-sound\-card <type> : Set sound card. \(atOptions: \(aqintel\-hda\(aq (default), \(aqac97\(aq, \(aqes1370\(aq, \(aqsb16\(aq, \(aqusb\-audio\(aq, \(aqnone\(aq
1188+
\-\-sound\-card <type> : Set sound card. \(atOptions: \(aqintel\-hda\(aq (default), \(aqac97\(aq, \(aqes1370\(aq, \(aqsb16\(aq, \(aqusb\-audio\(aq, \(aqvirtio\-sound\-pci\(aq, \(aqnone\(aq
11781189
\-\-sound\-duplex <type> : Set sound card duplex. \(atOptions: \(aqhda\-micro\(aq (default: speaker/mic), \(aqhda\-duplex\(aq (line\-in/line\-out), \(aqhda\-output\(aq (output\-only)
11791190
\-\-extra_args <arguments> : Pass additional arguments to qemu
11801191
\-\-version : Print version

‎docs/quickemu.1.md‎

Lines changed: 34 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
author: Martin Wimpress
3-
date: July 31, 2025
3+
date: January 28, 2026
44
footer: quickemu
55
header: Quickemu User Manual
66
section: 1
@@ -177,6 +177,8 @@ Haiku, KolibriOS, OpenIndiana, ReactOS, and more.
177177
Mojave
178178
- **Windows** 10 and 11 including TPM 2.0
179179
- **Windows Server** 2022 2019 2016
180+
- **ARM64 guest support** for running aarch64 VMs (native on ARM hosts,
181+
emulated on x86_64)
180182
- [Ubuntu](https://ubuntu.com/desktop) and all the **[official Ubuntu
181183
flavours](https://ubuntu.com/download/flavours)**
182184
- **Nearly 1000 operating system editions are supported!**
@@ -397,18 +399,19 @@ may have further information.
397399
You can also use `quickget` with advanced options :
398400

399401
``` text
400-
--download <os> <release> [edition] : Download image; no VM configuration
401-
--create-config <os> [path/url] [flags] : Create VM config for an OS image
402-
--open-homepage <os> : Open homepage for the OS
403-
--show [os] : Show OS information
404-
--version : Show version
405-
--help : Show this help message
406-
--disable-unattended : Force quickget not to set up an unattended installation
407-
--url [os] [release] [edition] : Show image URL(s)
408-
--check [os] [release] [edition] : Check image URL(s)
409-
--list : List all supported systems
410-
--list-csv : List everything in csv format
411-
--list-json : List everything in json format
402+
--arch <arch> : Set architecture (arm64, aarch64, amd64, x86_64)
403+
--download <os> <release> [edition] : Download image; no VM configuration
404+
--create-config <os> [path/url] [flags] : Create VM config for an OS image
405+
--open-homepage <os> : Open homepage for the OS
406+
--show [os] : Show OS information
407+
--version : Show version
408+
--help : Show this help message
409+
--url [os] [release] [edition] : Show image URL(s)
410+
--check [os] [release] [edition] : Check image URL(s)
411+
--check-all-arch [os] [release] [edition]: Check downloads for all architectures (amd64 and arm64)
412+
--list : List all supported systems
413+
--list-csv : List everything in csv format
414+
--list-json : List everything in json format
412415
```
413416

414417
Here are some typical uses
@@ -441,7 +444,7 @@ Further information is available from the project
441444
- `archcraft` (Archcraft)
442445
- `archlinux` (Arch Linux)
443446
- `artixlinux` (Artix Linux)
444-
- `athenaos` (Athena OS)
447+
- `azurelinux` (Azure Linux)
445448
- `batocera` (Batocera)
446449
- `bazzite` (Bazzite)
447450
- `biglinux` (BigLinux)
@@ -469,7 +472,6 @@ Further information is available from the project
469472
- `gnomeos` (GNOME OS)
470473
- `guix` (Guix)
471474
- `haiku` (Haiku)
472-
- `holoiso` (HoloISO)
473475
- `kali` (Kali)
474476
- `kdeneon` (KDE Neon)
475477
- `kolibrios` (KolibriOS)
@@ -506,16 +508,14 @@ Further information is available from the project
506508
- `slint` (Slint)
507509
- `slitaz` (SliTaz)
508510
- `solus` (Solus)
511+
- `sparkylinux` (SparkyLinux)
509512
- `spirallinux` (SpiralLinux)
510513
- `tails` (Tails)
511514
- `tinycore` (Tiny Core Linux)
512-
- `trisquel` (Trisquel-)
513-
- `truenas-core` (TrueNAS Core)
514-
- `truenas-scale` (TrueNAS Scale)
515+
- `trisquel` (Trisquel)
515516
- `tuxedo-os` (Tuxedo OS)
516517
- `vanillaos` (Vanilla OS)
517518
- `void` (Void Linux)
518-
- `vxlinux` (VX Linux)
519519
- `zorin` (Zorin OS)
520520

521521
### [Custom Linux guests](https://github.com/quickemu-project/quickemu/wiki/02-Create-Linux-virtual-machines#manually-create-linux-guests)
@@ -561,6 +561,13 @@ for solutions or ask for help there** 🛟
561561
`quickget` automatically downloads a macOS recovery image and creates a
562562
virtual machine configuration.
563563

564+
Note: Some VPN users may need to [turn off their
565+
VPN](https://github.com/quickemu-project/quickemu/issues/1391#issuecomment-3506845235)
566+
in order to download a recovery image. Some other users may find [using
567+
a
568+
VPN](https://github.com/quickemu-project/quickemu/issues/1391#issuecomment-2429146013)
569+
necessary in order to download a recovery image.
570+
564571
``` shell
565572
quickget macos big-sur
566573
quickemu --vm macos-big-sur.conf
@@ -635,13 +642,13 @@ The default macOS configuration looks like this:
635642

636643
``` shell
637644
guest_os="macos"
638-
img="macos- big-sur/RecoveryImage.img"
639-
disk_img="macos- big-sur/disk.qcow2"
640-
macos_release=" big-sur"
645+
img="macos-big-sur/RecoveryImage.img"
646+
disk_img="macos-big-sur/disk.qcow2"
647+
macos_release="big-sur"
641648
```
642649

643650
- `guest_os="macos"` instructs Quickemu to optimise for macOS.
644-
- `macos_release=" big-sur"` instructs Quickemu to optimise for a
651+
- `macos_release="big-sur"` instructs Quickemu to optimise for a
645652
particular macOS release.
646653
- For example VirtIO Network and Memory Ballooning are available in
647654
Big Sur and newer, but not previous releases.
@@ -758,11 +765,13 @@ Usage
758765
Arguments
759766
--access : Enable remote spice access support. 'local' (default), 'remote', 'clientipaddress'
760767
--braille : Enable braille support. Requires SDL.
768+
--cpu-pinning : Choose which host cores correspond to which guest cores.
761769
--delete-disk : Delete the disk image and EFI variables
762770
--delete-vm : Delete the entire VM and its configuration
763-
--display : Select display backend. 'sdl' (default), 'cocoa', 'gtk', 'none', 'spice' or 'spice-app'
771+
--display : Select display backend. 'gtk' (default), 'sdl', 'cocoa', 'none', 'spice' or 'spice-app'
764772
--fullscreen : Starts VM in full screen mode (Ctl+Alt+f to exit)
765773
--ignore-msrs-always : Configure KVM to always ignore unhandled machine-specific registers
774+
--ignore-tsc-warning : Skip TSC stability warning for macOS VMs on AMD
766775
--kill : Kill the VM process if it is running
767776
--offline : Override all network settings and start the VM offline
768777
--shortcut : Create a desktop shortcut
@@ -788,7 +797,7 @@ Arguments
788797
--keyboard_layout <layout> : Set keyboard layout: 'en-us' (default)
789798
--mouse <type> : Set mouse. @Options: 'tablet' (default), 'ps2', 'usb', 'virtio'
790799
--usb-controller <type> : Set usb-controller. @Options: 'ehci' (default), 'xhci', 'none'
791-
--sound-card <type> : Set sound card. @Options: 'intel-hda' (default), 'ac97', 'es1370', 'sb16', 'usb-audio', 'none'
800+
--sound-card <type> : Set sound card. @Options: 'intel-hda' (default), 'ac97', 'es1370', 'sb16', 'usb-audio', 'virtio-sound-pci', 'none'
792801
--sound-duplex <type> : Set sound card duplex. @Options: 'hda-micro' (default: speaker/mic), 'hda-duplex' (line-in/line-out), 'hda-output' (output-only)
793802
--extra_args <arguments> : Pass additional arguments to qemu
794803
--version : Print version

‎docs/quickemu_conf.5‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
.\" Automatically generated by Pandoc 3.7.0.2
1+
.\" Automatically generated by Pandoc 3.8.3
22
.\"
3-
.TH "QUICKEMU_CONF" "5" "July 31, 2025" "quickemu_conf" "Quickemu Configuration Manual"
3+
.TH "QUICKEMU_CONF" "5" "January 28, 2026" "quickemu_conf" "Quickemu Configuration Manual"
44
.SH NAME
55
quickemu_conf \- Options and parameters in the quickemu <vm>.conf
66
.SH DESCRIPTION

‎docs/quickemu_conf.5.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
author: Martin Wimpress
3-
date: July 31, 2025
3+
date: January 28, 2026
44
footer: quickemu_conf
55
header: Quickemu Configuration Manual
66
section: 5

0 commit comments

Comments
 (0)