diff options
author | Scott Rifenbark <scott.m.rifenbark@intel.com> | 2014-04-07 14:46:03 -0700 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2014-04-08 14:20:16 +0100 |
commit | 68a55c8ff779d8df90626e68d5d4e48660dd8027 (patch) | |
tree | 3b0c88f6fbd44048f9d3b65fc7b2db271ee098bb /documentation/ref-manual/ref-classes.xml | |
parent | 90d52bd51e0e34dc8ffd9c83c3d7fe9551dcce8f (diff) | |
download | poky-68a55c8ff779d8df90626e68d5d4e48660dd8027.tar.gz |
ref-manual: Edits to fix up how GID and UIDs are handled.
Some review edits to change the useradd-staticids class and the
related USERADD* variables. Input from Paul Eggleton.
(From yocto-docs rev: 9b94046721a971de41d2062a48d624e06dcf17f0)
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/ref-manual/ref-classes.xml')
-rw-r--r-- | documentation/ref-manual/ref-classes.xml | 27 |
1 files changed, 15 insertions, 12 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. |