Page MenuHomeFreeBSD
Files F110174128

D29479.id86774.diff
No OneTemporary
Actions

D29479.id86774.diff
View Options

diff --git a/documentation/Makefile b/documentation/Makefile
--- a/documentation/Makefile
+++ b/documentation/Makefile
@@ -49,7 +49,7 @@
${PYTHON_CMD} ./tools/books-toc-examples-creator.py -l ${LANGUAGES}
run-local: .PHONY
- ${HUGO_CMD} server -D --baseURL="http://$(.HOST):1313"
+ ${HUGO_CMD} server -D --baseURL="http://$(.HOST):1313" ${HUGO_EXTRA}
build: .PHONY
${HUGO_CMD} --minify
diff --git a/documentation/content/en/books/handbook/x11/_index.adoc b/documentation/content/en/books/handbook/x11/_index.adoc
--- a/documentation/content/en/books/handbook/x11/_index.adoc
+++ b/documentation/content/en/books/handbook/x11/_index.adoc
@@ -205,7 +205,27 @@
[[x-config-video-cards]]
=== Video Cards
-Because of changes made in recent versions of FreeBSD, it is now possible to use graphics drivers provided by the Ports framework or as packages. As such, users can use one of the following drivers available from package:graphics/drm-kmod[].
+The Ports framework provides the drm graphics drivers necessary for X11 operation on recent hardware.
+Users can use one of the following drivers available from package:graphics/drm-kmod[].
+These drivers use interfaces in the kernel that are normally private.
+As such, it is strongly recommended that the drivers be built via the ports system, or PORTS_MODULES variable in [.filename]#/etc/make.conf.
+With `PORTS_MODULES`, the corresponding port (containing kernel modules) is re-built against the kernel sources, every time you build the kernel.
+This ensures the kernel module stays in-sync with the kernel itself.
+The kernel and ports trees should be updated together.
+You can add `PORTS_MODULES` to your [.filename]#/etc/make.conf# file to ensure all kernels you build rebuild this module.
+Advanced users can add it to their kernel config files with the `makeoptions` directive.
+If you run GENERIC and use freebsd-update, you can just build the [.filename]#graphics/drm-kmod# port after each `freebsd-update install` invocation.
+
+[example]
+====
+[.filename]#/etc/make.conf#
+
+[.programlisting]
+....
+PORTS_MODULES=graphics/drm-kmod x11/nvidia-driver
+....
+This will rebuild everything, but can select one or the other depending on which GPU / graphics card you have.
+====
[[x-config-video-cards-ports]]
Intel KMS driver, Radeon KMS driver, AMD KMS driver::
@@ -244,6 +264,15 @@
Several NVIDIA drivers are available in the [.filename]#x11# category of the Ports Collection. Install the driver that matches the video card.
+
For reference, see https://en.wikipedia.org/wiki/List_of_Nvidia_graphics_processing_units[].
++
+Kernel support for NVIDIA cards are found in [.filename]#x11/nvidia-driver# port or [.filename]#x11/nvidia-driver-xxx# port.
+Modern cards use the former.
+Legacy cards use the -xxx ports, where xxx is one of 304, 340 or 390 indicating the version of the driver.
+For those, fill in the `-xxx` using the http://download.nvidia.com/XFree86/FreeBSD-x86_64/465.19.01/README/[ Supported NvIDIA GPU Products ] page.
+This page lists the devices supported by different versions of the driver.
+Legacy drivers run on both i386 and amd64.
+The current driver only supports amd64.
+Read http://download.nvidia.com/XFree86/FreeBSD-x86_64/465.19.01/README/[installation and configuration of NVIDIA driver] for details.
[[x-config-video-cards-hybrid]]
Hybrid Combination Graphics::

File Metadata

Mime Type
text/plain
Expires
Sat, Feb 15, 3:36 PM (10 h, 6 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
16660878
Default Alt Text
D29479.id86774.diff (3 KB)

Event Timeline