From patchwork Wed Feb 13 22:59:06 2013 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Samuel Martin X-Patchwork-Id: 220299 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from whitealder.osuosl.org (whitealder.osuosl.org [140.211.166.138]) by ozlabs.org (Postfix) with ESMTP id 7A0902C0085 for ; Thu, 14 Feb 2013 10:12:05 +1100 (EST) Received: from localhost (localhost [127.0.0.1]) by whitealder.osuosl.org (Postfix) with ESMTP id A9DAC8B46B; Wed, 13 Feb 2013 23:11:58 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org X-Amavis-Alert: BAD HEADER SECTION, Duplicate header field: "References" Received: from whitealder.osuosl.org ([127.0.0.1]) by localhost (.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id UiTCyZ0NCNpv; Wed, 13 Feb 2013 23:11:37 +0000 (UTC) Received: from ash.osuosl.org (ash.osuosl.org [140.211.166.34]) by whitealder.osuosl.org (Postfix) with ESMTP id 423988C5FF; Wed, 13 Feb 2013 23:10:29 +0000 (UTC) X-Original-To: buildroot@lists.busybox.net Delivered-To: buildroot@osuosl.org Received: from whitealder.osuosl.org (whitealder.osuosl.org [140.211.166.138]) by ash.osuosl.org (Postfix) with ESMTP id 154058F75B for ; Wed, 13 Feb 2013 23:10:35 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by whitealder.osuosl.org (Postfix) with ESMTP id 84DDA8C5FF for ; Wed, 13 Feb 2013 23:10:27 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org X-Amavis-Alert: BAD HEADER SECTION, Duplicate header field: "References" Received: from whitealder.osuosl.org ([127.0.0.1]) by localhost (.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id hgRTzY6r72B2 for ; Wed, 13 Feb 2013 23:10:15 +0000 (UTC) X-Greylist: domain auto-whitelisted by SQLgrey-1.7.6 Received: from mail-we0-f177.google.com (mail-we0-f177.google.com [74.125.82.177]) by whitealder.osuosl.org (Postfix) with ESMTPS id 8771D8B7E4 for ; Wed, 13 Feb 2013 23:08:56 +0000 (UTC) Received: by mail-we0-f177.google.com with SMTP id d7so1445299wer.8 for ; Wed, 13 Feb 2013 15:08:54 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=x-received:from:to:cc:subject:date:message-id:x-mailer:in-reply-to :references:in-reply-to:references; bh=0Cf91C/PLqV2We3lZLwKcOnL6Bf7ZRqEwiAF6B7t3es=; b=nXCT80aMEN4rfQGd4iY3oKWA+si/TDj3K3bbN7nwDplkErLqnD1W4oJNXKoaBXNtw+ Mzw3BOiNWIBO6pcDkKBJd3RSU2sGf6cmfgS+IXkTHrzaEJZWbHEajkDa2pKpQFudieil RReYdQCJfOnQdLmWJ7Kp5WxuG1JxJezfM857uuWoFg+ekITyK4xIpPGQ3/JKFdXjA7Zj PJkNwrOgA6Cvw2rwWGc5+1LumDeKfczoV08Vmd+sJolReQJe1shMqPNTOhoCaWtMn1HR 4WZEG3+Yy4UlQbjnu2iRVu0OWHNjHVId8nxmWlxUX2+UZRKCZKGdlb8uBkAgIWhMUEMk J7tQ== X-Received: by 10.180.105.232 with SMTP id gp8mr12945649wib.33.1360796445642; Wed, 13 Feb 2013 15:00:45 -0800 (PST) Received: from localhost.localdomain (ivr94-4-82-229-165-48.fbx.proxad.net. [82.229.165.48]) by mx.google.com with ESMTPS id o13sm40168274wie.10.2013.02.13.15.00.44 (version=TLSv1.1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Wed, 13 Feb 2013 15:00:45 -0800 (PST) From: Samuel Martin To: buildroot@busybox.net Date: Wed, 13 Feb 2013 23:59:06 +0100 Message-Id: X-Mailer: git-send-email 1.8.1.3 In-Reply-To: References: In-Reply-To: References: Subject: [Buildroot] [PATCH 5/9] manual: faq: add workaround to avoid rebuilding the buildroot toolchain after each clean X-BeenThere: buildroot@busybox.net X-Mailman-Version: 2.1.14 Precedence: list List-Id: Discussion and development of buildroot List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , MIME-Version: 1.0 Errors-To: buildroot-bounces@busybox.net Sender: buildroot-bounces@busybox.net Signed-off-by: Samuel Martin --- docs/manual/common-usage.txt | 1 + docs/manual/faq-troubleshooting.txt | 34 ++++++++++++++++++++++++++++++++++ 2 files changed, 35 insertions(+) diff --git a/docs/manual/common-usage.txt b/docs/manual/common-usage.txt index c7f511a..b36965f 100644 --- a/docs/manual/common-usage.txt +++ b/docs/manual/common-usage.txt @@ -20,6 +20,7 @@ all sources that you previously selected in the configurator You can now disconnect or copy the content of your +dl+ directory to the build-host. +[[daily-oot-build]] Building out-of-tree ~~~~~~~~~~~~~~~~~~~~ diff --git a/docs/manual/faq-troubleshooting.txt b/docs/manual/faq-troubleshooting.txt index 8b0882a..f367275 100644 --- a/docs/manual/faq-troubleshooting.txt +++ b/docs/manual/faq-troubleshooting.txt @@ -147,3 +147,37 @@ Using the internal Buildroot toolchain backend ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ These toolchains are currently *not relocatable*. + +However, it is possible to build a toolchain using the internal Buildroot +backend in another location (see xref:daily-oot-build[]), then use it as an +_external_ one to prevent from rebuilding it after issuing +make clean+ +(see xref:faq-avoid-rebuild-toolchain[]). + +[[faq-avoid-rebuild-toolchain]] +How to avoid always rebuilding the toolchain? +--------------------------------------------- + +When using the internal Buildroot toolchain backend or the +http://crosstool-ng.org[crosstool-NG] one, runnong +make clean+ not only +remove the built binaries, but also the whole toolchain. + +It is possible to prevent this by, first, building the toolchain in a +place different from the one where the images will be built. + +To do so: + +1. Build the toolchain somewhere: ++ +---------------------------- +make toolchain O=/path/to/toolchain +---------------------------- ++ +1. Use this pre-built toolchain as an external one in a new and clean + build (see xref:external-toolchain-backend[]) with a different output + directory than the pre-built toolchain one. + +This way, you will not have to rebuild the toolchain after invoking ++make clean+. + +However, the toolchain should be regenerated after any change of the ++Target Architecture+ (or its _variant_), or done in the +Toolchain+ menu.