Summary

This is adding the new CMake option AMReX_ADDRLINES and CMake public interface target AMReX::FLAGS_ADDRLINES. This option adds minimal debug info (-g1 / -gline-tables-only) to executables, which generates more usable backtraces on crashes.

In symmetry to GNUmake, we turn this now ON. This is a breaking change.

Note that this flag still creates significant binary size overheads, so package managers might decide to turn if off in deployments. Also, if the increased binary sizes lead to significant startup overhead at scale on HPC systems, we might need to reconsider the default (for CMake and GNUmake) in the future.

Additional background

Binary size benchmarks on WarpX.

|                           | HIP Size (MiB) | GCC Size (MiB) |
|---------------------------+----------------+----------------|
| release, no debug info    |           30.7 |           12.1 |
| release, addr lines/`-g1` |           69.1 |           53.9 |
| release, `-g`             |          158.7 |          257.9 |
| debug                     |          489.0 |          173.3 |

Checklist

The proposed changes:

• fix a bug or incorrect behavior in AMReX
• add new capabilities to AMReX
• changes answers in the test suite to more than roundoff level
• are likely to significantly affect the results of downstream AMReX users
• include documentation in the code and/or rst files, if appropriate