diff options
author | Scott Rifenbark <scott.m.rifenbark@intel.com> | 2014-04-07 14:10:50 -0700 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2014-04-08 14:20:15 +0100 |
commit | 90d52bd51e0e34dc8ffd9c83c3d7fe9551dcce8f (patch) | |
tree | 8c2bfb007d739177a09a49b089d6e5de40572cfd /documentation | |
parent | 9f1c18e22acb4bb4b86e988b9f20521af67ba55d (diff) | |
download | poky-90d52bd51e0e34dc8ffd9c83c3d7fe9551dcce8f.tar.gz |
ref-manual: Added useradd-staticids class and edits to some variables.
Added the new useradd-staticids class to the reference section
for classes.
Updated the USERADD_UID_TABLES and USERADD_GID_TABLES variables
to tell how the system uses BBPATH in the default mode to
get UID and GID information from the files/passwd and files/group
files.
Added a note indicating that you can delete the TMPDIR directory
to fix things up if you configure useradd-staticids in a
configured system.
(From yocto-docs rev: a3f5ee3f5060369405d59a238fb02bddfeae5d6f)
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation')
-rw-r--r-- | documentation/ref-manual/ref-classes.xml | 54 | ||||
-rw-r--r-- | documentation/ref-manual/ref-variables.xml | 22 |
2 files changed, 71 insertions, 5 deletions
diff --git a/documentation/ref-manual/ref-classes.xml b/documentation/ref-manual/ref-classes.xml index babe9bd2d6..df114f4eb2 100644 --- a/documentation/ref-manual/ref-classes.xml +++ b/documentation/ref-manual/ref-classes.xml | |||
@@ -3136,6 +3136,60 @@ | |||
3136 | </para> | 3136 | </para> |
3137 | </section> | 3137 | </section> |
3138 | 3138 | ||
3139 | <section id='ref-classes-useradd-staticids'> | ||
3140 | <title><filename>-useradd-staticids.bbclass</filename></title> | ||
3141 | |||
3142 | <para> | ||
3143 | The <filename>useradd-staticids</filename> class supports the addition of | ||
3144 | users or groups that have static user identification | ||
3145 | (<filename>uid</filename>) and group identification | ||
3146 | (<filename>gid</filename>) values. | ||
3147 | </para> | ||
3148 | |||
3149 | <para> | ||
3150 | The default behavior of the OpenEmbedded build system for assigning | ||
3151 | <filename>uid</filename> and <filename>gid</filename> values when | ||
3152 | packages add users and groups during package install time is to | ||
3153 | look in | ||
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 | ||
3158 | resulting users and groups become. | ||
3159 | In these cases, the order of the installation determines the final | ||
3160 | <filename>uid</filename> and <filename>gid</filename> values. | ||
3161 | </para> | ||
3162 | |||
3163 | <para> | ||
3164 | If non-deterministic | ||
3165 | <filename>uid</filename> and <filename>gid</filename> values are a | ||
3166 | problem, you can override the default, dynamic application of these | ||
3167 | values by setting static values. | ||
3168 | See the | ||
3169 | <link linkend='var-USERADDEXTENSION'><filename>USERADDEXTENSION</filename></link>, | ||
3170 | <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>, | ||
3172 | and | ||
3173 | <link linkend='var-USERADD_ERROR_DYNAMIC'><filename>USERADD_ERROR_DYNAMIC</filename></link> | ||
3174 | variables for more information. | ||
3175 | You can also see the | ||
3176 | <link linkend='ref-classes-useradd'><filename>useradd</filename></link> | ||
3177 | class for additional information. | ||
3178 | </para> | ||
3179 | |||
3180 | <note><title>Notes</title> | ||
3181 | You do not use this class directly. | ||
3182 | You either enable or disable the class by setting the | ||
3183 | <filename>USERADDEXTENSION</filename> variable. | ||
3184 | If you enable or disable the class in a configured system, | ||
3185 | <link linkend='var-TMPDIR'><filename>TMPDIR</filename></link> | ||
3186 | might contain incorrect <filename>uid</filename> and | ||
3187 | <filename>gid</filename> values. | ||
3188 | Deleting the <filename>TMPDIR</filename> directory | ||
3189 | will correct this condition. | ||
3190 | </note> | ||
3191 | </section> | ||
3192 | |||
3139 | <section id='ref-classes-utility-tasks'> | 3193 | <section id='ref-classes-utility-tasks'> |
3140 | <title><filename>utility-tasks.bbclass</filename></title> | 3194 | <title><filename>utility-tasks.bbclass</filename></title> |
3141 | 3195 | ||
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml index d553ba8f71..6eae958e58 100644 --- a/documentation/ref-manual/ref-variables.xml +++ b/documentation/ref-manual/ref-variables.xml | |||
@@ -7853,8 +7853,10 @@ 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 dynamically | 7856 | The default behavior for the build system is to look in |
7857 | apply <filename>gid</filename> values. | 7857 | <link linkend='var-BBPATH'><filename>BBPATH</filename></link> |
7858 | for a <filename>files/group</filename> file and then dynamically | ||
7859 | apply <filename>uid</filename> values. | ||
7858 | However, you can override this behavior by using the | 7860 | However, you can override this behavior by using the |
7859 | <link linkend='var-USERADDEXTENSION'><filename>USERADDEXTENSION</filename></link> | 7861 | <link linkend='var-USERADDEXTENSION'><filename>USERADDEXTENSION</filename></link> |
7860 | variable. | 7862 | variable. |
@@ -7885,8 +7887,10 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
7885 | </para> | 7887 | </para> |
7886 | 7888 | ||
7887 | <para> | 7889 | <para> |
7888 | The default behavior for the build system is to dynamically | 7890 | The default behavior for the build system is to look in |
7889 | apply <filename>uid</filename> values. | 7891 | <link linkend='var-BBPATH'><filename>BBPATH</filename></link> |
7892 | for the <filename>files/passwd</filename> file and | ||
7893 | then dynamically apply <filename>uid</filename> values. | ||
7890 | However, you can override this behavior by using the | 7894 | However, you can override this behavior by using the |
7891 | <link linkend='var-USERADDEXTENSION'><filename>USERADDEXTENSION</filename></link> | 7895 | <link linkend='var-USERADDEXTENSION'><filename>USERADDEXTENSION</filename></link> |
7892 | variable. | 7896 | variable. |
@@ -7965,7 +7969,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
7965 | </glossdef> | 7969 | </glossdef> |
7966 | </glossentry> | 7970 | </glossentry> |
7967 | 7971 | ||
7968 | <glossentry id='var-USERADDEXTENSION'><glossterm>USERADDEXTENTION</glossterm> | 7972 | <glossentry id='var-USERADDEXTENSION'><glossterm>USERADDEXTENSION</glossterm> |
7969 | <glossdef> | 7973 | <glossdef> |
7970 | <para> | 7974 | <para> |
7971 | When set to "useradd-staticids", causes the | 7975 | When set to "useradd-staticids", causes the |
@@ -7980,6 +7984,14 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" | |||
7980 | <literallayout class='monospaced'> | 7984 | <literallayout class='monospaced'> |
7981 | USERADDEXTENSION = "useradd-staticids" | 7985 | USERADDEXTENSION = "useradd-staticids" |
7982 | </literallayout> | 7986 | </literallayout> |
7987 | <note> | ||
7988 | Setting this variable to use static | ||
7989 | <filename>uid</filename> and <filename>gid</filename> | ||
7990 | values causes the OpenEmbedded build system to employ | ||
7991 | the | ||
7992 | <link linkend='ref-classes-useradd-staticids'><filename>useradd-staticids</filename></link> | ||
7993 | class. | ||
7994 | </note> | ||
7983 | </para> | 7995 | </para> |
7984 | 7996 | ||
7985 | <para> | 7997 | <para> |