diff options
Diffstat (limited to 'documentation/ref-manual/ref-classes.xml')
-rw-r--r-- | documentation/ref-manual/ref-classes.xml | 54 |
1 files changed, 54 insertions, 0 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 | ||