LLVM-SIZE(1)

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's 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

-A  Equivalent to --format with a value of sysv.

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

-B  Equivalent to --format with a value of berkeley.

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

--exclude-pagezero
    Do not include the __PAGEZERO segment when calculating size information for Mach-O files. The __PAGEZERO segment is a virtual memory region used for memory protection that does not contribute to actual size, and excluding can provide a better representation of actual size.

-d  Equivalent to --radix with a value of 10.

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

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

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

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

        $ 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, llvm-size falls back to berkeley format. When producing darwin format, the tool displays information about segments and sections:

        $ 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

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

-m  Equivalent to --format with a value of darwin.

-o  Equivalent to --radix with a value of 8.

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

        $ 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

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

    Example:

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

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

-x  Equivalent to --radix with a value of 16.

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

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

Author
Maintained by the LLVM Team (https://llvm.org/).

Copyright
2003-2026, LLVM Project