path: root/docs
diff options
authorJames Morrissey <james.morrissey@arm.com>2013-11-01 13:56:59 +0000
committerDan Handley <dan.handley@arm.com>2013-11-27 15:34:02 +0000
commiteaaeece2b0f22958e3724020f4686aa9d635a1e0 (patch)
treefdf01291c89c4499ea66a34935a438c8666a21c9 /docs
parent375ae68e8dbd920f6e8b6ae5cebd40f1ae45350d (diff)
Generate build products in sub-directories
A single binary can be compiled using a command such as: make CROSS_COMPILE=aarch64-none-elf- bl1 Also make use of brackets consistent in the Makefile. Change-Id: I2180fdb473411ef7cffe39670a7b2de82def812e
Diffstat (limited to 'docs')
2 files changed, 22 insertions, 9 deletions
diff --git a/docs/change-log.md b/docs/change-log.md
index ee9be77..ca3cb7f 100644
--- a/docs/change-log.md
+++ b/docs/change-log.md
@@ -24,6 +24,8 @@ Detailed changes since last release
Base FVPs have been increased from 2GB to 4GB. This resolves the issue of
failing to start user-space when using a RAM-disk file-system.
+* Build products are now created in a separate build directory tree.
ARM Trusted Firmware - version 0.2
diff --git a/docs/user-guide.md b/docs/user-guide.md
index 2c7439a..3bb4250 100644
--- a/docs/user-guide.md
+++ b/docs/user-guide.md
@@ -87,19 +87,30 @@ To build the software for the FVPs, follow these steps:
By default this produces a release version of the build. To produce a debug
version instead, refer to the "Debugging options" section below.
- The build creates ELF and raw binary files in the current directory. It
- generates the following boot loader binary files from the ELF files:
+ The build process creates products in a `build` directory tree, building
+ the objects and binaries for each boot loader stage in separate
+ sub-directories. The following boot loader binary files are created from
+ the corresponding ELF files:
- * `bl1.bin`
- * `bl2.bin`
- * `bl31.bin`
+ * `build/<platform>/<build-type>/bl1.bin`
+ * `build/<platform>/<build-type>/bl2.bin`
+ * `build/<platform>/<build-type>/bl31.bin`
-4. Copy the above 3 boot loader binary files to the directory where the FVPs
- are launched from. Symbolic links of the same names may be created instead.
+ ... where `<platform>` currently defaults to `fvp` and `<build-type>` is
+ either `debug` or `release`.
-5. (Optional) To clean the build directory use
+4. Copy the three boot loader binary files to the directory from which the FVP
+ will be launched. Symbolic links of the same names may be created instead.
- make distclean
+5. (Optional) Build products for a specific build variant can be removed using:
+ make DEBUG=<D> clean
+ ... where `<D>` is `0` or `1`, as specified when building.
+ The build tree can be removed completely using:
+ make realclean
#### Debugging options