1
0
mirror of https://git.yoctoproject.org/poky synced 2026-05-30 00:20:08 +00:00

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>
This commit is contained in:
Scott Rifenbark
2014-04-07 14:46:03 -07:00
committed by Richard Purdie
parent 90d52bd51e
commit 68a55c8ff7
2 changed files with 42 additions and 39 deletions
+15 -12
View File
@@ -3137,11 +3137,11 @@
</section>
<section id='ref-classes-useradd-staticids'>
<title><filename>-useradd-staticids.bbclass</filename></title>
<title><filename>useradd-staticids.bbclass</filename></title>
<para>
The <filename>useradd-staticids</filename> class supports the addition of
users or groups that have static user identification
The <filename>useradd-staticids</filename> class supports the addition
of users or groups that have static user identification
(<filename>uid</filename>) and group identification
(<filename>gid</filename>) values.
</para>
@@ -3150,28 +3150,31 @@
The default behavior of the OpenEmbedded build system for assigning
<filename>uid</filename> and <filename>gid</filename> values when
packages add users and groups during package install time is to
look in
<link linkend='var-BBPATH'><filename>BBPATH</filename></link> for
<filename>files/passwd</filename> and <filename>files/group</filename>
files for the values.
add them dynamically.
This works fine for programs that do not care what the values of the
resulting users and groups become.
In these cases, the order of the installation determines the final
<filename>uid</filename> and <filename>gid</filename> values.
</para>
<para>
If non-deterministic
However, if non-deterministic
<filename>uid</filename> and <filename>gid</filename> values are a
problem, you can override the default, dynamic application of these
values by setting static values.
When you set static values, the OpenEmbedded build system looks in
<link linkend='var-BBPATH'><filename>BBPATH</filename></link> for
<filename>files/passwd</filename> and <filename>files/group</filename>
files for the values.
</para>
<para>
To use static <filename>uid</filename> and <filename>gid</filename>
values, you need to set some variables.
See the
<link linkend='var-USERADDEXTENSION'><filename>USERADDEXTENSION</filename></link>,
<link linkend='var-USERADD_UID_TABLES'><filename>USERADD_UID_TABLES</filename></link>,
<link linkend='var-USERADD_GID_TABLES'><filename>USERADD_GID_TABLES</filename></link>,
and
<link linkend='var-USERADD_ERROR_DYNAMIC'><filename>USERADD_ERROR_DYNAMIC</filename></link>
variables for more information.
variables.
You can also see the
<link linkend='ref-classes-useradd'><filename>useradd</filename></link>
class for additional information.