summaryrefslogtreecommitdiffstats
path: root/documentation/ref-manual
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/ref-manual')
-rw-r--r--documentation/ref-manual/ref-variables.xml33
1 files 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 @@
16770 16770
16771 <glossentry id='var-USERADD_ERROR_DYNAMIC'><glossterm>USERADD_ERROR_DYNAMIC</glossterm> 16771 <glossentry id='var-USERADD_ERROR_DYNAMIC'><glossterm>USERADD_ERROR_DYNAMIC</glossterm>
16772 <info> 16772 <info>
16773 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." 16773 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."
16774 </info> 16774 </info>
16775 <glossdef> 16775 <glossdef>
16776 <para role="glossdeffirst"> 16776 <para role="glossdeffirst">
16777<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> 16777<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
16778 If set to "error", forces the OpenEmbedded build system to 16778
16779 produce an error if the user identification 16779 If set to <filename>error</filename>, forces the
16780 (<filename>uid</filename>) and group identification 16780 OpenEmbedded build system to produce an error if the user
16781 (<filename>gid</filename>) values are not defined 16781 identification (<filename>uid</filename>) and group
16782 in <filename>files/passwd</filename> 16782 identification (<filename>gid</filename>) values are not
16783 and <filename>files/group</filename> files. 16783 defined in any of the files listed
16784 If set to "warn", a warning will be issued instead. 16784 in <link linkend='var-USERADD_UID_TABLES'><filename>USERADD_UID_TABLES</filename></link>
16785 and <link linkend='var-USERADD_GID_TABLES'><filename>USERADD_GID_TABLES</filename></link>. If
16786 set to <filename>warn</filename>, a warning will be issued
16787 instead.
16785 </para> 16788 </para>
16786 16789
16787 <para> 16790 <para>
@@ -16808,6 +16811,20 @@
16808 <link linkend='var-USERADD_GID_TABLES'><filename>USERADD_GID_TABLES</filename></link> 16811 <link linkend='var-USERADD_GID_TABLES'><filename>USERADD_GID_TABLES</filename></link>
16809 variables. 16812 variables.
16810 </para> 16813 </para>
16814
16815 <note>
16816 There is a difference in behavior between
16817 setting <filename>USERADD_ERROR_DYNAMIC</filename>
16818 to <filename>error</filename> and setting it
16819 to <filename>warn</filename>. When it is set
16820 to <filename>warn</filename>, the build system will report a
16821 warning for every undefined <filename>uid</filename> and
16822 <filename>gid</filename> in any recipe. But when it is set
16823 to <filename>error</filename>, it will only report errors
16824 for recipes that are actually built. This saves you from
16825 having to add static IDs for recipes that you know will
16826 never be built.
16827 </note>
16811 </glossdef> 16828 </glossdef>
16812 </glossentry> 16829 </glossentry>
16813 16830