Appendix L. Wayland Known Issues
Prev | Part II. Appendices |

## Appendix L. Wayland Known Issues

### Overview

There are several areas in which the NVIDIA driver lacks feature parity between X11 and Wayland. These may be due to limitations of the driver itself, the Wayland protocol, or the specific Wayland compositor in use. Over time this list is expected to shorten as missing functionality is implemented both in the driver and in upstream components, but the following captures the situation as of the release of this driver version. Note that this assumes a compositor with reasonably complete support for graphics-related Wayland protocol extensions.

### NVIDIA Driver Limitations

- The VDPAU library (Appendix G, VDPAU Support), used for hardware accelerated video decoding and presentation, does not have native Wayland support and does not work with Xwayland.

- The NvFBC desktop capture library does not have native Wayland support and does not work with Xwayland.

- Variable display refresh rate capabilities such as G-Sync are supported on Volta or newer GPUs with Wayland. Older GPUs are not supported.

- Virtual reality displays, such as the SteamVR platform, require support for DRM display leasing which does not currently work.

- EGL_EXT_platform_x11 is not supported with Xwayland.

- The nvidia-drm module does not support the GAMMA_LUT, DEGAMMA_LUT, CTM, COLOR_ENCODING, or COLOR_RANGE connector properties, which may impact some compositor features related to color correction.

- The nvidia-settings configuration tool has limited functionality on Wayland.

- Front-buffer rendering in GLX does not work with Xwayland.

- GLX direct contexts are invalidated after fork in the child process with Xwayland.

### Wayland Protocol or Compositor Limitations

- The following workstation features are not supported by any Wayland compositors or the Wayland protocol. They will also likely require new EGL extensions or other means to expose the related hardware functionality.

  - SLI and Multi-GPU Mosaic (Chapter 31, Configuring SLI and Multi-GPU Mosaic)

  - Frame Lock and Genlock (Chapter 32, Configuring Frame Lock and Genlock)

  - Swap Groups

  - Advanced display pipeline features including warp and blend, pixel shift, and emulated YUV420.

  - Stereo rendering

- There is no established public API through which Wayland compositors can power off video memory via RTD3 (Chapter 22, PCI-Express Runtime D3 (RTD3) Power Management).

- Xwayland does not provide a suitable mechanism for our driver to synchronize application rendering with presentation, which can cause visual corruption in some circumstances.

- Display multiplexers (muxes) are typically used in laptops with both integrated and discrete GPUs to provide a direct connection between the discrete GPU and the built-in display (internal mux) or an external display (external mux). On X11, the display mux can be automatically switched when a full-screen application is running on the discrete GPU, enabling enhanced display features and improved performance, but no Wayland compositors currently support this functionality.

- Indirect GLX does not work with Xwayland because the Glamor rendering engine is not compatible with our EGL implementation.

- Hardware overlays cannot be used by GLX applications with Xwayland.

Prev | Up |
Appendix K. GPU Names | Home |