16.3.3 Options

The long and short forms of options, shown in the table below, 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 16-5. xc32-objdump Options
OptionFunction
@FILERead options from FILE.
-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

--disassemble=symbol

Display the assembler mnemonics for the machine instructions from the input file. This option only disassembles those sections which are expected to contain instructions. If the optional symbol argument is given, then display the assembler mnemonics starting at symbol. If symbol is a function name then disassembly will stop at the end of the function; otherwise it will stop when the next symbol is encountered. If there are no matches for symbol then nothing will be displayed.
-D

--disassemble-all

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

-EL

--endian={big|little}

Specify the endianness of the object files. This only affects disassembly. This can be useful when disassembling a file format that does not describe endianness information, such as S-records.
-f

--file-header

Display summary information from the overall header of each of the OBJFILE files.
--file-start-contextSpecify 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.
-H

--help

Print a summary of the options to xc32-objdump and exit.
-I DIR

--include=DIR

Add DIR to search list for source files.
-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 dsPIC30F device supports the following target specific options:

symbolic - Will perform symbolic disassembly.

--no-file-offsetsDo not include file offsets when displaying information.
--prefix-addressesWhen disassembling, print the complete address on each line. This is the older disassembly format.
--psrd-psrd-check
 [=library]Check for back-to-back data flash reads. Specifying the optional =library should be used on unlinked object files (such as a library). This option can be combined with -d to get a disassembly listing with additional information.
-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-insnWhen 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-insnWhen disassembling instructions, do not print the instruction bytes. This is the default when --prefix-addresses is used.
--start-address=addressStart displaying data at the specified address. This affects the output of the -d, -r and -s options.
--stop-address=addressStop 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.
-W

--dwarf

Displays the contents of the DWARF debug sections in the file, if any are present.
-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 zeroes. This option directs the disassembler to disassemble those blocks, just like any other data.

-h OUTPUT

hello.out:     file format elf32-pic30

Sections:
Idx Name          Size      VMA       LMA       File off  Algn
  0 .reset        00000004  00800000  00800000  000000f8  2**1
                  CONTENTS, ALLOC, LOAD, CODE, ABSOLUTE
  1 .text         00000640  00800480  00800480  00000578  2**1
                  CONTENTS, ALLOC, LOAD, CODE, ABSOLUTE
  2 .comment      00000688  00000000  00000000  00000c88  2**1
                  CONTENTS, DATA, NEVER_LOAD, ABSOLUTE
  3 __c30_signature 0000007e  00000000  00000000  00001310  2**0
                  CONTENTS, DEBUGGING, ABSOLUTE
  4 .data         00000074  00004000  00004000  00000074  2**1
                  CONTENTS, ALLOC, DATA, NEVER_LOAD
  5 .bss          0000000c  00004074  00004074  000000e8  2**1
                  ALLOC
  6 .data         00000004  00004080  00004080  000000f4  2**1
                  CONTENTS, ALLOC, DATA, NEVER_LOAD
  7 __ivt_0       0000047c  00800004  00800004  000000fc  2**1
                  CONTENTS, ALLOC, LOAD, CODE, ABSOLUTE
  8 .dinit        000000ac  00800ac0  00800ac0  00000bb8  2**1
                  CONTENTS, ALLOC, LOAD, CODE, ABSOLUTE
  9 .text         00000014  00800b6c  00800b6c  00000c64  2**1
                  CONTENTS, ALLOC, LOAD, CODE, ABSOLUTE
 10 hello.s.scn1  00000010  00800b80  00800b80  00000c78  2**1
                  CONTENTS, ALLOC, LOAD, CODE, ABSOLUTE