DragonFly On-Line Manual Pages

LLVM-SYMBOLIZER(1)		     LLVM		    LLVM-SYMBOLIZER(1)

NAME
       llvm-symbolizer - convert addresses into source code locations

SYNOPSIS
       llvm-symbolizer [options]

DESCRIPTION
       llvm-symbolizer	reads  object  file  names and addresses from standard
       input and prints corresponding source code locations to	standard  out-
       put.  If object file is specified in command line, llvm-symbolizer pro-
       cesses only addresses from standard input, the rest is output verbatim.
       This  program  uses  debug info sections and symbol table in the object
       files.

EXAMPLE
	  $ cat addr.txt
	  a.out 0x4004f4
	  /tmp/b.out 0x400528
	  /tmp/c.so 0x710
	  /tmp/mach_universal_binary:i386 0x1f84
	  /tmp/mach_universal_binary:x86_64 0x100000f24
	  $ llvm-symbolizer < addr.txt
	  main
	  /tmp/a.cc:4

	  f(int, int)
	  /tmp/b.cc:11

	  h_inlined_into_g
	  /tmp/header.h:2
	  g_inlined_into_f
	  /tmp/header.h:7
	  f_inlined_into_main
	  /tmp/source.cc:3
	  main
	  /tmp/source.cc:8

	  _main
	  /tmp/source_i386.cc:8

	  _main
	  /tmp/source_x86_64.cc:8
	  $ cat addr2.txt
	  0x4004f4
	  0x401000
	  $ llvm-symbolizer -obj=a.out < addr2.txt
	  main
	  /tmp/a.cc:4

	  foo(int)
	  /tmp/a.cc:12
	  $cat addr.txt
	  0x40054d
	  $llvm-symbolizer -inlining -print-address -pretty-print -obj=addr.exe < addr.txt
	  0x40054d: inc at /tmp/x.c:3:3
	   (inlined by) main at /tmp/x.c:9:0
	  $llvm-symbolizer -inlining -pretty-print -obj=addr.exe < addr.txt
	  inc at /tmp/x.c:3:3
	   (inlined by) main at /tmp/x.c:9:0

OPTIONS
       -obj   Path to object file to be symbolized.

       -functions=[none|short|linkage]
	      Specify the way function names are printed (omit function  name,
	      print  short  function name, or print full linkage name, respec-
	      tively).	Defaults to linkage.

       -use-symbol-table
	      Prefer function names stored in symbol table to  function  names
	      in debug info sections. Defaults to true.

       -demangle
	      Print demangled function names. Defaults to true.

       -inlining
	      If  a source code location is in an inlined function, prints all
	      the inlnied frames. Defaults to true.

       -default-arch
	      If a binary contains object  files  for  multiple  architectures
	      (e.g.  it  is  a	Mach-O universal binary), symbolize the object
	      file for a given architecture.  You can also  specify  architec-
	      ture  by writing binary_name:arch_name in the input (see example
	      above). If architecture is not specified in either way,  address
	      will not be symbolized. Defaults to empty string.

       -dsym-hint=<path/to/file.dSYM>
	      (Darwin-only flag). If the debug info for a binary isnat present
	      in the default location, look for the debug info	at  the  .dSYM
	      path  provided  via  the	-dsym-hint flag. This flag can be used
	      multiple times.

       -print-address
	      Print address before  the  source  code  location.  Defaults  to
	      false.

       -pretty-print
	      Print  human readable output. If -inlining is specified, enclos-
	      ing scope is prefixed by (inlined by). Refer to listed examples.

EXIT STATUS
       llvm-symbolizer returns 0. Other  exit  codes  imply  internal  program
       error.

AUTHOR
       Maintained by The LLVM Team (http://llvm.org/).

COPYRIGHT
       2003-2019, LLVM Project

4				  2019-01-30		    LLVM-SYMBOLIZER(1)