NAME

       llvm-tli-checker - TargetLibraryInfo vs library checker

SYNOPSIS

       llvm-tli-checker [options] [library-file…]

DESCRIPTION

       llvm-tli-checker  compares  TargetLibraryInfo’s  opinion of the availability of library functions against
       the set of functions exported by the specified library files, reporting any disagreements  between  TLI’s
       opinion  and whether the function is actually present. This is primarily useful for vendors to ensure the
       TLI for their target is correct, and the compiler will not “optimize” some code sequence into  a  library
       call that is not actually available.

EXAMPLE

          $ llvm-tli-checker --triple x86_64-scei-ps4 example.so
          TLI knows 466 symbols, 235 available for 'x86_64-scei-ps4'

          Looking for symbols in 'example.so'
          Found 235 global function symbols in 'example.so'
          Found a grand total of 235 library symbols
          << TLI yes SDK no:  '_ZdaPv' aka operator delete[](void*)
          >> TLI no  SDK yes: '_ZdaPvj' aka operator delete[](void*, unsigned int)
          << Total TLI yes SDK no:  1
          >> Total TLI no  SDK yes: 1
          == Total TLI yes SDK yes: 234
          FAIL: LLVM TLI doesn't match SDK libraries.

OPTIONS

       --dump-tli
              Print  “available”/”not  available”  for  each  library function, according to TargetLibraryInfo’s
              information for the specified triple, and exit. This option does not read any input files.

       --help, -h
              Print a summary of command line options and exit.

       --libdir=<directory>
              A base directory to prepend to each library file path. This is handy when there are  a  number  of
              library files all in the same directory, or a list of input filenames are kept in a response file.

       --report=<level>
              The  amount  of  information  to  report.  <level> can be summary, discrepancy, or full. A summary
              report gives  only  the  count  of  matching  and  mis-matching  symbols;  discrepancy  lists  the
              mis-matching  symbols;  and  full  lists  all  symbols known to TLI, matching or mis-matching. The
              default is discrepancy.

       --separate
              Read and report a summary for each library file  separately.   This  can  be  useful  to  identify
              library files that don’t contribute anything that TLI knows about. Implies –report=summary (can be
              overridden).

       --triple=<triple>
              The triple to use for initializing TargetLibraryInfo.

       @<FILE>
              Read command-line options and/or library names from response file <FILE>.

EXIT STATUS

       llvm-tli-checker returns 0 even if there are mismatches. It returns a non-zero exit code if there  is  an
       unrecognized option, or no input files are provided.

AUTHOR

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

COPYRIGHT

       2003-2023, LLVM Project