DRM [FreeBSD WIKI]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
**Information About %%FreeBSD%% Graphics: DRM-specific Notes** 

==== General ====

The way you need to manage your [[https://en.wikipedia.org/wiki/Direct_Rendering_Manager|Direct Rendering Manager]] (DRM) bits depends on your OS update strategy.

In either case you will need to install the [[https://www.freshports.org/graphics/drm-kmod/|graphics/drm-kmod]] metaport.  It should install the correct things for you for your //OSVERSION// as reported.  See the [[#tableoftruth|table below]] for further explanation of what it will try to install.

=== Release Versions ===

  * If you are running a **release** version of %%FreeBSD%%:
    * You can use ''%%pkg install%%'' to install the [[https://www.freshports.org/graphics/drm-kmod/|graphics/drm-kmod]] metaport.
    * You can use ''%%pkg upgrade%%'' to stay in sync.

=== STABLE or CURRENT Versions ===

  * If you are instead running **stable** or **current**:
    * :!: "When using stable (or current) it is important that the kernel and the drm-kmod modules are in sync." -- [[/NiclasZeising|NiclasZeising]], in [[https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=245923#c2|PR 245923]], 20200427.  Therefore:
      * You will have to **build and install** the [[https://www.freshports.org/graphics/drm-kmod/|graphics/drm-kmod]] port manually, using the Ports Collection.
      * Whenever you rebuild the kernel, you will also need to **rebuild and reinstall** graphics/drm-kmod to stay in sync.

==== What graphics/drm-kmod/Makefile Installs And Supports ====

The Table Of Truth According To [[https://svnweb.freebsd.org/ports/head/graphics/drm-kmod/Makefile|graphics/drm-kmod/Makefile]]:

^ OSVERSION range ^ package required ^ Linux equivalent ^ archs ^ comments ^
| [[https://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/versions-11.html|< 1103000]] | not supported |  |  | Please see [[https://www.freebsd.org/security/#sup|Supported FreeBSD releases]]. |
| [[https://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/versions-11.html|>= 1103000 && < 1200000]] | [[https://www.freshports.org/graphics/drm-fbsd11.2-kmod/|drm-fbsd11.2-kmod]] | 4.11 | amd64 |  |
| [[https://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/versions-12.html|>= 1200000 && < 1200058]] | not supported |  |  |  |
| [[https://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/versions-12.html|>= 1200058 && < 1300000]] | [[https://www.freshports.org/graphics/drm-fbsd12.0-kmod|drm-fbsd12.0-kmod]] | 4.16 | amd64 i386 |  |
| [[https://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/versions.html#freebsd-versions-table-13|>= 1300000 && < 1300029]] | not supported |  |  | You must upgrade to a newer -CURRENT. |
| [[https://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/versions.html#freebsd-versions-table-13|>= 1300029]] | [[https://www.freshports.org/graphics/drm-current-kmod/|drm-current-kmod]] | 4.16 | amd64 i386 powerpc64 | Recommended choice for most users of -CURRENT. |
| ::: | [[https://www.freshports.org/graphics/drm-devel-kmod|drm-devel-kmod]] | 5.3 | aarch64 amd64 i386 powerpc64 | For graphics developers using -CURRENT. Try at your own risk. Expect to be able to provide debugging information. |

:!: Support for aarch64 and powerpc64 are in beta. Try at your own risk. Expect to be able to provide debugging information.

==== See Also ====

  * [[https://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/versions.html|FreeBSD OSVERSION values]].
  * [[https://www.freebsd.org/security/#sup|Supported FreeBSD releases]].
  * Charts of where [[https://en.wikipedia.org/wiki/File:Linux_kernel_and_OpenGL_video_games.svg|DRM fits in the graphics hierarchy]]; [[https://commons.wikimedia.org/wiki/File:DRM_architecture.svg|an alternate view]].
  * A zoomed-out [[https://unix.stackexchange.com/questions/10812/module-stacking-in-linux-device-drivers|Linux graphics hierarchy]] referenced from [[https://unix.stackexchange.com/questions/10812/module-stacking-in-linux-device-drivers|this article]].
  * [[https://en.wikipedia.org/wiki/Direct_Rendering_Manager|Linux DRM Versions]] on [[http://www.wikipedia.org|wikipedia]].