summaryrefslogtreecommitdiff
path: root/en/hardware/hardware-supported.xml
diff options
context:
space:
mode:
Diffstat (limited to 'en/hardware/hardware-supported.xml')
-rw-r--r--en/hardware/hardware-supported.xml48
1 files changed, 33 insertions, 15 deletions
diff --git a/en/hardware/hardware-supported.xml b/en/hardware/hardware-supported.xml
index f1dddcc5e..fb135e6c9 100644
--- a/en/hardware/hardware-supported.xml
+++ b/en/hardware/hardware-supported.xml
@@ -349,11 +349,6 @@ With many graphics cards, basic functionality is available without
additional firmware, but the use of advanced features requires an
appropriate firmware file to be installed in the system.
-In some cases, a successful installation can still end up in a black
-screen or garbled display when rebooting into the installed system. If
-that happens, some workarounds can be tried to log in anyway (see
-<xref linkend="completing-installed-system"/>).
-
</para><para>
On many older devices which require firmware to work, the firmware file was
@@ -365,20 +360,43 @@ the host operating system every time the system boots.
</para><para>
In most cases firmware is non-free according to the criteria used by the
-&debian-gnu; project and thus cannot be included in the main distribution
-or in the installation system. If the device driver itself is included in
+&debian-gnu; project and thus cannot be included in the main distribution.
+If the device driver itself is included in
the distribution and if &debian-gnu; legally can distribute the firmware,
-it will often be available as a separate package from the non-free section
-of the archive.
+it will often be available as a separate package from the non-free-firmware section
+of the archive (prior to &debian-gnu; 12.0: from the non-free section).
+
+</para><para>
+
+However, this does not mean that such hardware cannot be used during
+installation. Starting with &debian-gnu; 12.0, following the <ulink
+url="https://www.debian.org/vote/2022/vote_003">2022 General
+Resolution about non-free firmware</ulink>, official installation
+images can include non-free firmware packages. By default, &d-i; will
+detect required firmware (based on kernel logs and modalias
+information), and install the relevant packages if they are found on
+an installation medium (e.g. on the netinst). The package manager gets
+automatically configured with the matching components so that those
+packages get security updates. This usually means that the
+non-free-firmware component gets enabled, in addition to main.
</para><para>
-However, this does not mean that such hardware cannot be used during an
-installation. Starting with &debian-gnu; 5.0, &d-i; supports loading
-firmware files or packages containing firmware from a removable medium,
-such as a USB stick.
-See <xref linkend="loading-firmware"/> for detailed information on how to
-load firmware files or packages during the installation.
+Users who wish to disable firmware lookup entirely can do so by
+setting the <userinput>firmware=never</userinput> boot parameter.
+It's an alias for the longer
+<userinput>hw-detect/firmware-lookup=never</userinput> form.
+
+</para><para>
+
+Unless firmware lookup is disabled entirely, &d-i; still supports
+loading firmware files or packages containing firmware from a
+removable medium, such as a USB stick. See <xref
+linkend="loading-firmware"/> for detailed information on how to load
+firmware files or packages during the installation.
+
+Note that &d-i; is less likely to prompt for firmware files now that
+non-free firmware packages can be included on installation images.
</para><para>