poky: subtree update:0ac99625bf..796be0593a
Alexander Kanavin (31):
netbase: upgrade 6.1 -> 6.2
meson: upgrade 0.55.1 -> 0.56.0
vulkan-samples: update to latest revision
libcap: update 2.44 -> 2.45
bind: upgrade 9.16.7 -> 9.16.9
quota: upgrade 4.05 -> 4.06
pango: upgrade 1.46.2 -> 1.48.0
elfutils: upgrade 0.181 -> 0.182
ifupdown: upgrade 0.8.35 -> 0.8.36
createrepo-c: upgrade 0.16.1 -> 0.16.2
acpica: upgrade 20200925 -> 20201113
grep: upgrade 3.5 -> 3.6
man-pages: upgrade 5.08 -> 5.09
stress-ng: upgrade 0.11.23 -> 0.11.24
libhandy: upgrade 1.0.1 -> 1.0.2
piglit: upgrade to latest revision
xkbcomp: upgrade 1.4.3 -> 1.4.4
lz4: upgrade 1.9.2 -> 1.9.3
bison: upgrade 3.7.3 -> 3.7.4
python3-setuptools-scm: fix upstream version check
cantarell-fonts: update 0.0.25 -> 0.201
meta/lib/oe/reproducible.py: gitsm:// works just as fine as git:// for timestamps
llvm: fix reproducibility
ruby: fix reproducibility
webkitgtk: fix reproducibility
ffmpeg: fix reproducibility
piglit: fix reproducibility
serf: do not install the static library
llvm: sort the lists in generated source reproducibibly
kea: fix reproducibility
poky.conf: do not write current date into distro version, use git hash instead
Andrej Valek (1):
kernel-dummy: fix executing unexpected tasks
Anuj Mittal (1):
releases.rst: add gatesgarth to current releases
Brett Warren (1):
libffi: add patch to revert clang VFP workaround
Chandana kalluri (1):
populate_sdk_ext: use SDK_CUSTOM_TEPLATECONF variable to enable custom templateconf.cfg
Changqing Li (1):
buildtools-tarball: add wic dependency into extended buildtools
Diego Sueiro (2):
modutils-initscripts: Fix modules.dep creation when USE_DEPMOD="0"
initscripts: Change execution order between checkroot and modutils
Dmitry Baryshkov (2):
linux-firmware: upgrade 20201022 -> 20201118
linux-firmware: package ath11k firmware
Fabio Berton (1):
mesa: Update 20.2.1 -> 20.2.4
Gratian Crisan (1):
kernel-module-split.bbclass: fix kernel modules getting marked as CONFFILES
Jack Mitchell (3):
Revert "connman: set service to conflict with systemd-networkd"
systemd-conf: add PACKAGECONFIG to enable/disable auto ethernet DHCP
systemd-conf: match ethernet interfaces by type rather than globbing
Joshua Watt (2):
bitbake: hashserv: client: Fix AF_UNIX path length limits
bitbake: hashserv: Fix broken AF_UNIX path length limit
Kai Kang (2):
systemd-systemctl-native: capable to call without argument
systemd.bbclass: update command to check systemctl available
Kevin Hao (1):
tune-octeontx2.inc: Add tune for Marvell OCTEON TX2 core
Li Wang (2):
qemu: CVE-2020-29129 CVE-2020-29130
qemu: CVE-2020-25624
Luca Boccassi (1):
dbus: move messagebus user to dbus-common package
Michael Halstead (1):
releases: conf: add link to 3.1.4, update to include 3.1.4
Nicolas Dechesne (19):
sphinx: add .vscode in .gitignore
{dev,kernel,sdk}-manual: replace hardcoded release version with &DISTRO;
sphinx: replace bitbake labels with references to corresponding title
brief-yoctoprojectqs: replace labels with references to section title
dev-manual: replace labels with references to section title
ref-manual: replace labels with references to section title
sdk-manual: replace labels with references to section title
overview-manual: remove unused labels
dev-manual: remove unused labels
sphinx: rename top level document in each manual
sphinx: use absolute paths for :doc: references
test-manual: remove 'test-manual' from filenames
toaster-manual: remove 'toaster-manual' from filenames
dev-manual: remove 'dev-manual' from filenames
kernel-dev: remove 'kernel-dev' from filenames
profile-manual: remove 'profile-manual' from filenames
overview-manual: remove 'overview-manual' from filenames
sdk-manual: remove 'sdk' from filenames
ref-manual: remove 'ref' from filenames
Paul Barker (5):
documentation: Simplify yocto_wiki links
documentation: Simplify yocto_git links
ref-manual: Simplify oe_git links
poky.conf: Add opensuseleap-15.2 and fedora-33 to tested distros
poky.conf: Drop fedora-30 from tested distros
Peter Kjellerstedt (2):
pseudo: Simplify pseudo_client_ignore_path_chroot()
bitbake.conf: Add all layers (from BBLAYERS) to PSEUDO_IGNORE_PATHS
Richard Purdie (8):
lz4: Use the new branch naming from upstream
Revert "bitbake.conf: Add all layers (from BBLAYERS) to PSEUDO_IGNORE_PATHS"
build-appliance-image: Update to master head revision
bitbake: Revert "fetch2: use relative symlinks for anything pulled from PREMIRRORS"
build-appliance-image: Update to master head revision
metadata_scm: Fix signature handling of METADATA_REVISION and METADATA_BRANCH
poky: Set SDK_VERSION explicitly
build-appliance-image: Update to master head revision
Ross Burton (9):
oeqa/devtool: use Yocto mirror for pv-1.5.3 tarball
image_types: remove obsolete tar comment
image_types: sort tarball file listings
package_manager/ipk: neaten OPKGLIBDIR logic
ldconfig-native: don't write auxiliary cache
package_manager/ipk: improve remove_packaging_data
oeqa/selftest/containerimage: update for improved cleanup
coreutils: add SUSE-specific issues to CVE whitelist
bitbake: msg: use safe YAML loader
Sinan Kaya (1):
poky-tiny: enable section removal
Tomasz Dziendzielski (1):
pseudo: Update to print PSEUDO_LOGFILE in abort message on path mismatches
sangeeta jain (1):
meta/lib/oeqa/manual/oe-core.json: Update test_bitbake_devshell
zangrc (3):
libinput: upgrade 1.16.3 -> 1.16.4
lighttpd: upgrade 1.4.55 -> 1.4.56
sysstat: upgrade 12.4.0 -> 12.4.1
Signed-off-by: Andrew Geissler <geissonator@yahoo.com>
Change-Id: I65f2f1c9d44433f3e62609240012c42256679b51
diff --git a/poky/documentation/ref-manual/kickstart.rst b/poky/documentation/ref-manual/kickstart.rst
new file mode 100644
index 0000000..bb9c046
--- /dev/null
+++ b/poky/documentation/ref-manual/kickstart.rst
@@ -0,0 +1,216 @@
+.. SPDX-License-Identifier: CC-BY-SA-2.0-UK
+
+*******************************************
+OpenEmbedded Kickstart (``.wks``) Reference
+*******************************************
+
+.. _openembedded-kickstart-wks-reference:
+
+Introduction
+============
+
+The current Wic implementation supports only the basic kickstart
+partitioning commands: ``partition`` (or ``part`` for short) and
+``bootloader``.
+
+.. note::
+
+ Future updates will implement more commands and options. If you use
+ anything that is not specifically supported, results can be
+ unpredictable.
+
+This chapter provides a reference on the available kickstart commands.
+The information lists the commands, their syntax, and meanings.
+Kickstart commands are based on the Fedora kickstart versions but with
+modifications to reflect Wic capabilities. You can see the original
+documentation for those commands at the following link:
+http://pykickstart.readthedocs.io/en/latest/kickstart-docs.html
+
+Command: part or partition
+==========================
+
+Either of these commands creates a partition on the system and uses the
+following syntax:
+::
+
+ part [mntpoint]
+ partition [mntpoint]
+
+If you do not
+provide mntpoint, Wic creates a partition but does not mount it.
+
+The ``mntpoint`` is where the partition is mounted and must be in one of
+the following forms:
+
+- ``/path``: For example, "/", "/usr", or "/home"
+
+- ``swap``: The created partition is used as swap space
+
+Specifying a mntpoint causes the partition to automatically be mounted.
+Wic achieves this by adding entries to the filesystem table (fstab)
+during image generation. In order for Wic to generate a valid fstab, you
+must also provide one of the ``--ondrive``, ``--ondisk``, or
+``--use-uuid`` partition options as part of the command.
+
+.. note::
+
+ The mount program must understand the PARTUUID syntax you use with
+ ``--use-uuid`` and non-root *mountpoint*, including swap. The busybox
+ versions of these application are currently excluded.
+
+Here is an example that uses "/" as the mountpoint. The command uses
+``--ondisk`` to force the partition onto the ``sdb`` disk:
+::
+
+ part / --source rootfs --ondisk sdb --fstype=ext3 --label platform --align 1024
+
+Here is a list that describes other supported options you can use with
+the ``part`` and ``partition`` commands:
+
+- ``--size``: The minimum partition size in MBytes. Specify an
+ integer value such as 500. Do not append the number with "MB". You do
+ not need this option if you use ``--source``.
+
+- ``--fixed-size``: The exact partition size in MBytes. You cannot
+ specify with ``--size``. An error occurs when assembling the disk
+ image if the partition data is larger than ``--fixed-size``.
+
+- ``--source``: This option is a Wic-specific option that names the
+ source of the data that populates the partition. The most common
+ value for this option is "rootfs", but you can use any value that
+ maps to a valid source plugin. For information on the source plugins,
+ see the ":ref:`dev-manual/common-tasks:using the wic plugin interface`"
+ section in the Yocto Project Development Tasks Manual.
+
+ If you use ``--source rootfs``, Wic creates a partition as large as
+ needed and fills it with the contents of the root filesystem pointed
+ to by the ``-r`` command-line option or the equivalent rootfs derived
+ from the ``-e`` command-line option. The filesystem type used to
+ create the partition is driven by the value of the ``--fstype``
+ option specified for the partition. See the entry on ``--fstype``
+ that follows for more information.
+
+ If you use ``--source plugin-name``, Wic creates a partition as large
+ as needed and fills it with the contents of the partition that is
+ generated by the specified plugin name using the data pointed to by
+ the ``-r`` command-line option or the equivalent rootfs derived from
+ the ``-e`` command-line option. Exactly what those contents are and
+ filesystem type used are dependent on the given plugin
+ implementation.
+
+ If you do not use the ``--source`` option, the ``wic`` command
+ creates an empty partition. Consequently, you must use the ``--size``
+ option to specify the size of the empty partition.
+
+- ``--ondisk`` or ``--ondrive``: Forces the partition to be created
+ on a particular disk.
+
+- ``--fstype``: Sets the file system type for the partition. Valid
+ values are:
+
+ - ``ext4``
+
+ - ``ext3``
+
+ - ``ext2``
+
+ - ``btrfs``
+
+ - ``squashfs``
+
+ - ``swap``
+
+- ``--fsoptions``: Specifies a free-form string of options to be used
+ when mounting the filesystem. This string is copied into the
+ ``/etc/fstab`` file of the installed system and should be enclosed in
+ quotes. If not specified, the default string is "defaults".
+
+- ``--label label``: Specifies the label to give to the filesystem to
+ be made on the partition. If the given label is already in use by
+ another filesystem, a new label is created for the partition.
+
+- ``--active``: Marks the partition as active.
+
+- ``--align (in KBytes)``: This option is a Wic-specific option that
+ says to start partitions on boundaries given x KBytes.
+
+- ``--offset (in KBytes)``: This option is a Wic-specific option that
+ says to place a partition at exactly the specified offset. If the
+ partition cannot be placed at the specified offset, the image build
+ will fail.
+
+- ``--no-table``: This option is a Wic-specific option. Using the
+ option reserves space for the partition and causes it to become
+ populated. However, the partition is not added to the partition
+ table.
+
+- ``--exclude-path``: This option is a Wic-specific option that
+ excludes the given relative path from the resulting image. This
+ option is only effective with the rootfs source plugin.
+
+- ``--extra-space``: This option is a Wic-specific option that adds
+ extra space after the space filled by the content of the partition.
+ The final size can exceed the size specified by the ``--size``
+ option. The default value is 10 Mbytes.
+
+- ``--overhead-factor``: This option is a Wic-specific option that
+ multiplies the size of the partition by the option's value. You must
+ supply a value greater than or equal to "1". The default value is
+ "1.3".
+
+- ``--part-name``: This option is a Wic-specific option that
+ specifies a name for GPT partitions.
+
+- ``--part-type``: This option is a Wic-specific option that
+ specifies the partition type globally unique identifier (GUID) for
+ GPT partitions. You can find the list of partition type GUIDs at
+ http://en.wikipedia.org/wiki/GUID_Partition_Table#Partition_type_GUIDs.
+
+- ``--use-uuid``: This option is a Wic-specific option that causes
+ Wic to generate a random GUID for the partition. The generated
+ identifier is used in the bootloader configuration to specify the
+ root partition.
+
+- ``--uuid``: This option is a Wic-specific option that specifies the
+ partition UUID.
+
+- ``--fsuuid``: This option is a Wic-specific option that specifies
+ the filesystem UUID. You can generate or modify
+ :term:`WKS_FILE` with this option if a preconfigured
+ filesystem UUID is added to the kernel command line in the bootloader
+ configuration before you run Wic.
+
+- ``--system-id``: This option is a Wic-specific option that
+ specifies the partition system ID, which is a one byte long,
+ hexadecimal parameter with or without the 0x prefix.
+
+- ``--mkfs-extraopts``: This option specifies additional options to
+ pass to the ``mkfs`` utility. Some default options for certain
+ filesystems do not take effect. See Wic's help on kickstart (i.e.
+ ``wic help kickstart``).
+
+Command: bootloader
+===================
+
+This command specifies how the bootloader should be configured and
+supports the following options:
+
+.. note::
+
+ Bootloader functionality and boot partitions are implemented by the
+ various
+ --source
+ plugins that implement bootloader functionality. The bootloader
+ command essentially provides a means of modifying bootloader
+ configuration.
+
+- ``--timeout``: Specifies the number of seconds before the
+ bootloader times out and boots the default option.
+
+- ``--append``: Specifies kernel parameters. These parameters will be
+ added to the syslinux ``APPEND`` or ``grub`` kernel command line.
+
+- ``--configfile``: Specifies a user-defined configuration file for
+ the bootloader. You can provide a full pathname for the file or a
+ file that exists in the ``canned-wks`` folder. This option overrides
+ all other bootloader options.