diff options
author | James Morrissey <james.morrissey@arm.com> | 2013-11-01 13:56:59 +0000 |
---|---|---|
committer | Dan Handley <dan.handley@arm.com> | 2013-11-27 15:34:02 +0000 |
commit | eaaeece2b0f22958e3724020f4686aa9d635a1e0 (patch) | |
tree | fdf01291c89c4499ea66a34935a438c8666a21c9 /docs/user-guide.md | |
parent | 375ae68e8dbd920f6e8b6ae5cebd40f1ae45350d (diff) | |
download | arm-trusted-firmware-eaaeece2b0f22958e3724020f4686aa9d635a1e0.tar.gz |
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/user-guide.md')
-rw-r--r-- | docs/user-guide.md | 29 |
1 files changed, 20 insertions, 9 deletions
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 |