From e88ee68c09266e1d09d24ff0d1b6ec6a4708841b Mon Sep 17 00:00:00 2001 From: Florian Pelz Date: Wed, 24 Jul 2019 23:02:21 +0200 Subject: [PATCH] doc: Mention AMD Radeon workaround when TTYs are not redrawn. * doc/guix.texi (Hardware Considerations): Describe workaround. --- doc/guix.texi | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/doc/guix.texi b/doc/guix.texi index f6d9718f59..b9e18e55c4 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -1879,6 +1879,24 @@ Another useful resource is the @uref{https://www.h-node.org/, H-Node} web site. It contains a catalog of hardware devices with information about their support in GNU/Linux. +Some hardware requires specific tweaks to work better with Guix System. The +following is an incomplete list of known workarounds: + +@itemize +@item +Some @emph{AMD Radeon} graphics cards stop redrawing the virtual console TTYs +when booting because of an error with Kernel Mode Setting. The problem +disappears when blacklisting the kernel module for the driver. To do so, you +can add @code{modprobe.blacklist=radeon} to the Linux-libre kernel flags, +either for only one boot by pressing the @kbd{e} key in the GRUB bootloader +and adding this kernel flag to the end of the @code{linux} command-line, or +permanently by changing the @code{kernel-arguments} field in your +@code{operating-system} declaration, e.g.: + +@example +(kernel-arguments '("quiet" "modprobe.blacklist=radeon")) +@end example +@end itemize @node USB Stick and DVD Installation @section USB Stick and DVD Installation -- 2.22.0