manpagez: man pages & more
man llvm-dsymutil(1)
Home | html | info | man
llvm-dsymutil(1)                     LLVM                     llvm-dsymutil(1)




NAME

       llvm-dsymutil - manipulate archived DWARF debug symbol files.


SYNOPSIS

       llvm-dsymutil [options] exe_file
       llvm-dsymutil <i>asymbol-map=bcsymbolmap [options] exe_file



DESCRIPTION

       llvm-dsymutil  links  the  DWARF  debug information found in the object
       files for an executable exe_file by  using  debug  symbols  information
       contained in its symbol table.


OPTIONS

       -arch=ARCH
              Link DWARF debug information only for specified CPU architecture
              types.  Architectures may be specified by name. When using  this
              option,  an  error will be returned if any architectures can not
              be properly linked.   This  option  can  be  specified  multiple
              times,  once  for  each desired architecture.  All cpu architec-
              tures will be linked by default and any architectures that canat
              be  properly linked will cause llvm-dsymutil to return an error.

       -f, --flat
              Produce a flat dSYM file. A a.dwarfa extension will be  appended
              to the executable name unless the output file is specified using
              the -o option.

       -o path, --out=path
              Specifies an alternate path  to  place  the  .dSYM  bundle.  The
              default  dSYM bundle path is created by appending a.dSYMa to the
              executable name.

       --oso-prepend-path=dir
              Specifies a path to prepend to  all  debug  symbol  object  file
              paths.

       -s, --symtab
              Dumps the symbol table found in executable or object file(s) and
              exits.

       -t n, --threads=n
              Specifies the maximum number (n) of simultaneous threads to  use
              when linking multiple architectures.

       -v, --version
              Display the current version of llvm-dsymutil.

       --verbose
              Display verbose information when linking.

       -u, --update
              Update  an  existing dSYM file to contain the latest accelerator
              tables and other DWARF optimizations. This option  will  rebuild
              the a.apple_namesa and a.apple_typesa hashed accelerator tables.

       --minimize
              When used when creating a dSYM file, this option  will  suppress
              the  emission  of  the  a.debug_pubnamesa, and a.debug_pubtypesa
              sections   since   llvm-dsymutil   has    better    equivalents:
              a.apple_namesa and a.apple_typesa. When used in conjunction with
              aupdate option, this option  will  cause  redundant  accelerator
              tables to be removed.

       --symbol-map=*bcsymbolmap*
              Either  pass  a  .bcsymbolmap file or a directory containing the
              collection of .bcsymbolmap files for the different  versions  or
              architectures of your binary to unobfuscate the passed exe_file.
              Implies -u.

       --dump-debug-map
              Dump the executable debug-map (the list of the object files con-
              taining the debug information) in YAML format and exit.

       -y     Treat exe_file as a YAML debug-map rather than an executable.


AUTHOR

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


COPYRIGHT

       2003-2017, LLVM Project



Apple LLVM 9.0.0                  2017-09-19                  llvm-dsymutil(1)

Mac OS X 10.12.6 - Generated Sun Oct 29 10:40:59 CDT 2017
© manpagez.com 2000-2021
Individual documents may contain additional copyright information.