wlroots/docs/env_vars.md

wlroots reads these environment variables

# wlroots specific

* *WLR_BACKENDS*: comma-separated list of backends to use (available backends:
  libinput, drm, wayland, x11, headless, noop)
* *WLR_NO_HARDWARE_CURSORS*: set to 1 to use software cursors instead of
  hardware cursors
* *WLR_XWAYLAND*: specifies the path to an Xwayland binary to be used (instead
  of following shell search semantics for "Xwayland")
* *WLR_RENDERER*: forces the creation of a specified renderer (available
  renderers: gles2, pixman, vulkan)

## DRM backend

* *WLR_DRM_DEVICES*: specifies the DRM devices (as a colon separated list)
  instead of auto probing them. The first existing device in this list is
  considered the primary DRM device.
* *WLR_DRM_NO_ATOMIC*: set to 1 to use legacy DRM interface instead of atomic
  mode setting
* *WLR_DRM_NO_MODIFIERS*: set to 1 to always allocate planes without modifiers,
  this can fix certain modeset failures because of bandwidth restrictions.

## Headless backend

* *WLR_HEADLESS_OUTPUTS*: when using the headless backend specifies the number
  of outputs

## libinput backend

* *WLR_LIBINPUT_NO_DEVICES*: set to 1 to not fail without any input devices

## Wayland backend

* *WLR_WL_OUTPUTS*: when using the wayland backend specifies the number of outputs

## X11 backend

* *WLR_X11_OUTPUTS*: when using the X11 backend specifies the number of outputs

## gles2 renderer

* *WLR_RENDERER_ALLOW_SOFTWARE*: allows the gles2 renderer to use software
  rendering

# Generic

* *DISPLAY*: if set probe X11 backend in `wlr_backend_autocreate`
* *WAYLAND_DISPLAY*, *WAYLAND_SOCKET*: if set probe Wayland backend in
  `wlr_backend_autocreate`
* *XCURSOR_PATH*: directory where xcursors are located
* *XDG_SESSION_ID*: if set, session ID used by the logind session
Document env vars used by wlroots 2018-05-03 12:30:48 +02:00			`wlroots reads these environment variables`

Add FreeRDP backend for remote desktop support 2019-02-22 13:58:52 -05:00			`# wlroots specific`

backend: allow multiple backends in WLR_BACKENDS 2018-05-15 22:10:51 +01:00			`* WLR_BACKENDS: comma-separated list of backends to use (available backends:`
Drop RDP backend Users interested in remote access to wlroots compositors should use wayvnc: https://github.com/any1/wayvnc 2020-01-10 11:33:21 -05:00			`libinput, drm, wayland, x11, headless, noop)`
output: introduce WLR_NO_HARDWARE_CURSORS 2018-09-14 18:07:21 +02:00			`* WLR_NO_HARDWARE_CURSORS: set to 1 to use software cursors instead of`
			`hardware cursors`
xwayland: introduce WLR_XWAYLAND for specifying which Xwayland to use When debugging Xwayland-related issues, a common first step in debugging has been to ask the reporter to move their real Xwayland to /usr/bin/Xwayland.bin, and create a shell script starting Xwayland with extra arguments under the original /usr/bin/Xwayland location. Introducing a `WLR_XWAYLAND` environment variable makes this less invasive, by allowing the user to swap out Xwayland without resorting to global system changes (or source patches). 2020-10-03 14:16:54 -04:00			`* WLR_XWAYLAND: specifies the path to an Xwayland binary to be used (instead`
			`of following shell search semantics for "Xwayland")`
render: introduce WLR_RENDERER in wlr_renderer_autocreate_with_drm_fd This env var forces the creation of a specific renderer. If no renderer is specified, the function will try to create all of the renderers one by one until one is created successfuly. 2021-04-20 14:48:52 -04:00			`* WLR_RENDERER: forces the creation of a specified renderer (available`
docs: mention WLR_RENDERER=vulkan. This option was added with commit 8e346922508aa3eaccd6e12f2917f6574f349843. 2021-11-18 23:06:13 -03:00			`renderers: gles2, pixman, vulkan)`
Document env vars used by wlroots 2018-05-03 12:30:48 +02:00
docs: establish one section per backend 2020-01-14 13:27:22 +01:00			`## DRM backend`

			`* WLR_DRM_DEVICES: specifies the DRM devices (as a colon separated list)`
			`instead of auto probing them. The first existing device in this list is`
			`considered the primary DRM device.`
			`* WLR_DRM_NO_ATOMIC: set to 1 to use legacy DRM interface instead of atomic`
			`mode setting`
backend/drm: add env variable to disable modifiers In some cases modesets fail if the planes are initialized with modifiers. Since in this case possibly all planes need to reinitialized, which is not possible in the current wlroots design, add an environment variable for affected users. 2020-01-24 19:31:39 +01:00			`* WLR_DRM_NO_MODIFIERS: set to 1 to always allocate planes without modifiers,`
			`this can fix certain modeset failures because of bandwidth restrictions.`
docs: establish one section per backend 2020-01-14 13:27:22 +01:00
			`## Headless backend`
Add FreeRDP backend for remote desktop support 2019-02-22 13:58:52 -05:00
			`* WLR_HEADLESS_OUTPUTS: when using the headless backend specifies the number`
			`of outputs`

docs: establish one section per backend 2020-01-14 13:27:22 +01:00			`## libinput backend`

			`* WLR_LIBINPUT_NO_DEVICES: set to 1 to not fail without any input devices`

			`## Wayland backend`
Add FreeRDP backend for remote desktop support 2019-02-22 13:58:52 -05:00
			`* WLR_WL_OUTPUTS: when using the wayland backend specifies the number of outputs`

docs: establish one section per backend 2020-01-14 13:27:22 +01:00			`## X11 backend`
Add FreeRDP backend for remote desktop support 2019-02-22 13:58:52 -05:00
			`* WLR_X11_OUTPUTS: when using the X11 backend specifies the number of outputs`

render/egl: fail to create wlr_egl on software renderer The creation of `wlr_egl` will fail is the device extension EGL_MESA_device_software is defined. The creation process is allowed to continue only if the environment variable `WLR_RENDERER_ALLOW_SOFTWARE` is defined to the value 1. 2021-01-26 21:13:28 -05:00			`## gles2 renderer`

			`* WLR_RENDERER_ALLOW_SOFTWARE: allows the gles2 renderer to use software`
			`rendering`

Add FreeRDP backend for remote desktop support 2019-02-22 13:58:52 -05:00			`# Generic`

docs/env_vars: document seatd session 2020-12-24 12:19:34 +01:00			* DISPLAY: if set probe X11 backend in `wlr_backend_autocreate`
docs/env_vars: _WAYLAND_DISPLAY isn't used anymore 2020-12-24 12:17:31 +01:00			`* WAYLAND_DISPLAY, WAYLAND_SOCKET: if set probe Wayland backend in`
			`wlr_backend_autocreate`
Document env vars used by wlroots 2018-05-03 12:30:48 +02:00			`* XCURSOR_PATH: directory where xcursors are located`
docs: document XDG_SESSION_ID 2020-01-14 13:34:51 +01:00			`* XDG_SESSION_ID: if set, session ID used by the logind session`