14.3.3 Options

The long and short forms of options, shown in the following table, as alternatives, are equivalent. At least one of the following options -a, -d, -D, -f, -g, -G, -h, -H, -p, -r, -R, -S, -t, -T, -V or -x must be given.

Table 14-5. XC32-OBJDUMP Options
Option Function
-a

--archive-header

 If any of the OBJFILE files are archives, display the archive header information (in a format similar to ls -l). Besides the information you could list with xc32-ar tv, xc32-objdump -a shows the object file format of each archive member.
-d

--disassemble

 Display the assembler mnemonics for the machine instructions from OBJFILE. This option only disassembles those sections that are expected to contain instructions.
-D

--disassemble-all

 Like -d, but disassemble the contents of all sections, not just those expected to contain instructions.
-f

--file-header

 Display summary information from the overall header of each of the OBJFILE files.
--file-start-context Specify that when displaying inter-listed source code/disassembly (assumes -S) from a file that has not yet been displayed, extend the context to the start of the file.
-g

--debugging

 Display debugging information. This attempts to parse debugging information stored in the file and print it out using a C like syntax. Only certain types of debugging information have been implemented.
-h

--section-header

--header

 Display summary information from the section headers of the object file.

File segments may be relocated to nonstandard addresses, for example by using the -Ttext, -Tdata or -Tbss options to ld. However, some object file formats, such as a.out, do not store the starting address of the file segments. In those situations, although ld relocates the sections correctly, using xc32-objdump -h to list the file section headers cannot show the correct addresses. Instead, it shows the usual addresses, which are implicit for the target.
-H

--help

 Print a summary of the options to xc32-objdump and exit.
-j name

--section=name

 Display information only for section name.
-l

--line-numbers

 Label the display (using debugging information) with the filename and source line numbers corresponding to the object code or relocs shown. Only useful with -d, -D or -r.
-M options

--disassembler-
 options=options

 Pass target specific information to the disassembler. The PIC32 device supports the following target specific options:

symbolic - Will perform symbolic disassembly.
--prefix-addresses When disassembling, print the complete address on each line. This is the older disassembly format.
-r

--reloc

 Print the relocation entries of the file. If used with -d or -D, the relocations are printed interspersed with the disassembly.
-s

--full-contents

 Display the full contents of any sections requested.
-S

--source

 Display source code intermixed with disassembly, if possible. Implies -d.
--show-raw-insn When disassembling instructions, print the instruction in hex, as well as in symbolic form. This is the default except when --prefix-addresses is used.
--no-show-raw-insn When disassembling instructions, do not print the instruction bytes. This is the default when --prefix-addresses is used.
--start-address=address Start displaying data at the specified address. This affects the output of the -d, -r and -s options.
--stop-address=address Stop displaying data at the specified address. This affects the output of the -d, -r and -s options.
-t

--syms

 Print the symbol table entries of the file. This is similar to the information provided by the xc32-nm program.
-V

--version

 Print the version number of xc32-objdump and exit.
-w

--wide

 Format some lines for output devices that have more than 80 columns.
-x

--all-header

 Display all available header information, including the symbol table and relocation entries. Using -x is equivalent to specifying all of -a -f -h -r -t.
-z

--disassemble-zeroes

 Normally the disassembly output will skip blocks of zeros. This option directs the disassembler to disassemble those blocks, just like any other data.