diff options
| author | Douglas Raillard <douglas.raillard@arm.com> | 2017-06-22 15:03:50 +0100 |
|---|---|---|
| committer | Douglas Raillard <douglas.raillard@arm.com> | 2017-06-28 15:03:05 +0100 |
| commit | f7ad7a63c5d86d6e573ca40bbd159375c0642476 (patch) | |
| tree | 3be5e7501113a2ea636107b9833ad406a098cef2 | |
| parent | c2b8806fb6e4f225bfb73b5378a31a9b96b0bd60 (diff) | |
Document CFLAGS make option
CFLAGS content can be set on the command line to allow passing extra
options to the compiler. Its content is appended after the options set
by the Makefile (TF_CFLAGS).
The Makefiles must use TF_CFLAGS instead of CFLAGS, as the latter can be
completely overriden by setting it on the command line.
Also tell about LDFLAGS in the "Debugging options" section.
Change-Id: Iaf27b424002898ef3040133f78cb133983a37aee
Signed-off-by: Douglas Raillard <douglas.raillard@arm.com>
| -rw-r--r-- | docs/user-guide.md | 9 |
1 files changed, 8 insertions, 1 deletions
diff --git a/docs/user-guide.md b/docs/user-guide.md index 0e9da35d..29691c5b 100644 --- a/docs/user-guide.md +++ b/docs/user-guide.md @@ -269,6 +269,9 @@ performed. * `BUILD_STRING`: Input string for VERSION_STRING, which allows the TF build to be uniquely identified. Defaults to the current git commit id. +* `CFLAGS`: Extra user options appended on the compiler's command line in + addition to the options set by the build system. + * `COLD_BOOT_SINGLE_CPU`: This option indicates whether the platform may release several CPUs out of reset. It can take either 0 (several CPUs may be brought up) or 1 (only one CPU will ever be brought up during cold reset). @@ -687,11 +690,15 @@ NOTE: Using `-O0` could cause output images to be larger and base addresses might need to be recalculated (see the **Memory layout on ARM development platforms** section in the [Firmware Design]). -Extra debug options can be passed to the build system by setting `CFLAGS`: +Extra debug options can be passed to the build system by setting `CFLAGS` or +`LDFLAGS`: CFLAGS='-O0 -gdwarf-2' \ make PLAT=<platform> DEBUG=1 V=1 all +Note that using `-Wl,` style compilation driver options in `CFLAGS` will be +ignored as the linker is called directly. + It is also possible to introduce an infinite loop to help in debugging the post-BL2 phase of the Trusted Firmware. This can be done by rebuilding BL1 with the `SPIN_ON_BL1_EXIT=1` build flag. Refer to the "Summary of build options" |