xref: /freebsd/usr.bin/clang/llvm-size/llvm-size.1 (revision f7c32ed617858bcd22f8d1b03199099d50125721)
$FreeBSD$
Man page generated from reStructuredText.
. . .nr rst2man-indent-level 0 . \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .rstReportMargin pre:
. RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .rstReportMargin post:
.. . RE indent \\n[an-margin]
old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1 new: \\n[rst2man-indent\\n[rst2man-indent-level]]
..
"LLVM-SIZE" "1" "2021-06-07" "12" "LLVM"
NAME
llvm-size - print size information
SYNOPSIS
llvm-size [options] [input...]
DESCRIPTION
llvm-size is a tool that prints size information for binary files. It is intended to be a drop-in replacement for GNU\(aqs size. The tool prints size information for each input specified. If no input is specified, the program prints size information for a.out. If "-" is specified as an input file, llvm-size reads a file from the standard input stream. If an input is an archive, size information will be displayed for all its members.
OPTIONS
NDENT 0.0

-A Equivalent to \%--format with a value of sysv. NINDENT NDENT 0.0

--arch=<arch> Architecture(s) from Mach-O universal binaries to display information for. NINDENT NDENT 0.0

-B Equivalent to \%--format with a value of berkeley. NINDENT NDENT 0.0

--common Include ELF common symbol sizes in bss size for berkeley output format, or as a separate section entry for sysv output. If not specified, these symbols are ignored. NINDENT NDENT 0.0

-d Equivalent to \%--radix with a value of 10. NINDENT NDENT 0.0

-l Display verbose address and offset information for segments and sections in Mach-O files in darwin format. NINDENT NDENT 0.0

--format=<format> Set the output format to the <format> specified. Available <format> options are berkeley (the default), sysv and darwin. Berkeley output summarises text, data and bss sizes in each file, as shown below for a typical pair of ELF files: NDENT 7.0 NDENT 3.5

$ llvm-size --format=berkeley test.o test2.o
 text data bss dec hex filename
 182 16 5 203 cb test.elf
 82 8 1 91 5b test2.o
NINDENT NINDENT For Mach-O files, the output format is slightly different: NDENT 7.0 NDENT 3.5
$ llvm-size --format=berkeley macho.obj macho2.obj
__TEXT __DATA __OBJC others dec hex
4 8 0 0 12 c macho.obj
16 32 0 0 48 30 macho2.obj
NINDENT NINDENT Sysv output displays size and address information for most sections, with each file being listed separately: NDENT 7.0 NDENT 3.5
$ llvm-size --format=sysv test.elf test2.o
 test.elf :
 section size addr
 .eh_frame 92 2097496
 .text 90 2101248
 .data 16 2105344
 .bss 5 2105360
 .comment 209 0
 Total 412

 test2.o :
 section size addr
 .text 26 0
 .data 8 0
 .bss 1 0
 .comment 106 0
 .note.GNU-stack 0 0
 .eh_frame 56 0
 .llvm_addrsig 2 0
 Total 199
NINDENT NINDENT darwin format only affects Mach-O input files. If an input of a different file format is specified, llvm-size falls back to berkeley format. When producing darwin format, the tool displays information about segments and sections: NDENT 7.0 NDENT 3.5
$ llvm-size --format=darwin macho.obj macho2.obj
 macho.obj:
 Segment : 12
 Section (__TEXT, __text): 4
 Section (__DATA, __data): 8
 total 12
 total 12
 macho2.obj:
 Segment : 48
 Section (__TEXT, __text): 16
 Section (__DATA, __data): 32
 total 48
 total 48
NINDENT NINDENT NINDENT NDENT 0.0

--help, -h Display a summary of command line options. NINDENT NDENT 0.0

--help-list Display an uncategorized summary of command line options. NINDENT NDENT 0.0

-m Equivalent to \%--format with a value of darwin. NINDENT NDENT 0.0

-o Equivalent to \%--radix with a value of 8. NINDENT NDENT 0.0

--radix=<value> Display size information in the specified radix. Permitted values are 8, 10 (the default) and 16 for octal, decimal and hexadecimal output respectively. Example: NDENT 7.0 NDENT 3.5

$ llvm-size --radix=8 test.o
 text data bss oct hex filename
 0152 04 04 162 72 test.o

$ llvm-size --radix=10 test.o
 text data bss dec hex filename
 106 4 4 114 72 test.o

$ llvm-size --radix=16 test.o
 text data bss dec hex filename
 0x6a 0x4 0x4 114 72 test.o
NINDENT NINDENT NINDENT NDENT 0.0

--totals, -t Applies only to berkeley output format. Display the totals for all listed fields, in addition to the individual file listings. Example: NDENT 7.0 NDENT 3.5

$ llvm-size --totals test.elf test2.o
 text data bss dec hex filename
 182 16 5 203 cb test.elf
 82 8 1 91 5b test2.o
 264 24 6 294 126 (TOTALS)
NINDENT NINDENT NINDENT NDENT 0.0

--version Display the version of the llvm-size executable. NINDENT NDENT 0.0

-x Equivalent to \%--radix with a value of 16. NINDENT NDENT 0.0

@<FILE> Read command-line options from response file <FILE>. NINDENT

EXIT STATUS
llvm-size exits with a non-zero exit code if there is an error. Otherwise, it exits with code 0.
BUGS
To report bugs, please visit <\%https://bugs.llvm.org/>.
AUTHOR
Maintained by the LLVM Team (https://llvm.org/).
COPYRIGHT
2003-2021, LLVM Project Generated by docutils manpage writer.
.