From patchwork Wed Oct 16 14:09:39 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Niko Mauno X-Patchwork-Id: 50772 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id 6ABAFD1F9D8 for ; Wed, 16 Oct 2024 14:10:17 +0000 (UTC) Received: from EUR03-VI1-obe.outbound.protection.outlook.com (EUR03-VI1-obe.outbound.protection.outlook.com [40.107.103.120]) by mx.groups.io with SMTP id smtpd.web11.24245.1729087812141743646 for ; Wed, 16 Oct 2024 07:10:13 -0700 Authentication-Results: mx.groups.io; dkim=fail reason="dkim: body hash did not verify" header.i=@vaisala.com header.s=selector1 header.b=R61WJMNC; spf=permerror, err=parse error for token &{10 18 spf3.vaisala.com}: parse error for token &{10 18 _spf-dc57.sapsf.eu}: limit exceeded (domain: vaisala.com, ip: 40.107.103.120, mailfrom: niko.mauno@vaisala.com) ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=Sn2NdDdpFmhIfrNoJ3A6O2VbiBQtJ2AjjCz+7QtKd6i8aFtb6wO8e1z79syURAfdd1uny6GlghWc0ba+Xx4W5os/UvZ6hoI7t8kdb28C9zCqnE+HNWjKY+baIz/orLcU+5uDr07rIb3uMs+ieNPouA5bUyrUQgTgef5MnENgcQioDT6hqm402rLAZvDL27Mzo6HNepZQmT5D4dFNxkMYKmK0T+yxxUNxd37tFFEjTRGBh2lFWFzuabr1dbAPuqdsHdaxdCU/ddOIfftn6eZPPlAeP7Qu/1iwb9V76l7YHAjc2NUtOCXxjJln4vxXVBRiBq7OE6xVB1jT/DMaSPii5g== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector10001; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=C+lvvJam2Dqct9ZB8gnoYD5pmuf1OsSNzSiSx1aXylM=; b=atY/ZRRc94NTn3UQDdqKNsr80uWg/OspXHHvnVxVgmMuTg7Z73xAGDmFMlwsy80HU9NDBmuu30Bztmcq9ZNCzBP02BDhvd1/4JEJEdviq9C4IRcUqlBNxrOdwvvYxu8XoqyPub2aKKMxLU1iCbWmfJNYTSO45GQBrXTwaucgttPj2ekuNXIM3ZzY/zpluOLXInd3z+hNtkss5KwFfmS6k7YBU3jhRe84P6EaoRRonTNLyQhYvJeCCbLFgQIs7dol2SVidkwueSC3BSrSxp1ErrnfeXlITw7RziCJueANN8RaSf9fiNuvgyvLaA3DStREeHGlkdcLicopJ6eVL60jBQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=vaisala.com; dmarc=pass action=none header.from=vaisala.com; dkim=pass header.d=vaisala.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=vaisala.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=C+lvvJam2Dqct9ZB8gnoYD5pmuf1OsSNzSiSx1aXylM=; b=R61WJMNC1VVctlsr3B+1K9b7ktPNPt5WZsJyb74DDCxw4+hr1fVuXGhiwBC6MDk37maJAzo1qNv5sT+7CkyUOdfl+Hfmc0ovaCa6b7MBHC1FXXH4bgTa9YJQMhiDWC/dFYNQB0uqS1u3Rfm//DQdMsPNZO/Y46oiNK2C3PO7lQr2LtCYkmyB4/Y5Sgp2mKbhJps3opLkN5ry1ymOdbAPhRwsyWbNxQiWrm9Cr7B+snGeNa28zJ/rHUCSUiSWRKkhlCwuvIrX7bl2OM+vZiFrB/wix9osTMqCqZfUBZwhfhFzBLSCMYcTydt3G5uvF8Xx+iU+Rj/AAlh2s+5azBgLuw== Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=vaisala.com; Received: from AS4PR06MB8447.eurprd06.prod.outlook.com (2603:10a6:20b:4e2::11) by GVXPR06MB9178.eurprd06.prod.outlook.com (2603:10a6:150:1c2::7) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.8069.18; Wed, 16 Oct 2024 14:10:05 +0000 Received: from AS4PR06MB8447.eurprd06.prod.outlook.com ([fe80::af93:b150:b886:b2bc]) by AS4PR06MB8447.eurprd06.prod.outlook.com ([fe80::af93:b150:b886:b2bc%6]) with mapi id 15.20.8048.020; Wed, 16 Oct 2024 14:10:05 +0000 From: Niko Mauno To: docs@lists.yoctoproject.org CC: quentin.schulz@cherry.de, antonin.godard@bootlin.com, Niko Mauno Subject: [PATCHv5 1/2] docs: Replace VOLATILE_LOG_DIR with FILESYSTEM_PERMS_TABLES Date: Wed, 16 Oct 2024 14:09:39 +0000 Message-ID: <20241016140940.3166992-1-niko.mauno@vaisala.com> X-Mailer: git-send-email 2.39.2 X-ClientProxiedBy: GV3P280CA0054.SWEP280.PROD.OUTLOOK.COM (2603:10a6:150:9::24) To AS4PR06MB8447.eurprd06.prod.outlook.com (2603:10a6:20b:4e2::11) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: AS4PR06MB8447:EE_|GVXPR06MB9178:EE_ X-MS-Office365-Filtering-Correlation-Id: a531246a-b8d6-4687-39ef-08dcedec3be6 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0;ARA:13230040|376014|52116014|366016|1800799024|38350700014; X-Microsoft-Antispam-Message-Info: broPYqyCDUWZyQqdx+/jD6LpaEYZFfI/i1XindUitKKHKiFjqM3bewI3qkyy7eFFIfUGMR9sNpZj6PcFAFegc6M2nfBrGmi7VamK/PRb0cZsy8iReGvILfbta+TLsVaaeEtyEiiiuPdMHsnANulzsUT9xsNH65KCO62IESMxuuODRFznzVLiKezpwfYMRIWTmrhSRaXwbsPuqhhVeGSBhNklj4/W3bWA/Vyx7Z8dntI4uXJjQlhYPPsLi3Mxaq1+sxPOl1r9vN+RSeanthJ9txIm6DQmnJrfGjqXo64YyjvOU7IzwIYAnGQGhQ47YqLZsUowXnwhzPWglOvLvLEKp8ovbBpf55LtudbXm7MNYjU6lem+B1mNUbKB34ct2zkOZPUfTUh3FkpbZMVcDbaUoTbWaHZ4jTmSXUYgfJ9/Rg3FKH6Y0vxEPVqhP+cn8gXqIIaBodeFC5aBjvHCw98mCzT7DidQXN5lFIs62t5wukx13kpgi2/XcH6FWooJ0jIry4UdnR0t22mS5XD0kB+gpBmzRXjhuavsqMMcf2G02git6QL+DKJOBkblxH8uaT7edIF5SHvPR8Fmc1FCmT44dEvP87bgRUHVNN1YHr1xo270YdG8J19JJsI/5sfHSrZ5/G7VbfUC9ZVOEvl9DpMXriZOLSoebDbRenep37yWA3RR1BUB7DPOb+hBQx+yWiv87DHFDlS1pABseO4evm43vuh/oOVLXrUnwqIXjEkKZ/DIDZm1W+5gKpTGWF8P2GmL+cXR9c60OZ6VKCpVzNmPuUR01ASPZNvpdPohebO4ZHMkM0+8QVRBBxqwU0nD5wKnuKCtXncFgOlD/+bpn+RtG4ZVVc3xoEhDAK/iCnFbdKhvSDM0ro2htWkQ2A0v+TVCxzwQm5nRY/gb4LbULEZykaSwm+vBfWo5aUkoDzIIKXI1JAk/Xdv96V+rahBtttdIyV5ZKA2mNzf1FqWkgPIeqyxO1ES8SVTNq4+VCaRIk/lQ6GWMs/FZgZG6B8P/x6b1AojBPET9YiiMhug8N9ECFujNW0FEG3SEwx2SudF3U39akY+c8ulwsgWTLkLp3TZZmIG2zTu9FJirPGZb+j38tJbA/JLpfoQNPNJjbISJxGzxH4FQf4Y1R+xMap7y7jbYG803vyMpqM0ezFACGTarbmRafxsKkCD7ACEXTmyVaxcSjvj6Cx+r2GKMlhYYJig24xRDLVExe1TQdrh+gbQasC8cvUl5cT5mGKZEfemradkNxIAYSqg9jahnaLbznYimt9oCIbE0SuCN/Y3DDkc6Wg== X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:AS4PR06MB8447.eurprd06.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230040)(376014)(52116014)(366016)(1800799024)(38350700014);DIR:OUT;SFP:1102; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: 4LsmsojS9Z4k0IIXPDvAQIbJe8iKaj9j/zEfqbryfIoI+6++9lWLF5C1EZSAZ7MQjVacD0oir1iRZ524F0giGe6u6IVLuLT3xQIFPTe+l3mXpaGfaU+aTZ6fUP7vWY7Pwm8K11usqsyU90ri4OED58vtOwdI0KQyiSbSJy62Y8Negv3BGW+pn63cr1kluWHj/ZQNm+Qd8hp+E3ORRdaA236l2gp8/HyS0iX+Dzh/iVg1BWNqgkFskXoXmv1ehktarostx9pFI2WUvOYYP+kdFANWyierpdie7w3Hc0n7ccC5Oa6q1R7vA5WtBMLrF6fO7IDciQyQW4NATOAGpyGElhJnvqBarwNVTSYy1b47v38nsgFMeGHW61a7natPcdH+gWxZgY1vCOQAhCsj06eYQHs1zzXbS3O+qDG9A5RYAizZTRhuBE5Ble7RBbi7M99JGwJS+Lvd10grDYUB4i/UUeBllVwGLuktjMs6deIxLtF+zFXY+hJzYlbuy2A440DObQ4WMwWccaxh7LQaiXZbBDIVAdV2iBZQfSJOMs12kgnuCz6gryWCRZaSRkG51x9FirtcOefshIcI775epGhWfgluLYk+DdxGiMy2VLlaEskIwFAaa9HfeEOTPvzba1S9G0GX9RehpeLtpSNVchxWHNgAO5/3TGZAPWGVYaCNqwa5MevRHldw6zF3muzn79+OLiPxm4ILMthvzOFFD9e2KqCsAFJ8/qy8As8PZjzDIofjibhE7HEM2fR2RI6Sa2N3J2NjJtjgNWpOcODEoVjW8vtuYEZ4lKf/JU9DXaxcyYeIryqzhkIoLW6C4qB314/t/yr0tYLFd1Y9S5bfMXnd1X4af92PTx8X704uTcQTkyidiAI9q4pQ4bmW7KQ1IQe6EZyqqf7VZdhqAh2PXbOhF85863RhNaQ9AVD08rVFiNGZZAc5NnwASfcRHNAMQSjC+QkhjkODOhG4M3Ii+4bjZJi54o7drNkHxSSWUnsqe5MmnubSqF3T3/E1qrsYVB4QJm/o9yIfA0hKOipF7fTKRYyi8aaxlZ/iCK+ye/T/DYXpW67hRm7wRtJ+pczhxOBjUEiC8nrQz+FXU88Ch4nwXrFZPzBa7mi965puqmXkj5oPBhbGnSY2aMGGqsgf5jVYwAA97A+UGDMojIwcUahYaupgeHyZusHUfta1Oy5Gk2pOX9GyHynEfk+bBrXkirNrNi4uQevYZWt4NBuxc0orN20ganNwb7w2RqJCrluQ8T5rPyA85Ne4YQTIcKo1NEhTmC5OX02veIZKbKo0AI32zhpfxuhwLNmDQHFRMC0/3dOS0NQcmNUq9GbhQQsX4Rtl1X/4PvFNe8Mgu/SG/GrtqJQzcqVhiXwx6RElYpIEeFvlVu7wP4mA+9dFsI8CiOI8T8gVVB0WfA8tZfjLdD09zSfkLYDEQzFkiweAfZCExrjV/ptGUly3MzdVkRGLJHIbxx8L0x3E+cvLgrRTffoN/7F6FJEHDlTpbIpW/gQLfGnAOC0YrkJoILoKHJoWmCgba+Jo7r3a/gNfmTuIk5Voyb3YBomHItTICl6zDDXg+mQ4pdsj5Q2JCxgPH+UPuKAh6V18OlFt0Z1naXcohR1s7Q== X-OriginatorOrg: vaisala.com X-MS-Exchange-CrossTenant-Network-Message-Id: a531246a-b8d6-4687-39ef-08dcedec3be6 X-MS-Exchange-CrossTenant-AuthSource: AS4PR06MB8447.eurprd06.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 16 Oct 2024 14:10:05.4114 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 6d7393e0-41f5-4c2e-9b12-4c2be5da5c57 X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: pFYf3b7Yuh991rhiuRpUlT2ROYFLpB47iGGNX7VSzbiHTD5Y0vtmZ78vMXkxU0yo3DSQOMkAXTyViGwNaPD7jQ== X-MS-Exchange-Transport-CrossTenantHeadersStamped: GVXPR06MB9178 List-Id: X-Webhook-Received: from li982-79.members.linode.com [45.33.32.79] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 16 Oct 2024 14:10:17 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/5513 The VOLATILE_LOG_DIR variable was removed and it's functionality replaced with a FILESYSTEM_PERMS_TABLES entry in https://git.yoctoproject.org/poky/commit/?id=2f8806deb7655b37d6f8d12ff54680d6acf7a298 ("bitbake.conf: drop VOLATILE_LOG_DIR, use FILESYSTEM_PERMS_TABLES instead") Signed-off-by: Niko Mauno Reviewed-by: Quentin Schulz --- .../migration-guides/migration-5.1.rst | 6 +++ documentation/ref-manual/features.rst | 5 ++- documentation/ref-manual/variables.rst | 40 +++++++++---------- 3 files changed, 27 insertions(+), 24 deletions(-) diff --git a/documentation/migration-guides/migration-5.1.rst b/documentation/migration-guides/migration-5.1.rst index 298ff3e250..2b945f8165 100644 --- a/documentation/migration-guides/migration-5.1.rst +++ b/documentation/migration-guides/migration-5.1.rst @@ -117,6 +117,12 @@ Removed variables The following variables have been removed: +- ``VOLATILE_LOG_DIR``: :term:`FILESYSTEM_PERMS_TABLES` is now used instead. + By default, :term:`FILESYSTEM_PERMS_TABLES` now contains the value + ``files/fs-perms-volatile-log.txt``, which means that volatile log is + enabled. Users can disable the volatile log by removing the value + ``files/fs-perms-volatile-log.txt`` from :term:`FILESYSTEM_PERMS_TABLES`. + .. _migration-5.1-removed-recipes: Removed recipes diff --git a/documentation/ref-manual/features.rst b/documentation/ref-manual/features.rst index b2ba731bb2..6e52dfce17 100644 --- a/documentation/ref-manual/features.rst +++ b/documentation/ref-manual/features.rst @@ -327,8 +327,9 @@ The image features available for all images are: .. note:: - To make the ``/var/log`` directory on the target persistent, use the - :term:`VOLATILE_LOG_DIR` variable by setting it to "no". + To make the ``/var/log`` directory on the target persistent, remove the + ``files/fs-perms-volatile-log.txt`` value from + :term:`FILESYSTEM_PERMS_TABLES`. - *ptest-pkgs:* Installs ptest packages for all ptest-enabled recipes. diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst index 32c9e7407d..c27a0ad7d6 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. :term:`K ` :term:`L ` :term:`M ` :term:`N ` :term:`O ` :term:`P` :term:`R ` :term:`S` :term:`T` -:term:`U ` :term:`V ` +:term:`U ` :term:`V ` :term:`W ` :term:`X ` .. glossary:: @@ -2988,26 +2988,30 @@ system and gives an overview of their function and contents. :ref:`ref-tasks-patch` task as well. :term:`FILESYSTEM_PERMS_TABLES` - Allows you to define your own file permissions settings table as part + Allows you to define your own file permissions settings tables 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. - By default, the OpenEmbedded build system uses the ``fs-perms.txt``, - which is located in the ``meta/files`` folder in the :term:`Source Directory`. - If you create your own file - permissions setting table, you should place it in your layer or the - distro's layer. + By default, the OpenEmbedded build system uses the ``fs-perms.txt`` and + ``fs-perms-volatile-log.txt`` which are located in the ``meta/files`` + folder in the :term:`Source Directory`. If you create your own permission + setting table files, you should place those in your layer. - You define the :term:`FILESYSTEM_PERMS_TABLES` variable in the - ``conf/local.conf`` file, which is found in the :term:`Build Directory`, - to point to your custom ``fs-perms.txt``. You can specify more than a - single file permissions setting table. The paths you specify to these - files must be defined within the :term:`BBPATH` variable. + You can override the value of :term:`FILESYSTEM_PERMS_TABLES` variable + in your distribution configuration file to point to your custom + permission table files. You can specify one or more file permissions + setting tables. The paths that you specify to these files must be defined + within the :term:`BBPATH` variable. - For guidance on how to create your own file permissions settings - table file, examine the existing ``fs-perms.txt``. + In order to disable the volatile log, which is enabled by default, one + can remove the ``files/fs-perms-volatile-log.txt`` value from + ``FILESYSTEM_PERMS_TABLES``. + + For guidance on how to define your own file permissions settings + tables, examine the existing ``fs-perms.txt`` and + ``fs-perms-volatile-log.txt`` files. :term:`FIT_ADDRESS_CELLS` Specifies the value of the ``#address-cells`` value for the @@ -9983,14 +9987,6 @@ system and gives an overview of their function and contents. PACKAGE_INSTALL = "${INITRAMFS_SCRIPTS} ${VIRTUAL-RUNTIME_base-utils} base-passwd" - :term:`VOLATILE_LOG_DIR` - Specifies the persistence of the target's ``/var/log`` directory, - which is used to house postinstall target log files. - - By default, :term:`VOLATILE_LOG_DIR` is set to "yes", which means the - file is not persistent. You can override this setting by setting the - variable to "no" to make the log directory persistent. - :term:`VOLATILE_TMP_DIR` Specifies the persistence of the target's ``/tmp`` directory. From patchwork Wed Oct 16 14:09:40 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Niko Mauno X-Patchwork-Id: 50771 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id 6C649D16272 for ; Wed, 16 Oct 2024 14:10:17 +0000 (UTC) Received: from EUR03-VI1-obe.outbound.protection.outlook.com (EUR03-VI1-obe.outbound.protection.outlook.com [40.107.103.120]) by mx.groups.io with SMTP id smtpd.web11.24245.1729087812141743646 for ; Wed, 16 Oct 2024 07:10:14 -0700 Authentication-Results: mx.groups.io; dkim=fail reason="dkim: body hash did not verify" header.i=@vaisala.com header.s=selector1 header.b=B64LcY5x; spf=permerror, err=parse error for token &{10 18 spf3.vaisala.com}: parse error for token &{10 18 _spf-dc57.sapsf.eu}: limit exceeded (domain: vaisala.com, ip: 40.107.103.120, mailfrom: niko.mauno@vaisala.com) ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=OOVJN2EBxONgc3+dXQSsu6S/YdF4P2yBWxItK4hEkqQ/7mKBw+Taufs+UN9tPb6tSybfYMSUSKM+p2RM7k4UeonMBi82NY9aXlM0ux9yv/+nmwXNCL6SX9KtY51a6kJ3ZvkfWlKWcxa6tDkGmpTLoDrZCz4xIX0PDyaimCBaT5T4bK/kh13f3RNGmYbun1Z3p0GvxVSHylzJG9i8bzpXx1m6v7dll6GtvCCbT+NJ83tJdP4q9z3j6Xa0Dys17OAKO+wESgISboVa3lgR0DoaPsWi7PGz6iedtugcWqGiJEmBOj3ht8D24Z8IoiR2U47w8CQty+XkCVOtSIZEDw4r+w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector10001; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=M5ZFzu/O/Mpt7OqoMsVqxVEFWxR592HnW3CoZ+aWnnA=; b=H85MwS/lzBr7i+7qGJY/xDte/oR+xHbnriyvS82UHcQpfNE5P1794cq2RGOWZ/VXmnCrOTKIU3PXr1YjcOtJ53NSfWjSotldWWbSaPKkLUZEV8WFhjDKM0MTPXELceFB5K3HKeQIaqNSaiEfU/JjtAzsKD9Rh+pQ0Q6ryi8HlO8dr8gtwSNt905oMSfElUsuy/TAHOxqIawP88VEtAnvIuvTLvH8V5j0EFYKwef5DbQCCOLSAA6yqaqdISkNuM7PgWf4ZbDgAenII/d2Us+pdufga1fOO8MBnGsaFeLsLd8BXfSUn2+E6Mz8xACJRxs0Y/s1tMQoJYQzlOkK9Rzd2w== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=vaisala.com; dmarc=pass action=none header.from=vaisala.com; dkim=pass header.d=vaisala.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=vaisala.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=M5ZFzu/O/Mpt7OqoMsVqxVEFWxR592HnW3CoZ+aWnnA=; b=B64LcY5xIeUCUmI2cHgtygM1QG/jUVK4UXfduQXI7mDEi81sHyP9NstcedvsPIrcMiVNSBDSisnRo4DMrtU+FM4RRDorrUKgR4m/IXN8TH0RzYJVt+xD642jyDJ2SXaobDD/ehrC1Yjnx9I/ebqgRkf1oo73qNTYgW8+BeLFN2ZBERJtIeCoYSqCzuY9pWUj9S0o6yExrZniPxtwS8azqiubca+90Rdnfx/llvvWMv9SglXe9toFkCzmNzptk0AROOpjobSBFRjboM3oxMrQ0383j4UPA1vXyhNEXzcqB/yfODvBI0DwQTmE+xjTrakz++WVbgYLCfdN4wOOdFQung== Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=vaisala.com; Received: from AS4PR06MB8447.eurprd06.prod.outlook.com (2603:10a6:20b:4e2::11) by GVXPR06MB9178.eurprd06.prod.outlook.com (2603:10a6:150:1c2::7) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.8069.18; Wed, 16 Oct 2024 14:10:06 +0000 Received: from AS4PR06MB8447.eurprd06.prod.outlook.com ([fe80::af93:b150:b886:b2bc]) by AS4PR06MB8447.eurprd06.prod.outlook.com ([fe80::af93:b150:b886:b2bc%6]) with mapi id 15.20.8048.020; Wed, 16 Oct 2024 14:10:06 +0000 From: Niko Mauno To: docs@lists.yoctoproject.org CC: quentin.schulz@cherry.de, antonin.godard@bootlin.com, Niko Mauno Subject: [PATCHv5 2/2] docs: Replace VOLATILE_TMP_DIR with FILESYSTEM_PERMS_TABLES Date: Wed, 16 Oct 2024 14:09:40 +0000 Message-ID: <20241016140940.3166992-2-niko.mauno@vaisala.com> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20241016140940.3166992-1-niko.mauno@vaisala.com> References: <20241016140940.3166992-1-niko.mauno@vaisala.com> X-ClientProxiedBy: GV3P280CA0054.SWEP280.PROD.OUTLOOK.COM (2603:10a6:150:9::24) To AS4PR06MB8447.eurprd06.prod.outlook.com (2603:10a6:20b:4e2::11) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: AS4PR06MB8447:EE_|GVXPR06MB9178:EE_ X-MS-Office365-Filtering-Correlation-Id: f50dd12a-554b-4a37-c64b-08dcedec3c30 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0;ARA:13230040|376014|52116014|366016|1800799024|38350700014; X-Microsoft-Antispam-Message-Info: tgRgzz1bslqQTWVzka/jBEqMytAZegQq1h8PhxPeeLG5uLJrtlVd6aaMK5Qj/aj3nly74KY4QE+Ql82QNgFGiE6VsSNi5YpdcP6jk4rfHO8hdGFAI43mbvfOypjFK8lPGPGh7YLyAxh2nKN5VJR9k0Z3Vy5osb2bFUO6DJwkFDTSzdrK9rmVjoxK1LVUsoknkXshqcUWhaAtrqSMYemwVCk+dgbN6vJmFHLWXZsnHwDNQhjryKhRPkCdjQ7P4bWHGTFQBbo0ynwMSwKtXCGrZU5kkqxjRldoz3h+77pjD8pMMTHkDS1IJ8a2oEVGJaK/vT4fe97V73WIXKUQKEEwz5t9WqP27lWtazxfHQincFHSr+jaq3X61bGQ7G6bDiJMZ2zflLdAkvjiUZ0/u9y/W3L0Lit9WDLllQ4uoDPWz5sFCdcH4bBMV+7BZr4AiJSeV23/VMA1L4hMzsIF1+fcbjdyI4Mi1BaCfD+vz/Ngh3SJ9gIN5xOhSGu9rHKhItVWM+Hy/1iko0mghQaJQOBM3igNCGsoRWW0rCD6/qxvn8HWg5uKQekFiHjNx2OhkQVkxkaPKbwVz/vOvjemdxFJMFBlcn79X0JFxR3jPGiHlkyy7G9SupQhn+lsDg/ba64hHiLDFG7ggWMoxILTGVJalyv/RBW4NAJJhvO/E8p0KgefRhLX7b7flW4lJwBP1jq/f9XjuXxGcP0pZuxvBGQvt3AzIh5c6DCVPvzzp24sf8QhGgOdXNEPB8WkKLqlfAlk/NlqyiKMlVhJqljXNOPdnVoHt0T+raNVEXB5ZOpVHqm2aRtSyhKnWXAhzcwemgqaZBQcDIGM0ukqstB+GWIRDnDCuLTr1FLEKstJFJjjQUYbSHHzWY8+3nAFxPSEWekkKP0c9okWXEXuFLPayVfMCfPRq17kjG+72EyflXHen+QKIeyFRhtOCmrNVip2gUtf11zIXuYqlfE3js9DNi9+7WaFmUBTeJssHFIrt0Pr461LZLEYOu93OVCWwdY3PeTwiXp5sOPjIsNuUG/Bwc+mM+3tuSiFz2a8bdVZHb0444Q/3AVlLvj0k20XaKhFJhRuu18XGbXLt5lPLiL6nedC7eU/OxG7UIR2LAGkXQ35SzdsVtRksG8zTStJZ1RdrBwhWENL9WE8J5Ygaj7X5wdO+y4JLIMiDI0QbUfT8RZW9E03I6JhrSh8cHWsi6nOKxsrFdwRUjXtEUIGnfsh5K3ttkZQ7Q+uqLKiULXLhlm+/HYIadT4z3z81Juy6u07yuSZ2GCZgJVW90z3xrKdjKhaEA== X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:AS4PR06MB8447.eurprd06.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230040)(376014)(52116014)(366016)(1800799024)(38350700014);DIR:OUT;SFP:1102; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: SZ6pdHvxoYfXzymxmsdFSm5o/zxRfICSHBsv3BIFgEDen2F+JTroOH7sg2SoXJ8wE1oQZ0ZDsieBXyvYzfgTnVwakRj/3O1xkTDPlPgL1fZOzhC0F3ikFwMAAYUYqPAgwKziX8lhIWl+FtydBlLaFNTAb5Jfrc257BtunSgLRFZ20KqAJrh8LzqP/cbLI1Nz2vBIdY7MBHq6KP7KWApYgptNonuBIRwJvECbgYdQF91C74Y5kRalf/kBm88bytEPoiOGVhSRMaJtI5QzwGoirexhGl42IT6pSEhN8d99puQ5mhOeVYWhp/ivYC5J2iL3Bsi4iorTKuclDWA4tYLi0FD1Lf00K64Vm/LQ/UyChLO0Hb6Cd2UoshC/SgXcAd7ZPLnG8BCxC78Dewm6D/blnlfdo4Op5nNI/1JKt30lThdTauVk2TReHfvNRUQgEd04QEry5xAcrlImRW8FmfZZu73xN0h70QHd61avSTHZER1rkUB4XFJPZfv+KA2bjsMZ4Lq+EQWj/dtw0//eLmTFG6iBBxSPsZ+2+qQrZWxFz5yejhKLhQ8atldB2kFoQ047KVlvTZEtrwVEfcFJ+WPyrk4QyEDDzmBAKCQ9CuQYkpYd0x5h0UOoEyPq3SZieFeBVK6laV8Gqv8ByhbIzSuG1wSZ9Z9czv4nCHB2QSqRa8K0NJtk5gbrYX7/0/yvB/seHA3zmlY7lFz0dwOPd16IrFfKwG89XczMVxgvyPWUiWzI9QOe19jOqmD25zcqyg001rcKnl1p49WGq58DRwx0YHzUOTYfwemEZycaERbitm5Uijor0CwxosJ0cIgwcy+DBEkLSY1iNCAOikDrk+P3oNjA9015+MdE6a8S1b0lbalrqjAR7Jy7h0scRSTdF46BtqOiB2MmVvQDhv95S9Vyf40iu9J8xxsVj2YOxVknVKLvGY5E6wfT58/cmyWE/p6J/UdGX2dC++Wy9XC/I4IdlYMA8u1qLnMrz/b55Sk/2Kv37YmAqbc3kmGtl+d5or1jKuNDhXVgEumkoyT0Ea5d0XMCdmsGaZS5tIFEBY+vKEcGIrAHPxAh97lPdvUDljR//yvs8F+labVSZjC95qpeshrX20cQquLQUInfjmGXd1+J2aZhKhVlGaRdrNGsyM//EsYBIuQSE04Kr+eMdvADftJaRnzFlLr84Bamq+qwkXwyqZsZk+ha8OLMbV78rrEi1Wy7FA2gaPt4iWOpLoWzuiRXQ829iPHY53VAl1xcuzW1GLcuLhQGKB3EeGgjN+OJ2lEzeoBWxv1bR7PYWILyhD+w515pTlR6cKAu1T0DKC8etrJwCT6vdBZx8JeTKk5Ampk06mR/KYMPGMvFMTGhcY9vsoewBVFlzGzTl6bMP1VgvDH8QYdkhFPh4e+s1Q6fJQKoavW8xUxJdHf0/5nPWrMTY7ogWK1O6Faw5TVBBlZ97Qud2wQVgGN5ZPQsbpib1UpsHlISU0HpQsNyXsUn08QVMiJP/Cw9jDWOTXmp6WdMciFgFMtV6kx6US6Iou2wXgSz4eJAwIFBZd6oKVPi1ByP+PjvxljcPvxomT6/GV4VGYuPWpxdiArdzKsd7PghIvKVyKSpyay/1b5Rdu5shg== X-OriginatorOrg: vaisala.com X-MS-Exchange-CrossTenant-Network-Message-Id: f50dd12a-554b-4a37-c64b-08dcedec3c30 X-MS-Exchange-CrossTenant-AuthSource: AS4PR06MB8447.eurprd06.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 16 Oct 2024 14:10:05.8544 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 6d7393e0-41f5-4c2e-9b12-4c2be5da5c57 X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: NrHLtKziEV7BIFGmiWtDJNvHZxN0snzBRf/FMwxNvWndSBah2VyLNRR68n/75ux9ZcafV52aSPA02Nftw8NsKQ== X-MS-Exchange-Transport-CrossTenantHeadersStamped: GVXPR06MB9178 List-Id: X-Webhook-Received: from li982-79.members.linode.com [45.33.32.79] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Wed, 16 Oct 2024 14:10:17 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/5514 The VOLATILE_TMP_DIR variable was removed and it's functionality replaced with a FILESYSTEM_PERMS_TABLES entry in https://git.yoctoproject.org/poky/commit/?id=2f46b6f27dfa3a9d5ad177900fcecfe64c3536f1 ("bitbake.conf: drop VOLATILE_TMP_DIR, use FILESYSTEM_PERMS_TABLES instead") Signed-off-by: Niko Mauno Reviewed-by: Quentin Schulz --- .../migration-guides/migration-5.1.rst | 6 ++++ .../migration-guides/release-notes-4.2.rst | 2 +- documentation/ref-manual/variables.rst | 28 ++++++------------- 3 files changed, 16 insertions(+), 20 deletions(-) diff --git a/documentation/migration-guides/migration-5.1.rst b/documentation/migration-guides/migration-5.1.rst index 2b945f8165..7d6c976cd8 100644 --- a/documentation/migration-guides/migration-5.1.rst +++ b/documentation/migration-guides/migration-5.1.rst @@ -123,6 +123,12 @@ The following variables have been removed: enabled. Users can disable the volatile log by removing the value ``files/fs-perms-volatile-log.txt`` from :term:`FILESYSTEM_PERMS_TABLES`. +- ``VOLATILE_TMP_DIR``: :term:`FILESYSTEM_PERMS_TABLES` is now used instead. + By default, :term:`FILESYSTEM_PERMS_TABLES` now contains the value + ``files/fs-perms-volatile-tmp.txt``, which means that volatile tmp is + enabled. Users can disable the volatile tmp by removing the value + ``files/fs-perms-volatile-tmp.txt`` from :term:`FILESYSTEM_PERMS_TABLES`. + .. _migration-5.1-removed-recipes: Removed recipes diff --git a/documentation/migration-guides/release-notes-4.2.rst b/documentation/migration-guides/release-notes-4.2.rst index 30049b89f6..ee81d8367a 100644 --- a/documentation/migration-guides/release-notes-4.2.rst +++ b/documentation/migration-guides/release-notes-4.2.rst @@ -38,7 +38,7 @@ New Features / Enhancements in 4.2 - New variables: - - :term:`VOLATILE_TMP_DIR` allows to specify + - ``VOLATILE_TMP_DIR`` allows to specify whether ``/tmp`` should be on persistent storage or in RAM. diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst index c27a0ad7d6..f66c1bb497 100644 --- a/documentation/ref-manual/variables.rst +++ b/documentation/ref-manual/variables.rst @@ -2994,10 +2994,11 @@ system and gives an overview of their function and contents. and users across an entire work project. It is best to do this in the packages themselves but this is not always possible. - By default, the OpenEmbedded build system uses the ``fs-perms.txt`` and - ``fs-perms-volatile-log.txt`` which are located in the ``meta/files`` - folder in the :term:`Source Directory`. If you create your own permission - setting table files, you should place those in your layer. + By default, the OpenEmbedded build system uses the ``fs-perms.txt``, + ``fs-perms-volatile-log.txt`` and ``fs-perms-volatile-tmp.txt`` which are + located in the ``meta/files`` folder in the :term:`Source Directory`. If + you create your own permission setting table files, you should place + those in your layer. You can override the value of :term:`FILESYSTEM_PERMS_TABLES` variable in your distribution configuration file to point to your custom @@ -3007,11 +3008,12 @@ system and gives an overview of their function and contents. In order to disable the volatile log, which is enabled by default, one can remove the ``files/fs-perms-volatile-log.txt`` value from - ``FILESYSTEM_PERMS_TABLES``. + ``FILESYSTEM_PERMS_TABLES``. Similarly, in order to disable the volatile + tmp, one can remove the ``files/fs-perms-volatile-tmp.txt`` value. For guidance on how to define your own file permissions settings - tables, examine the existing ``fs-perms.txt`` and - ``fs-perms-volatile-log.txt`` files. + tables, examine the existing ``fs-perms.txt``, + ``fs-perms-volatile-log.txt`` and ``fs-perms-volatile-tmp.txt`` files. :term:`FIT_ADDRESS_CELLS` Specifies the value of the ``#address-cells`` value for the @@ -9987,18 +9989,6 @@ system and gives an overview of their function and contents. PACKAGE_INSTALL = "${INITRAMFS_SCRIPTS} ${VIRTUAL-RUNTIME_base-utils} base-passwd" - :term:`VOLATILE_TMP_DIR` - Specifies the persistence of the target's ``/tmp`` directory. - - By default, :term:`VOLATILE_TMP_DIR` is set to "yes", in which case - ``/tmp`` links to a directory which resides in RAM in a ``tmpfs`` - filesystem. - - If instead, you want the ``/tmp`` directory to be persistent, set the - variable to "no" to make it a regular directory in the root filesystem. - - This supports both sysvinit and systemd based systems. - :term:`WARN_QA` Specifies the quality assurance checks whose failures are reported as warnings by the OpenEmbedded build system. You set this variable in