* [master][zeus][PATCH 1/5] ref-manual: The sanity_info file has moved from build/conf to build/cache
@ 2020-02-10 14:51 Peter Kjellerstedt
2020-02-10 14:51 ` [master][zeus][PATCH 2/5] ref-manual: Add missing/remove extraneous quotes Peter Kjellerstedt
` (3 more replies)
0 siblings, 4 replies; 5+ messages in thread
From: Peter Kjellerstedt @ 2020-02-10 14:51 UTC (permalink / raw
To: docs
Signed-off-by: Peter Kjellerstedt <peter.kjellerstedt@axis.com>
---
documentation/ref-manual/ref-structure.xml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/documentation/ref-manual/ref-structure.xml b/documentation/ref-manual/ref-structure.xml
index 8e0c9f5b62..937a4322fd 100644
--- a/documentation/ref-manual/ref-structure.xml
+++ b/documentation/ref-manual/ref-structure.xml
@@ -424,7 +424,7 @@
</section>
<section id='structure-build-conf-sanity_info'>
- <title><filename>build/conf/sanity_info</filename></title>
+ <title><filename>build/cache/sanity_info</filename></title>
<para>
This file indicates the state of the sanity checks and is created
--
2.21.1
^ permalink raw reply related [flat|nested] 5+ messages in thread
* [master][zeus][PATCH 2/5] ref-manual: Add missing/remove extraneous quotes
2020-02-10 14:51 [master][zeus][PATCH 1/5] ref-manual: The sanity_info file has moved from build/conf to build/cache Peter Kjellerstedt
@ 2020-02-10 14:51 ` Peter Kjellerstedt
2020-02-10 14:51 ` [master][zeus][PATCH 3/5] ref-manual: Update the documentation for USERADD_ERROR_DYNAMIC Peter Kjellerstedt
` (2 subsequent siblings)
3 siblings, 0 replies; 5+ messages in thread
From: Peter Kjellerstedt @ 2020-02-10 14:51 UTC (permalink / raw
To: docs
Signed-off-by: Peter Kjellerstedt <peter.kjellerstedt@axis.com>
---
documentation/ref-manual/migration.xml | 4 ++--
documentation/ref-manual/ref-variables.xml | 20 +++++++++-----------
2 files changed, 11 insertions(+), 13 deletions(-)
diff --git a/documentation/ref-manual/migration.xml b/documentation/ref-manual/migration.xml
index 8d50ab9133..2052188b6b 100644
--- a/documentation/ref-manual/migration.xml
+++ b/documentation/ref-manual/migration.xml
@@ -2110,7 +2110,7 @@
such as the following:
<literallayout class='monospaced'>
inherit bluetooth
- PACKAGECONFIG ??= "${@bb.utils.contains('DISTRO_FEATURES', 'bluetooth', '${BLUEZ}', '', d)}
+ PACKAGECONFIG ??= "${@bb.utils.contains('DISTRO_FEATURES', 'bluetooth', '${BLUEZ}', '', d)}"
PACKAGECONFIG[bluez4] = "--enable-bluetooth,--disable-bluetooth,bluez4"
PACKAGECONFIG[bluez5] = "--enable-bluez5,--disable-bluez5,bluez5"
</literallayout>
@@ -3624,7 +3624,7 @@ $ runqemu qemux86-64 tmp/deploy/images/qemux86-64/core-image-minimal-qemux86-64.
image types, this part of the kernel image base name as been
removed leaving only the following:
<literallayout class='monospaced'>
- KERNEL_IMAGE_BASE_NAME ?= "${PKGE}-${PKGV}-${PKGR}-${MACHINE}-${DATETIME}
+ KERNEL_IMAGE_BASE_NAME ?= "${PKGE}-${PKGV}-${PKGR}-${MACHINE}-${DATETIME}"
</literallayout>
If you have recipes or classes that use
<filename>KERNEL_IMAGE_BASE_NAME</filename> directly, you might
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 02abc590cd..e6009926be 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -367,7 +367,7 @@
<glossentry id='var-ASSUME_SHLIBS'><glossterm>ASSUME_SHLIBS</glossterm>
<info>
- ASSUME_SHLIBS[doc] = Provides additional shlibs provider mapping information, which adds to or overwrites the information provided automatically by the system."
+ ASSUME_SHLIBS[doc] = "Provides additional shlibs provider mapping information, which adds to or overwrites the information provided automatically by the system."
</info>
<glossdef>
<para role="glossdeffirst">
@@ -1423,7 +1423,7 @@
Use the following format to export the variable to the
BitBake environment:
<literallayout class='monospaced'>
- export BBSERVER=localhost:$port"
+ export BBSERVER=localhost:$port
</literallayout>
</para>
@@ -3786,7 +3786,7 @@
It is not intended to be user-configurable.
It is best to just reference the variable to see which distro features are
being backfilled for all distro configurations.
- See the <link linkend='ref-features-backfill'>Feature Backfilling</link> section for
+ See the "<link linkend='ref-features-backfill'>Feature Backfilling</link>" section for
more information.
</para>
</glossdef>
@@ -11054,7 +11054,7 @@
<glossentry id='var-PN'><glossterm>PN</glossterm>
<info>
- PN[doc] = "PN refers to a recipe name in the context of a file used by the OpenEmbedded build system as input to create a package.
+ PN[doc] = "PN refers to a recipe name in the context of a file used by the OpenEmbedded build system as input to create a package."
</info>
<glossdef>
<para role="glossdeffirst">
@@ -13383,8 +13383,7 @@
<glossentry id='var-SKIP_FILEDEPS'><glossterm>SKIP_FILEDEPS</glossterm>
<info>
- SKIP_FILEDEPS[doc] = "Enables you to remove all files from
- the "Provides" section of an RPM package."
+ SKIP_FILEDEPS[doc] = "Enables you to remove all files from the 'Provides' section of an RPM package."
</info>
<glossdef>
<para role="glossdeffirst">
@@ -15331,7 +15330,7 @@
<glossentry id='var-TCLIBC'><glossterm>TCLIBC</glossterm>
<info>
- TCLIBC[doc] = "Specifies GNU standard C library (libc) variant to use during the build process. You can select 'glibc', 'musl' or "newlib."
+ TCLIBC[doc] = "Specifies GNU standard C library (libc) variant to use during the build process. You can select 'glibc', 'musl' or 'newlib'."
</info>
<glossdef>
<para role="glossdeffirst">
@@ -16473,7 +16472,7 @@
Appends a string to the name of the local version of the
U-Boot image.
For example, assuming the version of the U-Boot image
- built was "2013.10, the full version string reported by
+ built was "2013.10", the full version string reported by
U-Boot would be "2013.10-yocto" given the following
statement:
<literallayout class='monospaced'>
@@ -17108,7 +17107,7 @@
"<ulink url='&YOCTO_DOCS_DEV_URL;#creating-partitioned-images-using-wic'>Creating Partitioned Images Using Wic</ulink>"
section in the Yocto Project Development Tasks Manual.
For details on the kickstart file format, see the
- "<link linkend='ref-kickstart'>OpenEmbedded Kickstart (<filename>.wks</filename>) Reference</link>
+ "<link linkend='ref-kickstart'>OpenEmbedded Kickstart (<filename>.wks</filename>) Reference</link>"
Chapter.
</para>
</glossdef>
@@ -17178,8 +17177,7 @@
<glossentry id='var-XSERVER'><glossterm>XSERVER</glossterm>
<info>
- XSERVER[doc] = "Specifies the packages that should be installed
- to provide an X server and drivers for the current machine."
+ XSERVER[doc] = "Specifies the packages that should be installed to provide an X server and drivers for the current machine."
</info>
<glossdef>
<para role="glossdeffirst">
--
2.21.1
^ permalink raw reply related [flat|nested] 5+ messages in thread
* [master][zeus][PATCH 3/5] ref-manual: Update the documentation for USERADD_ERROR_DYNAMIC
2020-02-10 14:51 [master][zeus][PATCH 1/5] ref-manual: The sanity_info file has moved from build/conf to build/cache Peter Kjellerstedt
2020-02-10 14:51 ` [master][zeus][PATCH 2/5] ref-manual: Add missing/remove extraneous quotes Peter Kjellerstedt
@ 2020-02-10 14:51 ` Peter Kjellerstedt
2020-02-10 14:51 ` [master][zeus][PATCH 4/5] ref-manual: Add a variable description for AVAILABLE_LICENSES Peter Kjellerstedt
2020-02-10 14:51 ` [master][zeus][PATCH 5/5] ref-manual: Add a tips on how to achieve whitelisting of licenses Peter Kjellerstedt
3 siblings, 0 replies; 5+ messages in thread
From: Peter Kjellerstedt @ 2020-02-10 14:51 UTC (permalink / raw
To: docs
* Update USERADD_ERROR_DYNAMIC[doc] and the first paragraph to match
the definition in meta/conf/documentation.conf.
* Add a note explaining the differences in behavior when setting
USERADD_ERROR_DYNAMIC to "warn" and "error" respectively.
[YOCTO #12932]
Signed-off-by: Peter Kjellerstedt <peter.kjellerstedt@axis.com>
---
documentation/ref-manual/ref-variables.xml | 33 ++++++++++++++++------
1 file changed, 25 insertions(+), 8 deletions(-)
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index e6009926be..c8ece0c579 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -16770,18 +16770,21 @@
<glossentry id='var-USERADD_ERROR_DYNAMIC'><glossterm>USERADD_ERROR_DYNAMIC</glossterm>
<info>
- USERADD_ERROR_DYNAMIC[doc] = "If set to 'error', forces the OpenEmbedded build system to produce an error if the user identification (uid) and group identification (gid) values are not defined in files/passwd and files/group files. If set to 'warn', a warning will be issued instead."
+ USERADD_ERROR_DYNAMIC[doc] = "If set to 'error', forces the OpenEmbedded build system to produce an error if the user identification (uid) and group identification (gid) values are not defined in any of the files listed in USERADD_UID_TABLES and USERADD_GID_TABLES. If set to 'warn', a warning will be issued instead."
</info>
<glossdef>
<para role="glossdeffirst">
<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
- If set to "error", forces the OpenEmbedded build system to
- produce an error if the user identification
- (<filename>uid</filename>) and group identification
- (<filename>gid</filename>) values are not defined
- in <filename>files/passwd</filename>
- and <filename>files/group</filename> files.
- If set to "warn", a warning will be issued instead.
+
+ If set to <filename>error</filename>, forces the
+ OpenEmbedded build system to produce an error if the user
+ identification (<filename>uid</filename>) and group
+ identification (<filename>gid</filename>) values are not
+ defined in any of the files listed
+ in <link linkend='var-USERADD_UID_TABLES'><filename>USERADD_UID_TABLES</filename></link>
+ and <link linkend='var-USERADD_GID_TABLES'><filename>USERADD_GID_TABLES</filename></link>. If
+ set to <filename>warn</filename>, a warning will be issued
+ instead.
</para>
<para>
@@ -16808,6 +16811,20 @@
<link linkend='var-USERADD_GID_TABLES'><filename>USERADD_GID_TABLES</filename></link>
variables.
</para>
+
+ <note>
+ There is a difference in behavior between
+ setting <filename>USERADD_ERROR_DYNAMIC</filename>
+ to <filename>error</filename> and setting it
+ to <filename>warn</filename>. When it is set
+ to <filename>warn</filename>, the build system will report a
+ warning for every undefined <filename>uid</filename> and
+ <filename>gid</filename> in any recipe. But when it is set
+ to <filename>error</filename>, it will only report errors
+ for recipes that are actually built. This saves you from
+ having to add static IDs for recipes that you know will
+ never be built.
+ </note>
</glossdef>
</glossentry>
--
2.21.1
^ permalink raw reply related [flat|nested] 5+ messages in thread
* [master][zeus][PATCH 4/5] ref-manual: Add a variable description for AVAILABLE_LICENSES
2020-02-10 14:51 [master][zeus][PATCH 1/5] ref-manual: The sanity_info file has moved from build/conf to build/cache Peter Kjellerstedt
2020-02-10 14:51 ` [master][zeus][PATCH 2/5] ref-manual: Add missing/remove extraneous quotes Peter Kjellerstedt
2020-02-10 14:51 ` [master][zeus][PATCH 3/5] ref-manual: Update the documentation for USERADD_ERROR_DYNAMIC Peter Kjellerstedt
@ 2020-02-10 14:51 ` Peter Kjellerstedt
2020-02-10 14:51 ` [master][zeus][PATCH 5/5] ref-manual: Add a tips on how to achieve whitelisting of licenses Peter Kjellerstedt
3 siblings, 0 replies; 5+ messages in thread
From: Peter Kjellerstedt @ 2020-02-10 14:51 UTC (permalink / raw
To: docs
Signed-off-by: Peter Kjellerstedt <peter.kjellerstedt@axis.com>
---
documentation/ref-manual/ref-variables.xml | 24 ++++++++++++++++++++++
1 file changed, 24 insertions(+)
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index c8ece0c579..9e6d37ec0d 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -495,6 +495,30 @@
</glossdef>
</glossentry>
+ <glossentry id='var-AVAILABLE_LICENSES'><glossterm>AVAILABLE_LICENSES</glossterm>
+ <info>
+ AVAILABLE_LICENSES[doc] = "List of licenses found in the directories specified by COMMON_LICENSE_DIR and LICENSE_PATH."
+ </info>
+ <glossdef>
+ <para role="glossdeffirst">
+<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
+
+ List of licenses found in the directories specified
+ by <link linkend='var-COMMON_LICENSE_DIR'><filename>COMMON_LICENSE_DIR</filename></link>
+ and <link linkend='var-LICENSE_PATH'><filename>LICENSE_PATH</filename></link>.
+
+ <note>
+ It is assumed that all changes
+ to <filename>COMMON_LICENSE_DIR</filename>
+ and <filename>LICENSE_PATH</filename> have been done
+ before <filename>AVAILABLE_LICENSES</filename> is
+ defined
+ (in <link linkend='ref-classes-license'>license.bbclass</link>).
+ </note>
+ </para>
+ </glossdef>
+ </glossentry>
+
<glossentry id='var-AVAILTUNES'><glossterm>AVAILTUNES</glossterm>
<info>
AVAILTUNES[doc] = "The list of defined CPU and Application Binary Interface (ABI) tunings (i.e. "tunes") available for use by the OpenEmbedded build system."
--
2.21.1
^ permalink raw reply related [flat|nested] 5+ messages in thread
* [master][zeus][PATCH 5/5] ref-manual: Add a tips on how to achieve whitelisting of licenses
2020-02-10 14:51 [master][zeus][PATCH 1/5] ref-manual: The sanity_info file has moved from build/conf to build/cache Peter Kjellerstedt
` (2 preceding siblings ...)
2020-02-10 14:51 ` [master][zeus][PATCH 4/5] ref-manual: Add a variable description for AVAILABLE_LICENSES Peter Kjellerstedt
@ 2020-02-10 14:51 ` Peter Kjellerstedt
3 siblings, 0 replies; 5+ messages in thread
From: Peter Kjellerstedt @ 2020-02-10 14:51 UTC (permalink / raw
To: docs
It is sometimes more appropriate to define the licenses that are
allowed to be used rather than the ones that are not permitted. This
adds a tips on how this can be achieved by using AVAILABLE_LICENSES
and some Python set arithmetics.
Signed-off-by: Peter Kjellerstedt <peter.kjellerstedt@axis.com>
---
documentation/ref-manual/ref-variables.xml | 19 +++++++++++++++++++
1 file changed, 19 insertions(+)
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 9e6d37ec0d..7ab37de317 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -6774,6 +6774,25 @@
components that are required to produce a functional system
image.
</note>
+
+ <note><title>Tips</title>
+ It is possible to define a list of licenses that are allowed
+ to be used instead of the licenses that are excluded. To do
+ this, define a
+ variable <filename>COMPATIBLE_LICENSES</filename> with the
+ names of the licences that are allowed. Then
+ define <filename>INCOMPATIBLE_LICENSE</filename> as:
+ <literallayout class='monospaced'>
+ INCOMPATIBLE_LICENSE = "${@' '.join(sorted(set(d.getVar('AVAILABLE_LICENSES').split()) - set(d.getVar('COMPATIBLE_LICENSES').split())))}"
+ </literallayout>
+ This will result
+ in <filename>INCOMPATIBLE_LICENSE</filename> containing the
+ names of all licences
+ from <link linkend='var-AVAILABLE_LICENSES'><filename>AVAILABLE_LICENSES</filename></link>
+ except the ones specified
+ in <filename>COMPATIBLE_LICENSES</filename>, thus only
+ allowing the latter licences to be used.
+ </note>
</glossdef>
</glossentry>
--
2.21.1
^ permalink raw reply related [flat|nested] 5+ messages in thread
end of thread, other threads:[~2020-02-10 14:51 UTC | newest]
Thread overview: 5+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2020-02-10 14:51 [master][zeus][PATCH 1/5] ref-manual: The sanity_info file has moved from build/conf to build/cache Peter Kjellerstedt
2020-02-10 14:51 ` [master][zeus][PATCH 2/5] ref-manual: Add missing/remove extraneous quotes Peter Kjellerstedt
2020-02-10 14:51 ` [master][zeus][PATCH 3/5] ref-manual: Update the documentation for USERADD_ERROR_DYNAMIC Peter Kjellerstedt
2020-02-10 14:51 ` [master][zeus][PATCH 4/5] ref-manual: Add a variable description for AVAILABLE_LICENSES Peter Kjellerstedt
2020-02-10 14:51 ` [master][zeus][PATCH 5/5] ref-manual: Add a tips on how to achieve whitelisting of licenses Peter Kjellerstedt
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.