mirrors/poky
1
0
Fork 0
mirror of https://git.yoctoproject.org/poky synced 2026-04-17 09:32:12 +02:00
Code Issues Packages Projects Releases Wiki Activity

ref-manual: Update the documentation for USERADD_ERROR_DYNAMIC

Browse Source 
* 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]

(From yocto-docs rev: 28cd546f3fe1eadd73ba71f9fe9a558538e69b0f)

Signed-off-by: Peter Kjellerstedt <peter.kjellerstedt@axis.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Peter Kjellerstedt
2020-02-20 21:27:31 +01:00
committed by Richard Purdie
parent 91241f2b12
commit a4cc2e0d44
1 changed files with 25 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

33
documentation/ref-manual/ref-variables.xml
View File

@@ -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>