From mboxrd@z Thu Jan 1 00:00:00 1970 X-GM-THRID: 7024486976540639232 X-Received: by 2002:ac2:4e98:: with SMTP id o24mr10727426lfr.295.1635515829610; Fri, 29 Oct 2021 06:57:09 -0700 (PDT) X-BeenThere: isar-users@googlegroups.com Received: by 2002:a05:651c:b1e:: with SMTP id b30ls1266349ljr.9.gmail; Fri, 29 Oct 2021 06:57:08 -0700 (PDT) X-Google-Smtp-Source: ABdhPJzvLHpmUycLSl/18FOjClCXzDnXEhBBsYobZDlGoiMoFx1tkx2lq2aaWFCtyTQz9HKJyO5U X-Received: by 2002:a2e:571d:: with SMTP id l29mr3248004ljb.357.1635515828335; Fri, 29 Oct 2021 06:57:08 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1635515828; cv=none; d=google.com; s=arc-20160816; b=Cn3AiIJYqsfjSmRsvhBG/rwjujreGAx5hm9YcgRSeqlmXcRuuKI9FE5Uj5ew88KABt QFmpIGiUQsg07WrNvGkC5m/E/s6+5lfakSdpBhKWofU+yetTnvuNsIhgYdMRdYtrjH5b DOQA/p3BpDNdR99g774gq747Ad0TlPngYnUrNldWBLxjQWgF37mkXgqrc9wFHrzYAZgo JsaZqY69mgxEwOfjzGbIBmdxIzOKxcOgc0hGU4CiFCD47tOHvi4jsb/hc5kibWrf3vcs XgnHTCb//sguFkM6OOXsw5lY3lb0vlGTJq6k42hGSZOh276O5RZLQbntALh7UcqCKGFx QKdg== ARC-Message-Signature: i=1; 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:to:from; bh=LX7eCjY5YHxGS+O7a+NCuxo/a3MESMx3YDbdHpMIGqk=; b=go66RpQs/uYUE8gwg6ajIJOsjbk0oCpilT1mt57BNgEfSCLHzi2gIhiJbqKJMUR32T C6ZgdOUtFCHtQPq6UEsbltPT9LQ9nN761rBhk9Cd8Z5fIuDloEGYjdwdX6/gwQilNZBU DaYwC23MjSpxgOShq2AE1pQTif4a9it09bWPOjWloUMZFJHdvZotwR0uKLH0zmB8LbZy sGuw4Xp2+I3hmFwbr0McI1tKopPOJAJUfTnLGqZ6drv4c05iyYaCdIntrpyPmdx1jOLh Z4qmKahFUdKA2WB7O0LGfYqPJ3dzpzd0dbtDvU0RwpsgKA+MoNWAkMTrUoLDvwwWGYwC qHIA== ARC-Authentication-Results: i=1; gmr-mx.google.com; spf=pass (google.com: domain of ubely@ilbers.de designates 85.214.156.166 as permitted sender) smtp.mailfrom=ubely@ilbers.de Return-Path: Received: from shymkent.ilbers.de (shymkent.ilbers.de. [85.214.156.166]) by gmr-mx.google.com with ESMTPS id f20si326171ljn.4.2021.10.29.06.57.08 for (version=TLS1_2 cipher=ECDHE-ECDSA-CHACHA20-POLY1305 bits=256/256); Fri, 29 Oct 2021 06:57:08 -0700 (PDT) Received-SPF: pass (google.com: domain of ubely@ilbers.de designates 85.214.156.166 as permitted sender) client-ip=85.214.156.166; Authentication-Results: gmr-mx.google.com; spf=pass (google.com: domain of ubely@ilbers.de designates 85.214.156.166 as permitted sender) smtp.mailfrom=ubely@ilbers.de Received: from baighyz.m.ilbers.de (host-80-81-17-52.static.customer.m-online.net [80.81.17.52]) (authenticated bits=0) by shymkent.ilbers.de (8.15.2/8.15.2/Debian-8) with ESMTPSA id 19TDv0m5022514 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 29 Oct 2021 15:57:05 +0200 From: Uladzimir Bely To: isar-users@googlegroups.com Subject: [PATCH v3 2/3] doc: Add section about ccache usage Date: Fri, 29 Oct 2021 15:56:59 +0200 Message-Id: <20211029135700.27885-3-ubely@ilbers.de> X-Mailer: git-send-email 2.20.1 In-Reply-To: <20211029135700.27885-1-ubely@ilbers.de> References: <20211029135700.27885-1-ubely@ilbers.de> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-TUID: fPjr1p6b4o8t Signed-off-by: Uladzimir Bely --- doc/user_manual.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/doc/user_manual.md b/doc/user_manual.md index 01fe7019..535d456a 100644 --- a/doc/user_manual.md +++ b/doc/user_manual.md @@ -18,6 +18,7 @@ Copyright (C) 2016-2019, ilbers GmbH - [Add a New Image Type](#add-a-new-image-type) - [Add a Custom Application](#add-a-custom-application) - [Enabling Cross-compilation](#isar-cross-compilation) + - [Using ccache for custom packages](#using-ccache-for-custom-packages) - [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) @@ -912,6 +913,22 @@ package build. To invoke it, just call `bitbake mc:${MACHINE}-${DISTRO}: -c devshell`. +## Using ccache for custom packages + +While base system is created from binary Debian repositories, some user +packages are built from sources. It's possible to reduce build time +for such packages by enabling ccache. + +To enable global ccache functionality, `USE_CCACHE = "1"` can be added +to `local.conf`. If some package requires ccache to be always disabled, +`USE_CCACHE = "0"` can be used in the recipe despite global setup. + +By default, ccache directory is created inside `TMPDIR`, but it can be +adjusted by `CCACHE_TOP_DIR` variable in `local.conf`. Ccache directory +`CCACHE_DIR` default value is `"${CCACHE_TOP_DIR}/${DISTRO}-${DISTRO_ARCH}"`, +that means caches for different distros and architectures are not overlapped. + + ## Create an ISAR SDK root filesystem ### Motivation -- 2.20.1