llvm-size - print size information

.. program:: llvm-size

SYNOPSIS

:program:llvm-size [options] [input...]

DESCRIPTION

:program:llvm-size is a tool that prints size information for binary files. It is intended to be a drop-in replacement for GNU's :program: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, :program: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

.. option:: -A

Equivalent to :option:--format with a value of sysv.

.. option:: --arch=

Architecture(s) from Mach-O universal binaries to display information for.

.. option:: -B

Equivalent to :option:--format with a value of berkeley.

.. option:: --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.

.. option:: -d

Equivalent to :option:--radix with a value of 10.

.. option:: -l

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

.. option:: --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:

.. code-block:: console

$ 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

For Mach-O files, the output format is slightly different:

.. code-block:: console

$ 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

Sysv output displays size and address information for most sections, with each file being listed separately:

.. code-block:: console

$ 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

darwin format only affects Mach-O input files. If an input of a different file format is specified, :program:llvm-size falls back to berkeley format. When producing darwin format, the tool displays information about segments and sections:

.. code-block:: console

$ 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

.. option:: --help, -h

Display a summary of command line options.

.. option:: -m

Equivalent to :option:--format with a value of darwin.

.. option:: -o

Equivalent to :option:--radix with a value of 8.

.. option:: --radix=

Display size information in the specified radix. Permitted values are 8, 10 (the default) and 16 for octal, decimal and hexadecimal output respectively.

Example:

.. code-block:: console

$ 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

.. option:: --totals, -t

Applies only to berkeley output format. Display the totals for all listed fields, in addition to the individual file listings.

Example:

.. code-block:: console

$ 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)

.. option:: --version

Display the version of the :program:llvm-size executable.

.. option:: -x

Equivalent to :option:--radix with a value of 16.

.. option:: @

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

EXIT STATUS

:program: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://github.com/llvm/llvm-project/labels/tools:llvm-size/.