From mboxrd@z Thu Jan 1 00:00:00 1970 X-GM-THRID: 7044859904479199232 X-Received: by 2002:a17:90b:33c4:: with SMTP id lk4mr2520680pjb.107.1640259268897; Thu, 23 Dec 2021 03:34:28 -0800 (PST) X-BeenThere: isar-users@googlegroups.com Received: by 2002:a17:90b:1902:: with SMTP id mp2ls1708790pjb.2.gmail; Thu, 23 Dec 2021 03:34:28 -0800 (PST) X-Google-Smtp-Source: ABdhPJyRvtEupDM0sJC+D8DstmWK12igjJO71kEZvXtN/f1MMSAT8jUgHM6AxhohDMVM13P5qCgc X-Received: by 2002:a17:90b:1c8d:: with SMTP id oo13mr2235546pjb.239.1640259268128; Thu, 23 Dec 2021 03:34:28 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1640259268; cv=pass; d=google.com; s=arc-20160816; b=ss5QFLDwj7wmpVI7S9Fvd4PzqloZI4G6zB7fKooCsx2xTAz8DrWGCTXbEP7rABQFU8 gUxlaMC7cUxX4fylzHMHcy522gy60tuqxMaJqttuMJWOyYwSak7b5nDRopca/VrEeKbC z1HvQ7C5EqRFe4M7OEAoCh0ZSrflhXvdM7PY9rPNtRCYqSq6b0ov7OhiTWDsrugA0aRd EWawWwRoIN1K5z/UWgwmqJIZoWGsI+neRR3utJB0AuykRtcFycg0gBdrklP9krugKAOP OHYQtEA+W3YaLmJDpAg9OfRWFp8DpsvpC5jYGXhwP+3TRQcAcnzA8RDdjDheYzDkQKiW J9Hw== 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=K0UPzVtZRvgU52vQj632Ebp0YjcFjXVuhBJ3YEPwZqM=; b=pxMMEj7lfetRAdi3Up4AYW6n0s+UPE4yKrtsz1U5LRL1Mht9uwHmeDusAjddEMhJJ2 mNCAaQ6DjqjwPhu3BRYxqRiUCq6mDs1T6kG9bubui1J9O3zKrZ1m2gCaYSR1ILtKn0s4 I3i48ncnN8rjYBXBHyuhN9ieF27DM1AqCNstV0WW1wT2tAqbC44GeCWtb4fNzpozi/VO 4jkumn+csiC+1X2ZoXzlfnny9jYvyqpC+l0EAhjxZ8Y98iV+XALCU/So7KGEQjZwJcAv TzlXvxlnWZbAD+LTxhMwVBhEMt8iRFZ+wwF5B1b5GU7Hytj94l2NMouAUxDNorAH/Ovd VexQ== ARC-Authentication-Results: i=2; gmr-mx.google.com; dkim=pass header.i=@siemens.com header.s=selector2 header.b=RsY6Se+4; 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 40.107.6.61 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-eopbgr60061.outbound.protection.outlook.com. [40.107.6.61]) by gmr-mx.google.com with ESMTPS id o16si266999pgu.5.2021.12.23.03.34.27 for (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Thu, 23 Dec 2021 03:34:28 -0800 (PST) Received-SPF: pass (google.com: domain of adriaan.schmidt@siemens.com designates 40.107.6.61 as permitted sender) client-ip=40.107.6.61; Authentication-Results: gmr-mx.google.com; dkim=pass header.i=@siemens.com header.s=selector2 header.b=RsY6Se+4; 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 40.107.6.61 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=eFo19HeDkgzWHjjHcz7uVfz98XiAZF64RtOH/meSUyTslzEiJbW6Hro3wacZq8qeUxcOhoM1NTcsrrD4DllduFntVgoM7sgqhPE4ABU14SZ6KtOX7ze7xWhmBPNcysDLLNqshptgrsJPP7wbg1GFHK27SAUwLvThRREhQnUboEVkv+d1u+PcBUddEq1uKE8f7JpwwRO3vqomvnxis7CdIGeguI4HFb644hVazt1JgQ8DCsJgj8eFaC6MGeFmzLH3kU6MUHHKH1D62MRBHnPAf5hPspG9IPbmoiBPn7Noe0ZZpRLa41iTv+ywId70uGqzRSeFChI0WqrVmjlIje2jwA== 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=K0UPzVtZRvgU52vQj632Ebp0YjcFjXVuhBJ3YEPwZqM=; b=foh/X1TMmSWUXGBfIIHYWpGUEnc8gLJUMgF55dCa1XEm6Z++hezlBZ2gBQ4KYTLLAIjFTZpAuXvKlM0IdEH1PW0RiMgCcev76IrPo+qQz63hxNGohTIzmc4fr1xwSufLJYrv+/Ax00Wv3U8OOW9pFqXDL/kMPHCD8ChfReAkEuwwOfirL6g2vDxK6ahlQJkoPxjW3YNPuf91+U3WRdzL3TVuVHTQ6PX4jiVoYlAXA+7rstZd+TscLf3rHKiFQJZV5MJFXaEFnTS99dGJEUVTFbkSfLLnurZzThLyR0P26RrjmkQg2JmZDEiarWp2k2SzoKwyGebGnQgQKL9ZpiIZFQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 194.138.21.71) 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=K0UPzVtZRvgU52vQj632Ebp0YjcFjXVuhBJ3YEPwZqM=; b=RsY6Se+41gC0HoFeTkrXCPJ9+IComxc2q4kibboSBKk4Xv1uVCW9Cw/JNnKiaxtRJcNMlhblGP2E2rfMvteQjbZKjo3QoTid4H5aFVfbnTYqJIv8gWux/ro2YBNCMZDaGa7zmfmW832hHVUcrLH6pjN2egitYS5zIJ0bYQ/VgJgji6ICQ1MoqHACNwsVqhrv9b+NlQDUUQAwYEtNkJHnn4RJU7YDpwbGBYUKPojwlnm9as4REFyLa/XpqyiFOaZsPuxkR2Aa2JIw7KJLxNMInTZW8PkgK2jtb5gO3WOZCFVF+HdfuQ8HMAvOCW0gLF0omqFpMTs7TjiVOP7TJCMu8w== Received: from OL1P279CA0061.NORP279.PROD.OUTLOOK.COM (2603:10a6:e10:15::12) by PRAPR10MB5226.EURPRD10.PROD.OUTLOOK.COM (2603:10a6:102:29e::12) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4690.27; Thu, 23 Dec 2021 11:34:25 +0000 Received: from HE1EUR01FT011.eop-EUR01.prod.protection.outlook.com (2603:10a6:e10:15:cafe::c8) by OL1P279CA0061.outlook.office365.com (2603:10a6:e10:15::12) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4823.19 via Frontend Transport; Thu, 23 Dec 2021 11:34:25 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 194.138.21.71) 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.71 as permitted sender) receiver=protection.outlook.com; client-ip=194.138.21.71; helo=hybrid.siemens.com; Received: from hybrid.siemens.com (194.138.21.71) by HE1EUR01FT011.mail.protection.outlook.com (10.152.0.173) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.20.4823.18 via Frontend Transport; Thu, 23 Dec 2021 11:34:25 +0000 Received: from DEMCHDC89XA.ad011.siemens.net (139.25.226.103) by DEMCHDC9SKA.ad011.siemens.net (194.138.21.71) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2375.17; Thu, 23 Dec 2021 12:34:24 +0100 Received: from random.ppmd.siemens.net (139.25.68.25) by DEMCHDC89XA.ad011.siemens.net (139.25.226.103) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2375.17; Thu, 23 Dec 2021 12:34:23 +0100 From: Adriaan Schmidt To: CC: Adriaan Schmidt Subject: [PATCH 3/3] doc: add sstate to user manual Date: Thu, 23 Dec 2021 12:34:00 +0100 Message-ID: <20211223113400.1123555-4-adriaan.schmidt@siemens.com> X-Mailer: git-send-email 2.30.2 In-Reply-To: <20211223113400.1123555-1-adriaan.schmidt@siemens.com> References: <20211223113400.1123555-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: DEMCHDC8A1A.ad011.siemens.net (139.25.226.107) To DEMCHDC89XA.ad011.siemens.net (139.25.226.103) X-TM-AS-Product-Ver: SMEX-14.0.0.3080-8.6.1018-26606.007 X-TM-AS-Result: No-10--10.164200-8.000000 X-TMASE-MatchedRID: M2CyqqihYTIgAYH44ZdoNo9CL1e45ag4utnW9DLdQ8h9Na8belcvhG4l czE4XkmwhrrEcugeVJPR80xPSa2suaaS2YN47GCYsRS44XMgqPrnOtXIf6BS1bSkeRV328rMElL H7tCb90otg96xGBa1q/eGVS7POldJNt3cEh3cGYid94L3lBAAHNvprf1Nq9DgX3+/a8z3dZjYUD vAr2Y/1yhbZduLiFfbhSUmXGVMhP6ShFqzNoN87K/SM4qdTxogzAL4JlR4Eeerm7DrUlmNkIAy6 p60ZV62Mhe627A+8aHdB/CxWTRRu92KvEVWmYr12BxWyENl/5Gt++UTH7zlroHQVxOmD2D8h+im etJfBdA0sueOeS9mYg== X-TM-AS-User-Approved-Sender: No X-TM-AS-User-Blocked-Sender: No X-TMASE-Result: 10--10.164200-8.000000 X-TMASE-Version: SMEX-14.0.0.3080-8.6.1018-26606.007 X-TM-SNTS-SMTP: 899DFF28DAB08710D98CAF1D8D299D2BD3957F0F97B66A2B47B03A96045BAC462000:8 X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 9168b086-0d5c-4421-c8ac-08d9c6082c63 X-MS-TrafficTypeDiagnostic: PRAPR10MB5226: X-Microsoft-Antispam-PRVS: X-MS-Oob-TLC-OOBClassifiers: OLM:8882; X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: 1zrYhHQRqrbOQ02gLMTyGEICg1/h9NlfEocR9wJ8D59GYF0+J0N2+vcFLT08L/ZvhY9BNV5Ifh3O5lItfOKyNkKRDjoHEVv+djwpNUYA3Xgy7z3h2T2jFs9hdITpm69/wW2qo43hADxinuQajnhXvJOyQgfBgPKPZOGTJr1xM8og5gv7IIdpKqbl9NwxZfKguWsbsKRJ9ya4V+TNM1k+KbG+SWbkVkTAkOkkmt7s26aY9ze/8c9khG95/j8npBwqFsKCma3UEYYZU2GZ6iNbIiO9Jhnl4qnCgNfUfuDlxuduyFPYuGirTypMercpbLLH4vK2xarywzm2BM1Z3W0O8wcnqL7o7OVsBJ+q0F4GbtVIaVKkcxJLsQOC7Wh05cQ0soQdjvTdlAztxPvVC2hzN1aAUgzQDCHAOmbuclimbTtAWwRSpEC5XLm8AIrvIIC3+PqpItcgwEV2RP98MzHeM7lP4fGj6vStsKbGThurl6iUkXeoh9HJR2teK4qLPgK0h77XxWw3x+wX4Fiv8KKtg44sUjO/eqq8FbIlcYXHqoz/tw/UN4DWHS5MeBmsKH8WK9M/xyL7nZ5aTTSZOJylGVwLzl/iuqWJZ2yE1QNbBGY4vymNX8bOiHR3GEDRqRMWgeU/G+wrefhcJ7o7WUPR35DTyyRcyumgKS4XRO5MNVNi2/PvtwCZB9hngo12uCQ5IuxDutWo7j2QiAAh6e354v+4k/xcQrfQDwto3077nHQYTtZDUnkJ4C75radG8ZF+yZDGzV5UhCROcsryC6d0EXRZ0yTY9rKPn855yO5/Li4= X-Forefront-Antispam-Report: CIP:194.138.21.71;CTRY:DE;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:hybrid.siemens.com;PTR:InfoDomainNonexistent;CAT:NONE;SFS:(4636009)(46966006)(40470700002)(36840700001)(186003)(36860700001)(82960400001)(16526019)(2906002)(83380400001)(508600001)(336012)(26005)(36756003)(44832011)(47076005)(8936002)(356005)(40460700001)(70586007)(6666004)(956004)(81166007)(2616005)(316002)(5660300002)(82310400004)(4326008)(1076003)(107886003)(8676002)(70206006)(6916009)(86362001)(36900700001);DIR:OUT;SFP:1101; X-OriginatorOrg: siemens.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 23 Dec 2021 11:34:25.5602 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 9168b086-0d5c-4421-c8ac-08d9c6082c63 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.71];Helo=[hybrid.siemens.com] X-MS-Exchange-CrossTenant-AuthSource: HE1EUR01FT011.eop-EUR01.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: PRAPR10MB5226 X-TUID: Z9KbKv73wWi9 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 caaab8c..df530e7 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) @@ -964,6 +965,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