Wayland: Difference between revisions

From Alpine Linux
m (minor grammar)
(Mention pam_rundir and reword things a bit)
Line 7: Line 7:
== XDG_RUNTIME_DIR ==
== XDG_RUNTIME_DIR ==


As per the protocol spec, Wayland compositors require the XDG_RUNTIME_DIR variable to be set. A login manager such as [[Elogind]] can configure this and other Freedesktop.org environment variables automatically.
As per the protocol spec, Wayland compositors require the <code>XDG_RUNTIME_DIR</code> variable to be set. There are a few ways to configure this variable:


Generally it's inadvisable to configure <code>XDG_*</code> variables manually as this configuration may have errors or conflict with other utilities that do this automatically.
* A login manager such as [[Elogind]] can configure this and other XDG environment variables automatically.
* [https://github.com/jjk-jacky/pam%20rundir pam_rundir] can enable this for logins.
* Setting it up manually


That said, on a system that's not using elogind/pam, it's often necessary to set up <code>XDG_RUNTIME_DIR</code> manually. This can be done by adding a snippet like this one to shell init scripts (e.g.: <code>~/.profile</code>):
=== Configuring XDG_RUNTIME_DIR manually ===
 
Generally, care should be taken when configuring the <code>XDG_*</code> variables manually as this configuration may have errors or conflict with other utilities that do this automatically.
 
On a system that's not using elogind nor any pam module that handles this, it's often necessary to set up <code>XDG_RUNTIME_DIR</code> manually. This can be done by adding a snippet like this one to shell init scripts (e.g.: <code>~/.profile</code>):


<pre>
<pre>

Revision as of 12:46, 28 January 2023

This material needs expanding ...

A more thorough guide to installing, configuring, and running wayland on Alpine would be better.


Wayland is a new display protocol that aims to replace X11.


XDG_RUNTIME_DIR

As per the protocol spec, Wayland compositors require the XDG_RUNTIME_DIR variable to be set. There are a few ways to configure this variable:

  • A login manager such as Elogind can configure this and other XDG environment variables automatically.
  • pam_rundir can enable this for logins.
  • Setting it up manually

Configuring XDG_RUNTIME_DIR manually

Generally, care should be taken when configuring the XDG_* variables manually as this configuration may have errors or conflict with other utilities that do this automatically.

On a system that's not using elogind nor any pam module that handles this, it's often necessary to set up XDG_RUNTIME_DIR manually. This can be done by adding a snippet like this one to shell init scripts (e.g.: ~/.profile):

if test -z "${XDG_RUNTIME_DIR}"; then
  export XDG_RUNTIME_DIR=/tmp/$(id -u)-runtime-dir
  if ! test -d "${XDG_RUNTIME_DIR}"; then
    mkdir "${XDG_RUNTIME_DIR}"
    chmod 0700 "${XDG_RUNTIME_DIR}"
  fi
fi

See also