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

FreeBSD Manual Pages

  
 
  

home | help
LLVM-READOBJ(1)			     LLVM		       LLVM-READOBJ(1)

NAME
       llvm-readobj - LLVM Object Reader

SYNOPSIS
       llvm-readobj [options] [input...]

DESCRIPTION
       The  llvm-readobj  tool	displays low-level format-specific information
       about one or more object	files.

       If input	is "-",	llvm-readobj reads from	standard input.	Otherwise,  it
       will read from the specified filenames.

DIFFERENCES TO LLVM-READELF
       llvm-readelf is an alias	for the	llvm-readobj tool with a slightly dif-
       ferent  command-line interface and output that is GNU compatible.  Fol-
       lowing is a list	of differences between llvm-readelf and	llvm-readobj:

        llvm-readelf uses GNU for the --elf-output-style option  by  default.
	 llvm-readobj uses LLVM.

        llvm-readelf  allows  single-letter grouped flags (e.g.  llvm-readelf
	 -SW is	the same as  llvm-readelf -S -W).  llvm-readobj	does not allow
	 grouping.

        llvm-readelf provides -s as an	alias for --symbols, for  GNU  readelf
	 compatibility,	 whereas  it  is  an  alias  for  --section-headers in
	 llvm-readobj.

        llvm-readobj provides -t as an	 alias	for  --symbols.	  llvm-readelf
	 does not.

        llvm-readobj  provides	 --sr,	--sd,  --st  and  --dt	as aliases for
	 --section-relocations,	   --section-data,    --section-symbols	   and
	 --dyn-symbols	respectively.	llvm-readelf  does  not	 provide these
	 aliases, to avoid conflicting with grouped flags.

GENERAL	AND MULTI-FORMAT OPTIONS
       These options are applicable to more than one file format, or are unre-
       lated to	file formats.

       --all  Equivalent to specifying all the main display  options  relevant
	      to the file format.

       --addrsig
	      Display the address-significance table.

       --decompress, -z
	      Dump  decompressed  section content when used with -x or -p.  If
	      the section(s) are not compressed, they are displayed as is.

       --expand-relocs
	      When used	with --relocs, display each relocation in an  expanded
	      multi-line format.

       --file-header, -h
	      Display file headers.

       --headers, -e
	      Equivalent  to  setting:	--file-header,	--program-headers, and
	      --sections.

       --help Display a	summary	of command line	options.

       --hex-dump=<section[,section,...]>, -x
	      Display the specified section(s) as hexadecimal  bytes.  section
	      may be a section index or	section	name.

	      --memtag

	      Display  information about memory	tagging	present	in the binary.
	      This includes various memtag-specific dynamic  entries,  decoded
	      global  descriptor  sections,  and  decoded Android-specific ELF
	      notes.

       --needed-libs
	      Display the needed libraries.

       --relocations, --relocs,	-r
	      Display the relocation entries in	the file.

       --sections, --section-headers, -S
	      Display all sections.

       --section-data, --sd
	      When used	with --sections, display section data for each section
	      shown. This option has no	effect for GNU style output.

       --section-relocations, --sr
	      When used	with --sections, display relocations for each  section
	      shown. This option has no	effect for GNU style output.

       --section-symbols, --st
	      When  used  with	--sections,  display  symbols for each section
	      shown.  This option has no effect	for GNU	style output.

       --sort-symbols=<sort_key[,sort_key]>
	      Specify the keys	to  sort  symbols  before  displaying  symtab.
	      Valid values for sort_key	are name and type.

       --stackmap
	      Display contents of the stackmap section.

       --string-dump=<section[,section,...]>, -p
	      Display  the  specified section(s) as a list of strings. section
	      may be a section index or	section	name.

       --string-table
	      Display contents of the string table.

       --symbols, --syms, -s
	      Display the symbol table.

       --unwind, -u
	      Display unwind information.

       --version
	      Display the version of the llvm-readobj executable.

       @<FILE>
	      Read command-line	options	from response file <FILE>.

ELF SPECIFIC OPTIONS
       The following options are implemented only for the ELF file format.

       --arch-specific,	-A
	      Display architecture-specific information, e.g. the ARM  attrib-
	      utes section on ARM.

       --bb-addr-map
	      Display  the contents of the basic block address map section(s),
	      which contain the	address	of each	function, along	with the rela-
	      tive offset of each basic	block.

       --demangle, -C
	      Display demangled	symbol names in	the output.

       --dependent-libraries
	      Display the dependent libraries section.

       --dyn-relocations
	      Display the dynamic relocation entries.

       --dyn-symbols, --dyn-syms, --dt
	      Display the dynamic symbol table.

       --dynamic-table,	--dynamic, -d
	      Display the dynamic table.

       --cg-profile
	      Display the callgraph profile section.

       --histogram, -I
	      Display a	bucket list histogram for dynamic symbol hash tables.

       --elf-linker-options
	      Display the linker options section.

       --elf-output-style=<value>
	      Format ELF information in	the specified style. Valid options are
	      LLVM, GNU, and JSON. LLVM	output (the default)  is  an  expanded
	      and  structured  format.	GNU  output  mimics the	equivalent GNU
	      readelf output. JSON is JSON formatted output intended  for  ma-
	      chine consumption.

       --section-groups, -g
	      Display section groups.

       --gnu-hash-table
	      Display the GNU hash table for dynamic symbols.

       --hash-symbols
	      Display the expanded hash	table with dynamic symbol data.

       --hash-table
	      Display the hash table for dynamic symbols.

       --memtag
	      Display  information about memory	tagging	present	in the binary.
	      This includes various dynamic entries, decoded global descriptor
	      sections,	and decoded Android-specific ELF notes.

       --notes,	-n
	      Display all notes.

       --pretty-print
	      When used	with --elf-output-style, JSON output will be formatted
	      in a more	readable format.

       --program-headers, --segments, -l
	      Display the program headers.

       --raw-relr
	      Do not decode relocations	in RELR	relocation sections when  dis-
	      playing them.

       --section-mapping
	      Display the section to segment mapping.

       --stack-sizes
	      Display  the  contents of	the stack sizes	section(s), i.e. pairs
	      of function names	and the	size of	their stack frames.  Currently
	      only implemented for GNU style output.

       --version-info, -V
	      Display version sections.

MACH-O SPECIFIC	OPTIONS
       The following options are implemented only for the Mach-O file format.

       --macho-data-in-code
	      Display the Data in Code command.

       --macho-dsymtab
	      Display the Dsymtab command.

       --macho-indirect-symbols
	      Display indirect symbols.

       --macho-linker-options
	      Display the Mach-O-specific linker options.

       --macho-segment
	      Display the Segment command.

       --macho-version-min
	      Display the version min command.

PE/COFF	SPECIFIC OPTIONS
       The following options are implemented only for the PE/COFF file format.

       --codeview
	      Display CodeView debug information.

       --codeview-ghash
	      Enable global hashing for	CodeView type stream de-duplication.

       --codeview-merged-types
	      Display the merged CodeView type stream.

       --codeview-subsection-bytes
	      Dump raw contents	of CodeView debug sections and records.

       --coff-basereloc
	      Display the .reloc section.

       --coff-debug-directory
	      Display the debug	directory.

       --coff-tls-directory
	      Display the TLS directory.

       --coff-directives
	      Display the .drectve section.

       --coff-exports
	      Display the export table.

       --coff-imports
	      Display the import table.

       --coff-load-config
	      Display the load config.

       --coff-resources
	      Display the .rsrc	section.

XCOFF SPECIFIC OPTIONS
       The following options are implemented only for the XCOFF	file format.

       --auxiliary-header
	      Display XCOFF Auxiliary header.

       --exception-section
	      Display XCOFF exception section entries.

       --loader-section-header
	      Display XCOFF loader section header.

       --loader-section-symbols
	      Display symbol table of loader section.

       --loader-section-relocations
	      Display relocation entries of loader section.

EXIT STATUS
       llvm-readobj  returns  0	 under normal operation. It returns a non-zero
       exit code if there were any errors.

SEE ALSO
       llvm-nm(1), llvm-objdump(1), llvm-readelf(1)

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

COPYRIGHT
       2003-2025, LLVM Project

18				  2025-04-13		       LLVM-READOBJ(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=llvm-readobj-cheriot&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help