Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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 in-
       put and prints corresponding source code	locations to standard  output.
       If  object file is specified in command line, llvm-symbolizer processes
       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 isn't 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 er-
       ror.

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

COPYRIGHT
       2003-2017, LLVM Project

3.9				  2017-07-02		    LLVM-SYMBOLIZER(1)

NAME | SYNOPSIS | DESCRIPTION | EXAMPLE | OPTIONS | EXIT STATUS | AUTHOR | COPYRIGHT

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=llvm-symbolizer39&sektion=1&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help