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>
<para>Allows you to define your own file permissions settings table as part of
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
is located in the <filename>meta/files</filename> directory of the Yocto Project
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
layer or the distros layer.
</para>
<para>
You define the <filename>FILESYSTEM_PERMS_TABLES</filename> variable in the
<filename>conf/local.conf</filename> file found in the Yocto Project's
build directory.
<filename>conf/local.conf</filename> file, which is found in the Yocto Project's
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>
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>
</glossdef>
</glossentry>