From mboxrd@z Thu Jan 1 00:00:00 1970 X-GM-THRID: 7067458074287538176 X-Received: by 2002:a05:6a00:2182:b0:4e1:a254:668 with SMTP id h2-20020a056a00218200b004e1a2540668mr23645434pfi.73.1645520812395; Tue, 22 Feb 2022 01:06:52 -0800 (PST) X-BeenThere: isar-users@googlegroups.com Received: by 2002:a65:644f:0:b0:374:5e1a:d7cb with SMTP id s15-20020a65644f000000b003745e1ad7cbls1447644pgv.8.gmail; Tue, 22 Feb 2022 01:06:51 -0800 (PST) X-Google-Smtp-Source: ABdhPJxo2yOACAaS5QwMTpzVE3pNQq8qYAhs8uOnCHPwjLd87H+UFTenLntAI1octmQLamrF8DYh X-Received: by 2002:a63:c22:0:b0:373:3d5b:ee98 with SMTP id b34-20020a630c22000000b003733d5bee98mr18746908pgl.252.1645520811632; Tue, 22 Feb 2022 01:06:51 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1645520811; cv=pass; d=google.com; s=arc-20160816; b=ZOHktMHw49OMkmBoSrlPe8WLbls8ZXAAZHYYA1tDzXVQtgUtaj9lFU66tBkGEBShgH DzMrq1r8D0+PLjrrdJtmFyfdA9vl9OcJkBGEiw6bsIeSm988zBghFXe8ITFKuxzG+twC xV3t+z8jK7dIfuFUZdPdWMVlern/IE9QYsZy/0hNLrNfRDMVu1mYg1Pg3jehjdhJ1/e1 9edzDT1ZFOnuKl7M40QDZFuC0QlZP8zb/+8YFmdWVMgckXrO5yGt0tbYYN82gHOCmFm4 dywaec0AtkCeJmxehPTSkwKhJwp/y98zTK0+/WVzJAbA5KV4KqRSacKpWitAOrJfSOp0 tJRA== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:dkim-signature; bh=YfFNcohul7jTuWQrkO/hrQMYQgoYlxF5PxCWvdDFE1A=; b=kYnXOHNnhNLYy/lmj2mb/xlDIqLZvZdpnxpx/6BDMsyH4k3w/YIT6CR8K/HRxHIPvN l41GGPn3b6zfqFAW3H6UpZAtNK14wVl4y78avUPnjZGDGt4pimM5LixEImlKMLmfX9nM EqISDLmPfKKfa8TYwpxAdcTHllM+Z8TRzNBbC1RJUwyw7p6Aq6pGx0IhgzRcVg9VLkqe V7FASWMPm7+uBjcRk66ip+GgsXlmlJtgjT2bGXITUVoB5rTvEMFbNT3eTR+CTjo70xUQ GOidVmnJOJ0/vocgLhZ98qP/Vxtx27OZS2QJnx73pSHSu6CEODJ8k+ltFeF4Jw9vRM/m ibIg== ARC-Authentication-Results: i=2; gmr-mx.google.com; dkim=pass header.i=@siemens.com header.s=selector2 header.b="r/bFhJJ5"; arc=pass (i=1 spf=pass spfdomain=siemens.com dmarc=pass fromdomain=siemens.com); spf=pass (google.com: domain of adriaan.schmidt@siemens.com designates 2a01:111:f400:fe0c::602 as permitted sender) smtp.mailfrom=adriaan.schmidt@siemens.com; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=siemens.com Return-Path: Received: from EUR04-DB3-obe.outbound.protection.outlook.com (mail-db3eur04on0602.outbound.protection.outlook.com. [2a01:111:f400:fe0c::602]) by gmr-mx.google.com with ESMTPS id t10si1017333pld.11.2022.02.22.01.06.51 for (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Tue, 22 Feb 2022 01:06:51 -0800 (PST) Received-SPF: pass (google.com: domain of adriaan.schmidt@siemens.com designates 2a01:111:f400:fe0c::602 as permitted sender) client-ip=2a01:111:f400:fe0c::602; Authentication-Results: gmr-mx.google.com; dkim=pass header.i=@siemens.com header.s=selector2 header.b="r/bFhJJ5"; arc=pass (i=1 spf=pass spfdomain=siemens.com dmarc=pass fromdomain=siemens.com); spf=pass (google.com: domain of adriaan.schmidt@siemens.com designates 2a01:111:f400:fe0c::602 as permitted sender) smtp.mailfrom=adriaan.schmidt@siemens.com; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=siemens.com ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=lJuXVfLmNscAT+SXCBHq5gzlzPc/D7VO4ASO3SsJYm2STXvwUpq8mi0NB2ehEGl9B4+id27hAEXzsk0go3XhZ2Kk+3xn9n46lXGYG1xscotxXGjX9Eb1wUZu6ZrHzLyEgds4T9ID8WbkMZXvDiiyep1mjuQcEdtpRDKeSa/CIZZZ1uD+yGqx4IApGKW0MgKYvxKvGXpqIFlPkBBX3dCQgRT1lMePiVv+YTVul2SxU7igg/geWkxs9EfvMWeBHnEEmGusiMcF7S+UJZb1ZzK3sPYSkWzZzkoaURdRaQShV7UfpnIY4kV9tW077upj8q+3inyCEr5XRA1zazRIIALAOQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; 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=YfFNcohul7jTuWQrkO/hrQMYQgoYlxF5PxCWvdDFE1A=; b=YIirDPaY70qRI2sIDWqwNJ7dcXX6Kcv8S2w+WFtcMj3ZOfMq+Faq28jWIKjVhUwyVtgjq4Fs/jXI9hZd96UeJ8sC+i3i+NWamjb8BRZg+T96X2Xlt5YYB2fbG/0aQznAK0NLHLaz3VmovCp/bPORshYOgqCR5VTJpKSXelUoaGXmfUidRtM8EWsZapX6yBdweCfJReG6HWOTLi3r5BCjdZOu4dfQW1QOyxG6h4ZcGTM4qkH8vR1fmytRvIhgNMJKzw2jxuOW4AkaOFEmY820s+pOIqL0VW6VcQa8L1ahHQAEOvjb+9DdLf+ndXocx4wfmVVq2kt5ZvtimuDh6dgFUg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 194.138.21.72) smtp.rcpttodomain=googlegroups.com smtp.mailfrom=siemens.com; dmarc=pass (p=none sp=none pct=100) action=none header.from=siemens.com; dkim=none (message not signed); arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=siemens.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=YfFNcohul7jTuWQrkO/hrQMYQgoYlxF5PxCWvdDFE1A=; b=r/bFhJJ5I/bhu+rOfd0U6H4mOg+hYxVanvEEr+qx5jcjp7gjfUctbu+5NpTWr0qS1ln6pzA/Vxfmybq1ZUjPHR13a21ryyiI0M+eQEuAuOrk9C16nJtEPI8yxOw6q4gyQ5apzMPLT54sLtNjFgwCgwdy/muclNSEKh7cu8xqK1OzAXDYAoMSJvbnERO5nKfSj+GR8yZq/LdZvk9CST391PDCDFk3R+ej6+1NCBMElI1jAWNmCWWd1+yYXlH2RXdrNL5T968al6lR2GoP7Oc+SxrPkFUazr8Y0NB8OvUtJN2BrCcMeyi1t/a6IQbCK/XAgW+buViD3/RpTApC9tLIcQ== Received: from AS8PR05CA0017.eurprd05.prod.outlook.com (2603:10a6:20b:311::22) by AM5PR1001MB1041.EURPRD10.PROD.OUTLOOK.COM (2603:10a6:203:13::12) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4995.16; Tue, 22 Feb 2022 09:06:49 +0000 Received: from VE1EUR01FT025.eop-EUR01.prod.protection.outlook.com (2603:10a6:20b:311:cafe::76) by AS8PR05CA0017.outlook.office365.com (2603:10a6:20b:311::22) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4995.27 via Frontend Transport; Tue, 22 Feb 2022 09:06:49 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 194.138.21.72) smtp.mailfrom=siemens.com; dkim=none (message not signed) header.d=none;dmarc=pass action=none header.from=siemens.com; Received-SPF: Pass (protection.outlook.com: domain of siemens.com designates 194.138.21.72 as permitted sender) receiver=protection.outlook.com; client-ip=194.138.21.72; helo=hybrid.siemens.com; Received: from hybrid.siemens.com (194.138.21.72) by VE1EUR01FT025.mail.protection.outlook.com (10.152.2.232) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.20.4995.20 via Frontend Transport; Tue, 22 Feb 2022 09:06:49 +0000 Received: from DEMCHDC8A0A.ad011.siemens.net (139.25.226.106) by DEMCHDC9SMA.ad011.siemens.net (194.138.21.72) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2375.18; Tue, 22 Feb 2022 10:06:48 +0100 Received: from random.ppmd.siemens.net (139.25.68.25) by DEMCHDC8A0A.ad011.siemens.net (139.25.226.106) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2375.18; Tue, 22 Feb 2022 10:06:48 +0100 From: Adriaan Schmidt To: CC: Adriaan Schmidt Subject: [PATCH v2 3/3] doc: add sstate to user manual Date: Tue, 22 Feb 2022 10:06:28 +0100 Message-ID: <20220222090628.2174022-4-adriaan.schmidt@siemens.com> X-Mailer: git-send-email 2.30.2 In-Reply-To: <20220222090628.2174022-1-adriaan.schmidt@siemens.com> References: <20220222090628.2174022-1-adriaan.schmidt@siemens.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Content-Type: text/plain Return-Path: adriaan.schmidt@siemens.com X-Originating-IP: [139.25.68.25] X-ClientProxiedBy: DEMCHDC89YA.ad011.siemens.net (139.25.226.104) To DEMCHDC8A0A.ad011.siemens.net (139.25.226.106) X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: c1bde162-07de-40b7-4c6d-08d9f5e2a8ee X-MS-TrafficTypeDiagnostic: AM5PR1001MB1041:EE_ X-Microsoft-Antispam-PRVS: X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: zF3TZ6Jp7T9Aqz57BktWc4GZClhowqXpAmh7iSvGM2Bt/N8g+Ies6/kCXOObDslHch0Yf4ZKlphsHzHkHH487nT9ghDVge4VzGnllNoy9EZbiK3ecS0GPAleyvEqDmlsiuaCBofGg8BmDm+xkB290YzihsCX7z4aeaKSsrSd7UneDquc1s27vLOdRdfq3BUCj/wbly1Zq8jMsPblm0kOB3EwkBNJ9gGZ1+aFAY9UYV4etkx5mPuu3sdh4wugaPgdlOSI3qDNLp3xrvUNxQecENXm7tq9cyNR5U3S3qvmerQfRBUwN0SvZj78BLTwuJ6Fd1A/aHCbTa6+7vs5Fe91ztRm7a0zn3HK8TQ5ydSdh1GkgwMnuJvgojC/N+pIOkFoH5BpsrtLqwe6iW/PKav9w00bmxINyHta85Ra/OcQDEDGU126I8iO+Ycx2gO5WIO2h+ECRRvNqreTPtbYkQEdzGh/T2vJhOK250IVjKGxIIaKIUlsINxeqzTIvbJ/f2xHYP/nbsWbd8axV+fQYY1zejrzhYfHmaKBDZv7JKHyf7+cMh+4jh7jY11Y8panvqrWZw/nWOmHWVneNMZHep6OBY4gIkAzCCBi3HJW+bYGaelYgRgyZTE3swg4zD9I+ETAo/ro7wVUDucbvAYcCB7dpYHR6sbTElG7cwRT8jnzMU9hYI0ouQN9txEM30bi5WC7DfwpkGNbAv7kEPCX8QPZ8Q== X-Forefront-Antispam-Report: CIP:194.138.21.72;CTRY:DE;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:hybrid.siemens.com;PTR:InfoDomainNonexistent;CAT:NONE;SFS:(13230001)(4636009)(40470700004)(36840700001)(46966006)(1076003)(82960400001)(8936002)(6916009)(107886003)(2616005)(956004)(5660300002)(82310400004)(86362001)(508600001)(316002)(6666004)(4326008)(8676002)(36756003)(336012)(70206006)(40460700003)(47076005)(36860700001)(70586007)(2906002)(16526019)(81166007)(26005)(44832011)(356005)(83380400001)(186003)(36900700001);DIR:OUT;SFP:1101; X-OriginatorOrg: siemens.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 22 Feb 2022 09:06:49.4685 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: c1bde162-07de-40b7-4c6d-08d9f5e2a8ee X-MS-Exchange-CrossTenant-Id: 38ae3bcd-9579-4fd4-adda-b42e1495d55a X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=38ae3bcd-9579-4fd4-adda-b42e1495d55a;Ip=[194.138.21.72];Helo=[hybrid.siemens.com] X-MS-Exchange-CrossTenant-AuthSource: VE1EUR01FT025.eop-EUR01.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM5PR1001MB1041 X-TUID: pmEc6/38Vdmx Signed-off-by: Adriaan Schmidt --- doc/user_manual.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/doc/user_manual.md b/doc/user_manual.md index 19db884f..466bf8ed 100644 --- a/doc/user_manual.md +++ b/doc/user_manual.md @@ -20,6 +20,7 @@ Copyright (C) 2016-2019, ilbers GmbH - [Build statistics collection](#build-statistics-collection) - [Enabling Cross-compilation](#isar-cross-compilation) - [Using ccache for custom packages](#using-ccache-for-custom-packages) + - [Using sstate-cache](#using-sstate-cache) - [Create an ISAR SDK root filesystem](#create-an-isar-sdk-root-filesystem) - [Create a containerized Isar SDK root filesystem](#create-a-containerized-isar-sdk-root-filesystem) - [Creation of local apt repo caching upstream Debian packages](#creation-of-local-apt-repo-caching-upstream-debian-packages) @@ -972,6 +973,29 @@ adjusted by `CCACHE_TOP_DIR` variable in `local.conf`. Ccache directory that means caches for different distros and architectures are not overlapped. +## Using sstate-cache + +Isar supports caching of bitbake task artifacts using the sstate-cache +feature known from OpenEmbedded. Isar caches + + * the Debian bootstrap (`isar-bootstrap` recipe) + * Debian packages (built with the `dpkg` or `dpkg-raw` classes) + * root file systems (buildchroot and image rootfs) + +The location of the sstate-cache is controlled by the variable `SSTATE_DIR` +and defaults to `${TMPDIR}/sstate-cache`. + +Note that cached rootfs artifacts (bootstrap and buildchroot) have a limited +"lifetime": Isar updates their package lists for the upstream package sources +only once, when they are initially created. So as packages on the upstream +mirrors change, those lists will be out-of-date and the rootfs becomes useless. +To avoid this, it is recommended to regularly delete the contents of the +sstate-cache. + +To build without using any sstate caching, you can use the bitbake argument +`--no-setscene`. + + ## Create an ISAR SDK root filesystem ### Motivation -- 2.30.2