I just want to fix that black screen when I start an X session

And much much more…

The handbook is great but sometimes it just isn't as friendly as descriptive as you would like it to be. This is a Wiki page to share our hacks, arcane knowledge, workarounds and diagnosis tricks.

• People tend to put hardware-specific solutions on the Laptops wiki pages. You might want to check them out.
  • X

• Chapter 5. The X Window System (FreeBSD Handbook)

You can list your graphics hardware with:

pciconf -lv | grep display -B 3 -A 1

Check out Graphics.

If it is not supported then you might want to check out:

• Graphics/SCFB

This subsection is a work in progress. Ping us on an IRC channel or a mailing list if you spot an error or you know how to fill in the missing information.

• You need a kernel driver and an Xorg driver.
  • Example:
    • An example of an Xorg driver would be xf86-video-intel. It does not bring support for any new hardware. That's what the kernel driver is for.
    • An example of a kernel driver would be drm-next-kmod.
      • drm-next-kmod specifically is meant to replace an older kernel driver that comes in the FreeBSD 11 release.
    • You would use xf86-video-intel on both drm-next-kmod and without it as xf86-video-intel is a userspace driver to drive the X server.
    • You might not need to install xf86-video-intel and still have graphics running as there is a generic KMS driver called modesetting already included in the xorg package. Installing xf86-video-intel might not be necessary but would give you more control over how your graphics is rendered (see intel(4) for more details).

The table is based on the one from Graphics, which is updated much more often.

• The i915kms kernel-side driver is shipped with the generic FreeBSD kernel and is available as a module. No need to install anything.
  • TODO: Add a reference to a manual page describing i915kms.
• modesetting(4) can be installed with xorg-server so you get it when you install xorg
• intel(4) can be installed with xf86-video-intel
• intel(4) has little to no advantage over the generic modesetting(4) driver. Unless you need extra control over your graphics hardware and rendering options, you don't need intel(4). In fact, as of 2018.04.15 the FreeBSD Graphics Wiki discourages the installation of intel(4) as most likely any bugs encountered in Xorg will be patched first in the modesetting(4) codebase.

nvidia-modeset:

debdrup, Freenode, #freebsd-wiki, 2018.05.11

• nvidia-modeset is supplied by the nvidia-driver, as a way of using the kernel modesetting option to change resolution, instead of doing it in userspace.
• What is this nvidia-modeset all about? (svnweb.freebsd.org/ports/head/UPDATING)

• Wiki of the project bringing the driver to FreeBSD (github.com/FreeBSDDesktop/freebsd-base-graphics)

• It can be used with both i915kms and drm-next-kmod.
• modesetting doesn't yet allow Option "TearFree" "True" in /usr/local/etc/X11/xorg.conf.d/98-tearfree.conf. (14.4.2018)

In order to solve this you can add the following to /usr/local/etc/X11/xorg.conf.d/20-amdgpu.conf (the file does not exist by default):

Section "Device"
    Identifier "AMD"
    Driver "amdgpu"
    Option "DRI" "3"
    Option "TearFree" "true"
EndSection

See Graphics/OptimusVideoSupport.

In this section assumes that:

• You are configuring Xorg manually via xorg.conf (which is not recommended).
• You are using the intel(4) driver (xf86-video-intel) instead of modesetting(4) (although modesetting(4) is the recommended driver you should probably use).

Comment out Nvidia-related parts from your xorg.conf:

...

Section "Device"
    Identifier  "Card0"
    Driver      "intel"
    BusID       "PCI:0:2:0"
EndSection

#Section "Device"
#   Identifier  "Card1"
#   Driver      "nvidia"
#   BusID       "PCI:1:0:0"
#EndSection

...

Then add the following bits to rc.conf(5):

kld_list='i915kms'

No! These days Xorg relies entirely on autoconfiguration. Most of the time it is unnecessary to configure anything manually. In fact, you should only configure Xorg manually if you know what you are doing. Copy-pasting random code from ancient tutorials is rarely a good idea.

Not really, no. It is no longer needed to put enable_hald="YES" into rc.conf(5).

• Are you running 12-CURRENT? If so then you should probably install your graphics drivers from ports. Things are changing really fast on the development branch hence the precompiled packages you install using pkg might be already outdated.

• Possibly fixed by switching to TTY0 (Ctrl+Alt+F1) and back to TTY8 (Alt+F8).
• Another way of fixing it is to include compton --daemon in .xinitrc. Compton is not a part of the base system so it has to be installed first.
• Alternatively fixed by setting hw.acpi.reset_video to 1. See sysctl.conf(5).

There is a dedicated wiki page: Graphics/Brightness.

As of 2018.04.03.

Xorg doesn't even put amdgpu into the autodetection list, it goes:

1. modesetting
2. scfb
3. vesa

regardless of whether amdgpu is installed or not.

Apparently, you get a modesetting DDX by default (even with xf86-video-amdgpu installed) on which for some reason radeonsi doesn't work and it falls back to LLVMpipe.

In order to solve this you can add the following to /usr/local/etc/X11/xorg.conf.d/20-amdgpu.conf (the file does not exist by default):

Section "Device"
    Identifier "AMD"
    Driver "amdgpu"
EndSection

Now you should get something along the following output when running glxinfo (from the graphics/mesa-demos port):

• glxinfo|grep "renderer string": OpenGL renderer string: AMD Radeon (TM) Pro WX 5100 Graphics (POLARIS10 / DRM 3.10.0 / 12.0-CURRENT, LLVM 5.0.1)
• glxinfo|grep "core profile version string" OpenGL core profile version string: 4.5 (Core Profile) Mesa 17.3.1

Now OpenGL should work.

What's tearing anyway?

See this test video.

In order to get transparency you'll need a compositor. It has to be installed manually unless your desktop environment comes with one.

Notable compositors:

• x11-wm/compton
  • It is used by the Lumina Desktop Environment.

• Make sure that you've got your drivers installed.

TODO

TODO

TODO

• Xorg error No devices detected (unix.stackexchange.com)

debdrup Freenode, #freebsd-wiki, 2018.05.11

This error message isn't very informative. It just means that you won't be able to access the X server via X11 Forwarding over SSH

If you ever need to create the file, all you need to do is touch ~/.Xauthority - at which point you can use xauth(1) to modify ~/.Xauthority.

Based on https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=228001.

First of all, you probably forgot to add dbus_enable=YES to rc.conf(5). You can do it using either an editor or by running

sysrc dbus_enable=YES

If it still does solve the issue then you've got to create the machine-id file by yourself. The the following command:

dbus-uuidgen --ensure

• freebsd-desktop@freebsd.org (lists.freebsd.org)
• freebsd-x11@freebsd.org (lists.freebsd.org)

• freenode:
  • #freebsd
• EFNet:
  • #freebsd-xorg

See Channels for a list of all the FreeBSD IRC channels.