From 1fa6a9bbb760a685010746d8886a0ee0ea464c11 Mon Sep 17 00:00:00 2001 From: Michael Opdenacker Date: Wed, 15 Jun 2022 20:19:38 +0200 Subject: [PATCH] ref-manual: document SYSTEMD_DEFAULT_TARGET [YOCTO #14660] (From yocto-docs rev: d5bcdf9a8b357b96656b62c41834410e662d8546) Signed-off-by: Michael Opdenacker Reported-by: Robert P. J. Day Signed-off-by: Richard Purdie --- documentation/ref-manual/variables.rst | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst index 3a334f4282..28267101d8 100644 --- a/documentation/ref-manual/variables.rst +++ b/documentation/ref-manual/variables.rst @@ -7666,6 +7666,24 @@ system and gives an overview of their function and contents. For information on Systemd-boot, see the `Systemd-boot documentation `__. + :term:`SYSTEMD_DEFAULT_TARGET` + + This variable allows to set the default unit that systemd starts at bootup. + Usually, this is either ``multi-user.target`` or ``graphical.target``. + This works by creating a ``default.target`` symbolic link to the chosen systemd + target file. + + See `systemd's documentation + `__ + for details. + + For example, this variable is used in the + `core-image-minimal-xfce.bb + `__ + recipe:: + + SYSTEMD_DEFAULT_TARGET = "graphical.target" + :term:`SYSTEMD_PACKAGES` When inheriting the :ref:`systemd ` class, this variable locates the systemd unit files when they are not found