diff options
| author | Sean Eveson <eveson.sean@gmail.com> | 2017-11-30 13:05:14 +0000 |
|---|---|---|
| committer | Sean Eveson <eveson.sean@gmail.com> | 2017-11-30 13:05:14 +0000 |
| commit | a6bcd53d5229db563d0ba25b6385e3ca5d0820de (patch) | |
| tree | 7cef0a8088cba473cf19d7eb789bad9521ea4687 /llvm/docs/CommandGuide | |
| parent | 661e4fbf83887a074ab3ab06ae41470cce4ff45c (diff) | |
| download | llvm-a6bcd53d5229db563d0ba25b6385e3ca5d0820de.zip llvm-a6bcd53d5229db563d0ba25b6385e3ca5d0820de.tar.gz llvm-a6bcd53d5229db563d0ba25b6385e3ca5d0820de.tar.bz2 | |
[MC] Function stack size section.
Re applying after fixing issues in the diff, sorry for any painful conflicts/merges!
Original RFC: http://lists.llvm.org/pipermail/llvm-dev/2017-August/117028.html
This change adds a '.stack-size' section containing metadata on function stack sizes to output ELF files behind the new -stack-size-section flag. The section contains pairs of function symbol references (8 byte) and stack sizes (unsigned LEB128).
The contents of this section can be used to measure changes to stack sizes between different versions of the compiler or a source base. The advantage of having a section is that we can extract this information when examining binaries that we didn't build, and it allows users and tools easy access to that information just by referencing the binary.
There is a follow up change to add an option to clang.
Thanks.
Reviewers: hfinkel, MatzeB
Reviewed By: MatzeB
Subscribers: thegameg, asb, llvm-commits
Differential Revision: https://reviews.llvm.org/D39788
llvm-svn: 319430
Diffstat (limited to 'llvm/docs/CommandGuide')
| -rw-r--r-- | llvm/docs/CommandGuide/llc.rst | 8 |
1 files changed, 8 insertions, 0 deletions
diff --git a/llvm/docs/CommandGuide/llc.rst b/llvm/docs/CommandGuide/llc.rst index 5094259..95945e6 100644 --- a/llvm/docs/CommandGuide/llc.rst +++ b/llvm/docs/CommandGuide/llc.rst @@ -132,6 +132,14 @@ End-user Options Specify which EABI version should conform to. Valid EABI versions are *gnu*, *4* and *5*. Default value (*default*) depends on the triple. +.. option:: -stack-size-section + + Emit the .stack_sizes section which contains stack size metadata. The section + contains an array of pairs of function symbol references (8 byte) and stack + sizes (unsigned LEB128). The stack size values only include the space allocated + in the function prologue. Functions with dynamic stack allocations are not + included. + Tuning/Configuration Options ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |