documentation/poky-ref-manual/ref-variables.xml: edits to FILESYSTEM_PERMS_TABLES.

Some minor re-wordings to give some context on how to use these special
files and the variable to point to them.

(From yocto-docs rev: 4482b42f4a224bada7a0fa5fe4821a753ba55d80)

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 2011-09-27 06:07:53 -07:00 committed by Richard Purdie
parent cd2c80dedc
commit f82ac840aa
1 changed files with 14 additions and 10 deletions

View File

@ -411,25 +411,29 @@
<glossdef> <glossdef>
<para>Allows you to define your own file permissions settings table as part of <para>Allows you to define your own file permissions settings table as part of
your configuration for the packaging process. your configuration for the packaging process.
For example, suppose you need a consistent set of custom permissions for
a set of groups and users across an entire work project.
It is best to do this in the packages themselves but this is not always
possible.
</para>
<para>
By default, the Yocto Project uses the <filename>fs-perms.txt</filename>, which By default, the Yocto Project uses the <filename>fs-perms.txt</filename>, which
is located in the <filename>meta/files</filename> directory of the Yocto Project is located in the <filename>meta/files</filename> directory of the Yocto Project
files directory. files directory.
While it is recommended that you just allow the build system to use the
default <filename>fs-perms.txt</filename>, you can create and use
your own file permissions file and then set
the <filename>FILESYSTEM_PERMS_TABLES</filename> variable to point to that
file.
</para>
<para>
If you create your own file permissions setting table, you should place it in your If you create your own file permissions setting table, you should place it in your
layer or the distros layer. layer or the distros layer.
</para>
<para>
You define the <filename>FILESYSTEM_PERMS_TABLES</filename> variable in the You define the <filename>FILESYSTEM_PERMS_TABLES</filename> variable in the
<filename>conf/local.conf</filename> file found in the Yocto Project's <filename>conf/local.conf</filename> file, which is found in the Yocto Project's
build directory. build directory, to point to your custom <filename>fs-perms.txt</filename>.
You can specify more than a single file permissions setting table.
The paths you specify to these files must be defined within the
<filename>BBPATH</filename> variable.
</para> </para>
<para> <para>
For guidance on how to create your own file permissions settings table file, For guidance on how to create your own file permissions settings table file,
see the <filename>fs-perms.txt</filename>. examine the existing <filename>fs-perms.txt</filename>.
</para> </para>
</glossdef> </glossdef>
</glossentry> </glossentry>