From 80d0f1afb8618a529fa5910925ebd7822a3e1022 Mon Sep 17 00:00:00 2001 From: =?utf8?q?Zbigniew=20J=C4=99drzejewski-Szmek?= Date: Tue, 25 Apr 2023 18:55:41 +0200 Subject: [PATCH] man: add more info about qemu monitor This is very hard to discover, but useful. Let's give the users a hint. --- man/mkosi.1 | 7 +++++++ mkosi.md | 7 +++++++ 2 files changed, 14 insertions(+) diff --git a/man/mkosi.1 b/man/mkosi.1 index b3b226ae2..70b7d414a 100644 --- a/man/mkosi.1 +++ b/man/mkosi.1 @@ -1459,6 +1459,13 @@ fedora login: root (automatic login) .fi .PP The default is to boot with a text console only. +In this mode, messages from the boot loader, the kernel, and systemd, +and later the getty login prompt and shell all use the same terminal. +It is possible to switch between the qemu console and monitor by +pressing \f[V]Ctrl-a c\f[R]. +The qemu monitor may for example be used to inject special keys or shut +down the machine quickly. +.PP To boot with a graphical window, add \f[V]--qemu-qui\f[R]: .IP .nf diff --git a/mkosi.md b/mkosi.md index 8b07df451..59e7844eb 100644 --- a/mkosi.md +++ b/mkosi.md @@ -1387,6 +1387,13 @@ fedora login: root (automatic login) ``` The default is to boot with a text console only. +In this mode, messages from the boot loader, the kernel, and systemd, +and later the getty login prompt and shell all use the same terminal. +It is possible to switch between the qemu console and monitor +by pressing `Ctrl-a c`. +The qemu monitor may for example be used to inject special keys +or shut down the machine quickly. + To boot with a graphical window, add `--qemu-qui`: ```console $ mkosi -d fedora --qemu-gui qemu -- 2.47.2