mirrors/poky
1
0
Fork 0
mirror of https://git.yoctoproject.org/poky synced 2026-05-30 00:20:08 +00:00
Code Issues Projects Releases Wiki Activity

ref-manual: Edits to fix up how GID and UIDs are handled.

Browse Source 
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
Download Patch File Download Diff File Expand all files Collapse all files
documentation/ref-manual/ref-classes.xml
+15 -12
View File
@@ -3137,11 +3137,11 @@
</section> </section>
<section id='ref-classes-useradd-staticids'> <section id='ref-classes-useradd-staticids'>
<title><filename>-useradd-staticids.bbclass</filename></title> <title><filename>useradd-staticids.bbclass</filename></title>
<para> <para>
The <filename>useradd-staticids</filename> class supports the addition of The <filename>useradd-staticids</filename> class supports the addition
users or groups that have static user identification of users or groups that have static user identification
(<filename>uid</filename>) and group identification (<filename>uid</filename>) and group identification
(<filename>gid</filename>) values. (<filename>gid</filename>) values.
</para> </para>
@@ -3150,28 +3150,31 @@
The default behavior of the OpenEmbedded build system for assigning The default behavior of the OpenEmbedded build system for assigning
<filename>uid</filename> and <filename>gid</filename> values when <filename>uid</filename> and <filename>gid</filename> values when
packages add users and groups during package install time is to packages add users and groups during package install time is to
look in add them dynamically.
<link linkend='var-BBPATH'><filename>BBPATH</filename></link> for
<filename>files/passwd</filename> and <filename>files/group</filename>
files for the values.
This works fine for programs that do not care what the values of the This works fine for programs that do not care what the values of the
resulting users and groups become. resulting users and groups become.
In these cases, the order of the installation determines the final In these cases, the order of the installation determines the final
<filename>uid</filename> and <filename>gid</filename> values. <filename>uid</filename> and <filename>gid</filename> values.
</para> However, if non-deterministic
<para>
If non-deterministic
<filename>uid</filename> and <filename>gid</filename> values are a <filename>uid</filename> and <filename>gid</filename> values are a
problem, you can override the default, dynamic application of these problem, you can override the default, dynamic application of these
values by setting static values. 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 See the
<link linkend='var-USERADDEXTENSION'><filename>USERADDEXTENSION</filename></link>, <link linkend='var-USERADDEXTENSION'><filename>USERADDEXTENSION</filename></link>,
<link linkend='var-USERADD_UID_TABLES'><filename>USERADD_UID_TABLES</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>, <link linkend='var-USERADD_GID_TABLES'><filename>USERADD_GID_TABLES</filename></link>,
and and
<link linkend='var-USERADD_ERROR_DYNAMIC'><filename>USERADD_ERROR_DYNAMIC</filename></link> <link linkend='var-USERADD_ERROR_DYNAMIC'><filename>USERADD_ERROR_DYNAMIC</filename></link>
variables for more information. variables.
You can also see the You can also see the
<link linkend='ref-classes-useradd'><filename>useradd</filename></link> <link linkend='ref-classes-useradd'><filename>useradd</filename></link>
class for additional information. class for additional information.
documentation/ref-manual/ref-variables.xml
+27 -27
View File
@@ -7853,26 +7853,24 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
</para> </para>
<para> <para>
The default behavior for the build system is to look in When applying static group identification
(<filename>gid</filename>) values, the OpenEmbedded build
system looks in
<link linkend='var-BBPATH'><filename>BBPATH</filename></link> <link linkend='var-BBPATH'><filename>BBPATH</filename></link>
for a <filename>files/group</filename> file and then dynamically for a <filename>files/group</filename> file and then applies
apply <filename>uid</filename> values. those <filename>uid</filename> values.
However, you can override this behavior by using the Set the variable as follows in your
<link linkend='var-USERADDEXTENSION'><filename>USERADDEXTENSION</filename></link> <filename>local.conf</filename> file:
variable.
When you do use static values, you must also set the
<filename>USERADD_GID_TABLES</filename> variable in your
<filename>local.conf</filename> file as follows:
<literallayout class='monospaced'> <literallayout class='monospaced'>
USERADD_GID_TABLES = "files/group" USERADD_GID_TABLES = "files/group"
</literallayout> </literallayout>
</para> </para>
<note> <note>
When using static information for user adds, you must Setting the
also use the <link linkend='var-USERADDEXTENSION'><filename>USERADDEXTENSION</filename></link>
<link linkend='var-USERADD_UID_TABLES'><filename>USERADD_UID_TABLES</filename></link> variable to "useradd-staticids" causes the build system
variable. to use static <filename>gid</filename> values.
</note> </note>
</glossdef> </glossdef>
</glossentry> </glossentry>
@@ -7887,26 +7885,24 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
</para> </para>
<para> <para>
The default behavior for the build system is to look in When applying static user identification
(<filename>uid</filename>) values, the OpenEmbedded build
system looks in
<link linkend='var-BBPATH'><filename>BBPATH</filename></link> <link linkend='var-BBPATH'><filename>BBPATH</filename></link>
for the <filename>files/passwd</filename> file and for a <filename>files/passwd</filename> file and then applies
then dynamically apply <filename>uid</filename> values. those <filename>uid</filename> values.
However, you can override this behavior by using the Set the variable as follows in your
<link linkend='var-USERADDEXTENSION'><filename>USERADDEXTENSION</filename></link> <filename>local.conf</filename> file:
variable.
When you do use static values, you must also set the
<filename>USERADD_UID_TABLES</filename> variable in your
<filename>local.conf</filename> file as follows:
<literallayout class='monospaced'> <literallayout class='monospaced'>
USERADD_UID_TABLES = "files/passwd" USERADD_UID_TABLES = "files/passwd"
</literallayout> </literallayout>
</para> </para>
<note> <note>
When using static information for group adds, you must Setting the
also use the <link linkend='var-USERADDEXTENSION'><filename>USERADDEXTENSION</filename></link>
<link linkend='var-USERADD_GID_TABLES'><filename>USERADD_GID_TABLES</filename></link> variable to "useradd-staticids" causes the build system
variable. to use static <filename>uid</filename> values.
</note> </note>
</glossdef> </glossdef>
</glossentry> </glossentry>
@@ -7976,7 +7972,11 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
OpenEmbedded build system to base all user and group OpenEmbedded build system to base all user and group
additions on a static additions on a static
<filename>passwd</filename> and <filename>passwd</filename> and
<filename>group</filename> files. <filename>group</filename> files found in
<link linkend='var-BBPATH'><filename>BBPATH</filename></link>.
</para>
<para>
To use static user identification (<filename>uid</filename>) To use static user identification (<filename>uid</filename>)
and group identification (<filename>gid</filename>) and group identification (<filename>gid</filename>)
values, set the variable values, set the variable