summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--documentation/ref-manual/ref-classes.xml27
-rw-r--r--documentation/ref-manual/ref-variables.xml54
2 files changed, 42 insertions, 39 deletions
diff --git a/documentation/ref-manual/ref-classes.xml b/documentation/ref-manual/ref-classes.xml
index df114f4eb2..0031df26d8 100644
--- a/documentation/ref-manual/ref-classes.xml
+++ b/documentation/ref-manual/ref-classes.xml
@@ -3137,11 +3137,11 @@
3137</section> 3137</section>
3138 3138
3139<section id='ref-classes-useradd-staticids'> 3139<section id='ref-classes-useradd-staticids'>
3140 <title><filename>-useradd-staticids.bbclass</filename></title> 3140 <title><filename>useradd-staticids.bbclass</filename></title>
3141 3141
3142 <para> 3142 <para>
3143 The <filename>useradd-staticids</filename> class supports the addition of 3143 The <filename>useradd-staticids</filename> class supports the addition
3144 users or groups that have static user identification 3144 of users or groups that have static user identification
3145 (<filename>uid</filename>) and group identification 3145 (<filename>uid</filename>) and group identification
3146 (<filename>gid</filename>) values. 3146 (<filename>gid</filename>) values.
3147 </para> 3147 </para>
@@ -3150,28 +3150,31 @@
3150 The default behavior of the OpenEmbedded build system for assigning 3150 The default behavior of the OpenEmbedded build system for assigning
3151 <filename>uid</filename> and <filename>gid</filename> values when 3151 <filename>uid</filename> and <filename>gid</filename> values when
3152 packages add users and groups during package install time is to 3152 packages add users and groups during package install time is to
3153 look in 3153 add them dynamically.
3154 <link linkend='var-BBPATH'><filename>BBPATH</filename></link> for
3155 <filename>files/passwd</filename> and <filename>files/group</filename>
3156 files for the values.
3157 This works fine for programs that do not care what the values of the 3154 This works fine for programs that do not care what the values of the
3158 resulting users and groups become. 3155 resulting users and groups become.
3159 In these cases, the order of the installation determines the final 3156 In these cases, the order of the installation determines the final
3160 <filename>uid</filename> and <filename>gid</filename> values. 3157 <filename>uid</filename> and <filename>gid</filename> values.
3161 </para> 3158 However, if non-deterministic
3162
3163 <para>
3164 If non-deterministic
3165 <filename>uid</filename> and <filename>gid</filename> values are a 3159 <filename>uid</filename> and <filename>gid</filename> values are a
3166 problem, you can override the default, dynamic application of these 3160 problem, you can override the default, dynamic application of these
3167 values by setting static values. 3161 values by setting static values.
3162 When you set static values, the OpenEmbedded build system looks in
3163 <link linkend='var-BBPATH'><filename>BBPATH</filename></link> for
3164 <filename>files/passwd</filename> and <filename>files/group</filename>
3165 files for the values.
3166 </para>
3167
3168 <para>
3169 To use static <filename>uid</filename> and <filename>gid</filename>
3170 values, you need to set some variables.
3168 See the 3171 See the
3169 <link linkend='var-USERADDEXTENSION'><filename>USERADDEXTENSION</filename></link>, 3172 <link linkend='var-USERADDEXTENSION'><filename>USERADDEXTENSION</filename></link>,
3170 <link linkend='var-USERADD_UID_TABLES'><filename>USERADD_UID_TABLES</filename></link>, 3173 <link linkend='var-USERADD_UID_TABLES'><filename>USERADD_UID_TABLES</filename></link>,
3171 <link linkend='var-USERADD_GID_TABLES'><filename>USERADD_GID_TABLES</filename></link>, 3174 <link linkend='var-USERADD_GID_TABLES'><filename>USERADD_GID_TABLES</filename></link>,
3172 and 3175 and
3173 <link linkend='var-USERADD_ERROR_DYNAMIC'><filename>USERADD_ERROR_DYNAMIC</filename></link> 3176 <link linkend='var-USERADD_ERROR_DYNAMIC'><filename>USERADD_ERROR_DYNAMIC</filename></link>
3174 variables for more information. 3177 variables.
3175 You can also see the 3178 You can also see the
3176 <link linkend='ref-classes-useradd'><filename>useradd</filename></link> 3179 <link linkend='ref-classes-useradd'><filename>useradd</filename></link>
3177 class for additional information. 3180 class for additional information.
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 6eae958e58..258ae2c6db 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -7853,26 +7853,24 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
7853 </para> 7853 </para>
7854 7854
7855 <para> 7855 <para>
7856 The default behavior for the build system is to look in 7856 When applying static group identification
7857 (<filename>gid</filename>) values, the OpenEmbedded build
7858 system looks in
7857 <link linkend='var-BBPATH'><filename>BBPATH</filename></link> 7859 <link linkend='var-BBPATH'><filename>BBPATH</filename></link>
7858 for a <filename>files/group</filename> file and then dynamically 7860 for a <filename>files/group</filename> file and then applies
7859 apply <filename>uid</filename> values. 7861 those <filename>uid</filename> values.
7860 However, you can override this behavior by using the 7862 Set the variable as follows in your
7861 <link linkend='var-USERADDEXTENSION'><filename>USERADDEXTENSION</filename></link> 7863 <filename>local.conf</filename> file:
7862 variable.
7863 When you do use static values, you must also set the
7864 <filename>USERADD_GID_TABLES</filename> variable in your
7865 <filename>local.conf</filename> file as follows:
7866 <literallayout class='monospaced'> 7864 <literallayout class='monospaced'>
7867 USERADD_GID_TABLES = "files/group" 7865 USERADD_GID_TABLES = "files/group"
7868 </literallayout> 7866 </literallayout>
7869 </para> 7867 </para>
7870 7868
7871 <note> 7869 <note>
7872 When using static information for user adds, you must 7870 Setting the
7873 also use the 7871 <link linkend='var-USERADDEXTENSION'><filename>USERADDEXTENSION</filename></link>
7874 <link linkend='var-USERADD_UID_TABLES'><filename>USERADD_UID_TABLES</filename></link> 7872 variable to "useradd-staticids" causes the build system
7875 variable. 7873 to use static <filename>gid</filename> values.
7876 </note> 7874 </note>
7877 </glossdef> 7875 </glossdef>
7878 </glossentry> 7876 </glossentry>
@@ -7887,26 +7885,24 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
7887 </para> 7885 </para>
7888 7886
7889 <para> 7887 <para>
7890 The default behavior for the build system is to look in 7888 When applying static user identification
7889 (<filename>uid</filename>) values, the OpenEmbedded build
7890 system looks in
7891 <link linkend='var-BBPATH'><filename>BBPATH</filename></link> 7891 <link linkend='var-BBPATH'><filename>BBPATH</filename></link>
7892 for the <filename>files/passwd</filename> file and 7892 for a <filename>files/passwd</filename> file and then applies
7893 then dynamically apply <filename>uid</filename> values. 7893 those <filename>uid</filename> values.
7894 However, you can override this behavior by using the 7894 Set the variable as follows in your
7895 <link linkend='var-USERADDEXTENSION'><filename>USERADDEXTENSION</filename></link> 7895 <filename>local.conf</filename> file:
7896 variable.
7897 When you do use static values, you must also set the
7898 <filename>USERADD_UID_TABLES</filename> variable in your
7899 <filename>local.conf</filename> file as follows:
7900 <literallayout class='monospaced'> 7896 <literallayout class='monospaced'>
7901 USERADD_UID_TABLES = "files/passwd" 7897 USERADD_UID_TABLES = "files/passwd"
7902 </literallayout> 7898 </literallayout>
7903 </para> 7899 </para>
7904 7900
7905 <note> 7901 <note>
7906 When using static information for group adds, you must 7902 Setting the
7907 also use the 7903 <link linkend='var-USERADDEXTENSION'><filename>USERADDEXTENSION</filename></link>
7908 <link linkend='var-USERADD_GID_TABLES'><filename>USERADD_GID_TABLES</filename></link> 7904 variable to "useradd-staticids" causes the build system
7909 variable. 7905 to use static <filename>uid</filename> values.
7910 </note> 7906 </note>
7911 </glossdef> 7907 </glossdef>
7912 </glossentry> 7908 </glossentry>
@@ -7976,7 +7972,11 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
7976 OpenEmbedded build system to base all user and group 7972 OpenEmbedded build system to base all user and group
7977 additions on a static 7973 additions on a static
7978 <filename>passwd</filename> and 7974 <filename>passwd</filename> and
7979 <filename>group</filename> files. 7975 <filename>group</filename> files found in
7976 <link linkend='var-BBPATH'><filename>BBPATH</filename></link>.
7977 </para>
7978
7979 <para>
7980 To use static user identification (<filename>uid</filename>) 7980 To use static user identification (<filename>uid</filename>)
7981 and group identification (<filename>gid</filename>) 7981 and group identification (<filename>gid</filename>)
7982 values, set the variable 7982 values, set the variable