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

FreeBSD Manual Pages


home | help
DSYMUTIL(1)			     LLVM			   DSYMUTIL(1)

       dsymutil	- manipulate archived DWARF debug symbol files

       dsymutil	[options] executable

       dsymutil	 links	the  DWARF debug information found in the object files
       for an executable executable by using debug  symbols  information  con-
       tained in its symbol table. By default, the linked debug	information is
       placed in a .dSYM bundle	with the same name as the executable.

       --accelerator=<accelerator type>
	      Specify the desired type of accelerator table. Valid options are
	      'Apple', 'Dwarf' and 'Default'.

       --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 architectures
	      will be linked by	default	and any	architectures  that  can't  be
	      properly linked will cause dsymutil to return an error.

	      Dump  the	 executable's  debug-map (the list of the object files
	      containing the debug information)	in YAML	format and  exit.  Not
	      DWARF link will take place.

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

	      Generate a reproducer consisting of the input object files.

       --help, -h
	      Print this help output.

	      Make  a  static  variable	keep the enclosing function even if it
	      would have been omitted otherwise.

       --minimize, -z
	      When used	when creating a	dSYM file, this	option	will  suppress
	      the  emission  of	 the .debug_inlines, .debug_pubnames, and .de-
	      bug_pubtypes sections since dsymutil currently has better	equiv-
	      alents:  .apple_names and	.apple_types. When used	in conjunction
	      with --update option, this option	will cause redundant accelera-
	      tor tables to be removed.

	      Do not use ODR (One Definition Rule) for uniquing	C++ types.

	      Do the link in memory, but do not	emit the result	file.

	      Don't check the timestamp	for swiftmodule	files.

       --num-threads <threads>,	-j <threads>
	      Specifies	 the maximum number (n)	of simultaneous	threads	to use
	      when linking multiple architectures.

       --object-prefix-map <prefix=remapped>
	      Remap object file	paths (but no source paths) before processing.
	      Use  this	 for Clang objects where the module cache location was
	      remapped using -fdebug-prefix-map; to  help  dsymutil  find  the
	      Clang module cache.

       --oso-prepend-path <path>
	      Specifies	 a  path  to  prepend  to all debug symbol object file

       --out <filename>, -o <filename>
	      Specifies	an alternate path to place the dSYM  bundle.  The  de-
	      fault dSYM bundle	path is	created	by appending .dSYM to the exe-
	      cutable name.

	      When running dsymutil as part of your build system,  it  can  be
	      desirable	 for  warnings	to  be part of the end product,	rather
	      than just	being emitted to the output stream. When enabled warn-
	      ings are embedded	in the linked DWARF debug information.

       --remarks-output-format <format>
	      Specify  the  format  to be used when serializing	the linked re-

       --remarks-prepend-path <path>
	      Specify a	directory to prepend the paths of the external	remark

	      Print  statistics	 about the contribution	of each	object file to
	      the linked debug info. This prints a table  after	 linking  with
	      the  object  file	name, the size of the debug info in the	object
	      file (in bytes) and the  size  contributed  (in  bytes)  to  the
	      linked  dSYM. The	table is sorted	by the output size listing the
	      object files with	the largest contribution first.

       --symbol-map <bcsymbolmap>
	      Update the existing dSYMs	inplace	using symbol map specified.

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

       -S     Output textual assembly instead of a binary dSYM companion file.

       --toolchain <toolchain>
	      Embed the	toolchain in the dSYM bundle's property	list.

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

       --use-reproducer	<path>
	      Use the object files from	the given reproducer path.

	      Display verbose information when linking.

	      Run the DWARF verifier on	the linked DWARF debug info.

       -v, --version
	      Display the version of the tool.

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

       dsymutil	 returns  0 if the DWARF debug information was linked success-
       fully. Otherwise, it returns 1.


       Maintained by the LLVM Team (

       2003-2021, LLVM Project

13				  2021-11-04			   DSYMUTIL(1)


Want to link to this manual page? Use this URL:

home | help