From patchwork Sun Nov 11 13:14:54 2012 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Samuel Martin X-Patchwork-Id: 198277 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from silver.osuosl.org (silver.osuosl.org [140.211.166.136]) by ozlabs.org (Postfix) with ESMTP id 5C5322C0089 for ; Mon, 12 Nov 2012 00:17:42 +1100 (EST) Received: from localhost (localhost [127.0.0.1]) by silver.osuosl.org (Postfix) with ESMTP id 299E930F02; Sun, 11 Nov 2012 13:17:41 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org Received: from silver.osuosl.org ([127.0.0.1]) by localhost (.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id rhNFYeZJTzQu; Sun, 11 Nov 2012 13:17:35 +0000 (UTC) Received: from ash.osuosl.org (ash.osuosl.org [140.211.166.34]) by silver.osuosl.org (Postfix) with ESMTP id D967931019; Sun, 11 Nov 2012 13:16:41 +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 28AD88F753 for ; Sun, 11 Nov 2012 13:15:49 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by whitealder.osuosl.org (Postfix) with ESMTP id EC7FD8C2D7 for ; Sun, 11 Nov 2012 13:15:44 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org Received: from whitealder.osuosl.org ([127.0.0.1]) by localhost (.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id ugBGK3P3WMaP for ; Sun, 11 Nov 2012 13:15:44 +0000 (UTC) X-Greylist: domain auto-whitelisted by SQLgrey-1.7.6 Received: from mail-we0-f171.google.com (mail-we0-f171.google.com [74.125.82.171]) by whitealder.osuosl.org (Postfix) with ESMTPS id CA3438C2A6 for ; Sun, 11 Nov 2012 13:15:43 +0000 (UTC) Received: by mail-we0-f171.google.com with SMTP id s43so3028443wey.16 for ; Sun, 11 Nov 2012 05:15:43 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=from:to:cc:subject:date:message-id:x-mailer:in-reply-to:references; bh=xFZhP2d4c6vDGVH8QZdbnzHFt+vMqX/ceEeGh2haq3E=; b=FHWp4Vxk8otCC5NAJDHTYpbPMJEChakd8Dli2+Or1LMSHoPduJw40zaghzIj96Qmu3 9FnhuttToaegSmVy4P/rEjYsOfs0Uz/6HMz33UTdbnJLRBArzPlXBH4dRDi8uCis65VW M0KX8i+Rz0hiGqpMIipa/qKaasBeuAk5dPrzGpaEs/+Xl6pYe6MTuU+yd9MR4vA/0Y9S 7qpG9YPvG3Dk1wduHpwzqx8YZ86F7SzkPvfQdl8dTpGfbE9SHnOX9wSrj7pJ79uuaCAG AF42PeBAocME2mxz/Y+W9sUh5mGkSat2vkrPQS0fwpgHQw+wQTQGQuy9/YZs0SH5wyQw 2g/w== Received: by 10.216.141.16 with SMTP id f16mr7422393wej.130.1352639743530; Sun, 11 Nov 2012 05:15:43 -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 hv4sm10262550wib.0.2012.11.11.05.15.41 (version=SSLv3 cipher=OTHER); Sun, 11 Nov 2012 05:15:42 -0800 (PST) From: Samuel Martin To: buildroot@busybox.net Date: Sun, 11 Nov 2012 14:14:54 +0100 Message-Id: <1352639701-27829-17-git-send-email-s.martin49@gmail.com> X-Mailer: git-send-email 1.8.0 In-Reply-To: <1352639701-27829-1-git-send-email-s.martin49@gmail.com> References: <1352639701-27829-1-git-send-email-s.martin49@gmail.com> Subject: [Buildroot] [PATCH 16/23] manual: add package-make-target.txt 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 create mode 100644 docs/manual/package-make-target.txt diff --git a/docs/manual/advanced.txt b/docs/manual/advanced.txt index cd53182..ba6574c 100644 --- a/docs/manual/advanced.txt +++ b/docs/manual/advanced.txt @@ -10,3 +10,5 @@ include::external-toolchain.txt[] include::ccache-support.txt[] include::download-location.txt[] + +include::package-make-target.txt[] diff --git a/docs/manual/package-make-target.txt b/docs/manual/package-make-target.txt new file mode 100644 index 0000000..1813af3 --- /dev/null +++ b/docs/manual/package-make-target.txt @@ -0,0 +1,88 @@ +// -*- mode:doc; -*- + +[[pkg-build-steps]] + +Package make targets +~~~~~~~~~~~~~~~~~~~~ + +A +make + call achieves several _make targets_ with, as a +result, this particular package and its dependencies built, installed +in their destination directory (target, staging or host directory). + +For packages based on the Buildroot infrastructures (+generic-package+, ++autotools-package+ or +cmake-package+), each of those +actions/steps/commands. For packages relying on other build system, +then there is no other choice than looking at the +.mk+ file (see also +the xref:rebuild-pkg[]). + +For packages relying on the Buildroot infrastructures, there are +numerous special make targets that can be called independently like +this: + +------------ +make - +------------ + +In order, the package build commands are: + +[width="90%",cols="^1,4",options="header"] +|=================================================== +| command/target | Description + +| +source+ | Fetch the source (download the tarball, clone +the source repository, etc) + +| +depends+ | Build and install all dependencies required to +build the package + +| +extract+ | Put the source in the package build directory +(extract the tarball, copy the source, etc) + +| +patch+ | Apply the patches if any + +| +configure+ | Run the configure command + +| +build+ | Compile the source + +| +install-staging+ | +*target package:* Run the installation of the package in the +staging directory + +*host package:* Does nothing + +| +install-target+ | +*target package:* Run the installation of the package in the +staging directory + +*host package:* Does nothing + +| +install+ | +*target package:* Run the 2 previous installation commands for the +target packages + +*host package:* Run the installation of the package in the host +directory + +|=================================================== + +Additionally, there are some other useful make targets: + +[width="90%",cols="^1,4",options="header"] +|=================================================== +| command/target | Description + +| +show-depends+ | Displays the dependencies required to build the +package + +| +clean+ | Clean the package build directory, also +uninstall the package from both the target and the staging directory + +| +dirclean+ | Remove the whole package build directory + +| +rebuild+ | Rebuild only necessary binaries and install them +again + +| +reconfigure+ | Run again the configure command, then rebuild +only necessary binaries, and lastly install them again + +|=================================================== diff --git a/docs/manual/rebuilding-packages.txt b/docs/manual/rebuilding-packages.txt index 2225200..a723d11 100644 --- a/docs/manual/rebuilding-packages.txt +++ b/docs/manual/rebuilding-packages.txt @@ -83,3 +83,7 @@ Buildroot infrastructures. use any Buildroot infrastructure). - Most packages and toolchain packages, if not all, will progressively be ported over to the generic, autotools or CMake infrastructure, +making it much easier to rebuild individual packages. + +Further details about package special make target at the +xref:pkg-build-steps[].