Add a section specific to graphics support, content provided by

the graphics team.
Add a link to the Graphics Wiki page.

Sponsored by:	The FreeBSD Foundation
This commit is contained in:
Glen Barber 2018-12-10 21:04:21 +00:00
parent 1f34a42c0b
commit c8d26bd9e6
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=52658

View file

@ -712,6 +712,68 @@
<acronym>MMU</acronym> initialization has been added.</para> <acronym>MMU</acronym> initialization has been added.</para>
</sect2> </sect2>
<sect2 xml:id="hardware-graphics">
<title>Graphics Support</title>
<para>&os; has changed the way graphics drivers are handled on
&arch.amd64; and &arch.i386;. Graphics drivers for modern
ATI/&amd; and &intel; graphics cards are now available in the
Ports Collection. The base drivers are still available and
will be installed by default, but they lack support for
current generation laptop and desktop systems.</para>
<para>In most cases it is enough to install <filename
role="package">graphics/drm-kmod</filename>
from ports or packages to install a driver appropriate for the
system, then adding the appropriate driver to
<varname>kld_list</varname> in &man.rc.conf.5;.</para>
<para>For &intel; (i915) systems after Broadwell&trade;, the
&man.rc.conf.5; entry is:</para>
<programlisting>kld_list=/boot/modules/i915kms.ko.</programlisting>
<para>Systems with ATI/&amd; graphics cards have two options.
Modern systems starting with the HD7000 series GPU should
use:</para>
<programlisting>kld_list=/boot/modules/amdgpu.ko</programlisting>
<para>Systems with cards released before the HD7000 GPU
use:</para>
<programlisting>kld_list=/boot/modules/radeonkms.ko.</programlisting>
<note>
<para>Users must be added to the <literal>video</literal>
<acronym>GID</acronym> after installing <filename
role="package">graphics/drm-kmod</filename> in order for
<application>X</application> to start properly.</para>
</note>
<note>
<para>There are known issues with the
<literal>xserver</literal> driver provided by <filename
role="package">x11-drivers/xf86-video-ati</filename>
when using graphics drivers from the base system;
<filename
role="package">x11-drivers/xf86-video-ati-legacy</filename>
should be used instead.</para>
</note>
<note>
<para>There is a known issue where booting with
<acronym>UEFI</acronym> and using the ATI/&amd; graphics
driver may cause the screen to be garbled before the
appropriate driver is loaded.</para>
</note>
<para>For additional information regarding graphics support on
&os;, please see the <link
xlink:href="https://wiki.freebsd.org/Graphics">Graphics Wiki
Page</link>.</para>
</sect2>
<sect2 xml:id="hardware-virtualization"> <sect2 xml:id="hardware-virtualization">
<title>Virtualization Support</title> <title>Virtualization Support</title>