Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Fix typo and style issues in lmp-customization #712

Merged
merged 1 commit into from
Jun 12, 2024
+34 −34
Merged

Fix typo and style issues in lmp-customization #712

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
68 changes: 34 additions & 34 deletions source/user-guide/lmp-customization/lmp-customization.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,59 +1,58 @@
.. _lmp-customization:

LmP Customization
======================
=================

This page covers common ways that the Linux® microPlatform (LmP) can be modified.
This includes kernel options, startup services, user and group configuration,
and other options related to the platform build.
This page covers common ways to modify the Linux® microPlatform (LmP).
This includes kernel options, startup services, user and group configuration, and other options related to the platform build.

.. seealso::

The tutorial for :ref:`tutorial-customizing-the-platform` covers adding a custom recipe service.
This helps introduces core concepts and steps related to customizing LmP, and is a good place to start.
This is a good place to start, as it introduces concepts and steps related to customizing LmP.

.. _ref-customizing-the-distro:

Customizing the Distro
-----------------------

This section shows how to build new targets with other Distro. Following an example on
how to build a new targets with :ref:`LmP XWayland <ref-lmp-wayland-xwayland>`.
This section shows how to build new Targets with a different distro.
The following is an example on how to build a new Target with :ref:`LmP XWayland <ref-lmp-wayland-xwayland>`.

1. Update your factory config:

.. code-block:: shell
.. code-block:: shell

git clone https://source.foundries.io/factories/<factory>/ci-scripts.git
cd ci-scripts
vi factory-config.yml
git clone https://source.foundries.io/factories/<factory>/ci-scripts.git
cd ci-scripts
vi factory-config.yml

2. Add the distro under ``LmP``:

.. code-block:: yaml
.. code-block:: yaml

worker_tag: "amd64-partner-aws"
params:
IMAGE: lmp-factory-image
SSTATE_CACHE_MIRROR: ""
DOCKER_COMPOSE_APP: "1"
DISTRO: "lmp-xwayland"
worker_tag: "amd64-partner-aws"
params:
IMAGE: lmp-factory-image

Check warning on line 36 in source/user-guide/lmp-customization/lmp-customization.rst

View workflow job for this annotation

GitHub Actions / runner / vale 

[vale] reported by reviewdog 🐶
[Fio-docs.Branding-and-names] Use 'LmP' instead of 'lmp'

Raw Output:
{"message": "[Fio-docs.Branding-and-names] Use 'LmP' instead of 'lmp'", "location": {"path": "source/user-guide/lmp-customization/lmp-customization.rst", "range": {"start": {"line": 36, "column": 18}}}, "severity": "INFO"}
DOCKER_COMPOSE_APP: "1"
DISTRO: "lmp-xwayland"

3. Commit and push the changes:

.. code-block:: shell
.. code-block:: shell

git add .
git commit -m "Adding lmp-xwayland as base for my factory"
git push
git add .
git commit -m "Adding lmp-xwayland as base for my factory"
git push

4. Changes into the ``ci-script`` repository don't auto-trigger builds. Push a commit in ``lmp-manifest`` or ``meta-subscriber-overrides``:
4. Changes to the ``ci-script`` repository do not auto-trigger builds.
To do so, push a commit in ``lmp-manifest`` or ``meta-subscriber-overrides``:

.. code-block:: shell
.. code-block:: shell

git clone https://source.foundries.io/factories/<factory>/lmp-manifest.git
cd lmp-manifest
git commit -m "trigger build" --allow-empty
git clone https://source.foundries.io/factories/<factory>/lmp-manifest.git
cd lmp-manifest
git commit -m "trigger build" --allow-empty

Kernel Command Line Arguments
-----------------------------
Expand All @@ -63,8 +62,8 @@

See the :ref:`ref-linux-distro` page for an overview of the two options.

Distro: lmp
^^^^^^^^^^^
Distro: ``lmp``
^^^^^^^^^^^^^^^

Extend the kernel command line by setting ``OSTREE_KERNEL_ARGS`` in ``meta-subscriber-overrides/conf/machine/include/lmp-factory-custom.inc``::

Expand All @@ -73,12 +72,13 @@
Make sure you set the correct ``<machine>`` and other variables as needed.

.. note::

The default is ``OSTREE_KERNEL_ARGS_COMMON ?= "root=LABEL=otaroot rootfstype=ext4"``.
This variable is responsible for setting a valid ``root`` label for the device.
This variable sets a valid ``root`` label for the device.
It is not necessary on devices specifying the partition path directly with ``root=``.

Distro: lmp-base
^^^^^^^^^^^^^^^^
Distro: ``lmp-base``
^^^^^^^^^^^^^^^^^^^^

Extend the kernel command line by appending your commands to ``bootcmd_args`` in ``meta-subscriber-overrides/recipes-bsp/u-boot/u-boot-base-scr/<machine>/uEnv.txt.in``.
For example::
Expand Down Expand Up @@ -380,8 +380,8 @@

DEF_FALLBACK_NTP_SERVERS += " <new-server>"

Installing Files Under var
--------------------------
Installing Files Under ``var``
------------------------------

Anything created under ``/var`` gets removed when creating the OSTree deployment. For this reason, a recipe can only install content under it using `tmpfiles`_.

Expand Down
Loading