diff options
Diffstat (limited to 'documentation/ref-manual/variables.rst')
-rw-r--r-- | documentation/ref-manual/variables.rst | 40 |
1 files changed, 18 insertions, 22 deletions
diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst index 0d2d255edb..d7cf48422e 100644 --- a/documentation/ref-manual/variables.rst +++ b/documentation/ref-manual/variables.rst | |||
@@ -13,7 +13,7 @@ system and gives an overview of their function and contents. | |||
13 | :term:`K <KARCH>` :term:`L <LABELS>` :term:`M <MACHINE>` | 13 | :term:`K <KARCH>` :term:`L <LABELS>` :term:`M <MACHINE>` |
14 | :term:`N <NATIVELSBSTRING>` :term:`O <OBJCOPY>` :term:`P` | 14 | :term:`N <NATIVELSBSTRING>` :term:`O <OBJCOPY>` :term:`P` |
15 | :term:`R <RANLIB>` :term:`S` :term:`T` | 15 | :term:`R <RANLIB>` :term:`S` :term:`T` |
16 | :term:`U <UBOOT_CONFIG>` :term:`V <VOLATILE_LOG_DIR>` | 16 | :term:`U <UBOOT_CONFIG>` :term:`V <VIRTUAL-RUNTIME>` |
17 | :term:`W <WARN_QA>` :term:`X <XSERVER>` | 17 | :term:`W <WARN_QA>` :term:`X <XSERVER>` |
18 | 18 | ||
19 | .. glossary:: | 19 | .. glossary:: |
@@ -3007,26 +3007,30 @@ system and gives an overview of their function and contents. | |||
3007 | :ref:`ref-tasks-patch` task as well. | 3007 | :ref:`ref-tasks-patch` task as well. |
3008 | 3008 | ||
3009 | :term:`FILESYSTEM_PERMS_TABLES` | 3009 | :term:`FILESYSTEM_PERMS_TABLES` |
3010 | Allows you to define your own file permissions settings table as part | 3010 | Allows you to define your own file permissions settings tables as part |
3011 | of your configuration for the packaging process. For example, suppose | 3011 | of your configuration for the packaging process. For example, suppose |
3012 | you need a consistent set of custom permissions for a set of groups | 3012 | you need a consistent set of custom permissions for a set of groups |
3013 | and users across an entire work project. It is best to do this in the | 3013 | and users across an entire work project. It is best to do this in the |
3014 | packages themselves but this is not always possible. | 3014 | packages themselves but this is not always possible. |
3015 | 3015 | ||
3016 | By default, the OpenEmbedded build system uses the ``fs-perms.txt``, | 3016 | By default, the OpenEmbedded build system uses the ``fs-perms.txt`` and |
3017 | which is located in the ``meta/files`` folder in the :term:`Source Directory`. | 3017 | ``fs-perms-volatile-log.txt`` which are located in the ``meta/files`` |
3018 | If you create your own file | 3018 | folder in the :term:`Source Directory`. If you create your own permission |
3019 | permissions setting table, you should place it in your layer or the | 3019 | setting table files, you should place those in your layer. |
3020 | distro's layer. | ||
3021 | 3020 | ||
3022 | You define the :term:`FILESYSTEM_PERMS_TABLES` variable in the | 3021 | You can override the value of :term:`FILESYSTEM_PERMS_TABLES` variable |
3023 | ``conf/local.conf`` file, which is found in the :term:`Build Directory`, | 3022 | in your distribution configuration file to point to your custom |
3024 | to point to your custom ``fs-perms.txt``. You can specify more than a | 3023 | permission table files. You can specify one or more file permissions |
3025 | single file permissions setting table. The paths you specify to these | 3024 | setting tables. The paths that you specify to these files must be defined |
3026 | files must be defined within the :term:`BBPATH` variable. | 3025 | within the :term:`BBPATH` variable. |
3027 | 3026 | ||
3028 | For guidance on how to create your own file permissions settings | 3027 | In order to disable the volatile log, which is enabled by default, one |
3029 | table file, examine the existing ``fs-perms.txt``. | 3028 | can remove the ``files/fs-perms-volatile-log.txt`` value from |
3029 | ``FILESYSTEM_PERMS_TABLES``. | ||
3030 | |||
3031 | For guidance on how to define your own file permissions settings | ||
3032 | tables, examine the existing ``fs-perms.txt`` and | ||
3033 | ``fs-perms-volatile-log.txt`` files. | ||
3030 | 3034 | ||
3031 | :term:`FIT_ADDRESS_CELLS` | 3035 | :term:`FIT_ADDRESS_CELLS` |
3032 | Specifies the value of the ``#address-cells`` value for the | 3036 | Specifies the value of the ``#address-cells`` value for the |
@@ -10075,14 +10079,6 @@ system and gives an overview of their function and contents. | |||
10075 | 10079 | ||
10076 | PACKAGE_INSTALL = "${INITRAMFS_SCRIPTS} ${VIRTUAL-RUNTIME_base-utils} base-passwd" | 10080 | PACKAGE_INSTALL = "${INITRAMFS_SCRIPTS} ${VIRTUAL-RUNTIME_base-utils} base-passwd" |
10077 | 10081 | ||
10078 | :term:`VOLATILE_LOG_DIR` | ||
10079 | Specifies the persistence of the target's ``/var/log`` directory, | ||
10080 | which is used to house postinstall target log files. | ||
10081 | |||
10082 | By default, :term:`VOLATILE_LOG_DIR` is set to "yes", which means the | ||
10083 | file is not persistent. You can override this setting by setting the | ||
10084 | variable to "no" to make the log directory persistent. | ||
10085 | |||
10086 | :term:`VOLATILE_TMP_DIR` | 10082 | :term:`VOLATILE_TMP_DIR` |
10087 | Specifies the persistence of the target's ``/tmp`` directory. | 10083 | Specifies the persistence of the target's ``/tmp`` directory. |
10088 | 10084 | ||