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.
| Option | Function |
|---|---|
@FILE |
Read options from
FILE. |
-a
|
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 xc-dsc-ar
tv, xc-dsc-objdump
-a shows the object file format of each archive member. |
-d
|
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
|
Like -d, but disassemble the
contents of all sections, not just those expected to contain
instructions. |
-EB
|
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
|
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
|
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
|
Display summary information from the section headers of the object file. |
-H
|
Print a summary of the options to xc-dsc-objdump and
exit. |
-I
DIR
|
Add DIR to search list for
source files. |
-j name
|
Display information only for section name. |
-l
|
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
|
Pass target specific information to the disassembler. The dsPIC30F device supports the following target specific options: symbolic - Will perform symbolic disassembly. |
--no-file-offsets |
Do not include file offsets when displaying information. |
--prefix-addresses |
When 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
|
Print the relocation entries of the file. If
used with -d or -D, the relocations are
printed interspersed with the disassembly. |
-s
|
Display the full contents of any sections requested. |
-S
|
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
|
Print the symbol table entries of the file.
This is similar to the information provided by the xc-dsc-nm program. |
-V
|
Print the version number of xc-dsc-objdump and
exit. |
-w
|
Format some lines for output devices that have more than 80 columns. |
-W
|
Displays the contents of the DWARF debug sections in the file, if any are present. |
-x
|
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
|
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 00000000 00000000 00000288 2**1
CONTENTS, ALLOC, LOAD, CODE
1 .text 00000576 00000100 00000100 00000290 2**1
CONTENTS, ALLOC, LOAD, CODE
2 .comment 0000005e 00000000 00000000 00000d7c 2**1
CONTENTS, NEVER_LOAD
3 .ivt 0000007c 00000004 00000004 00000e38 2**1
CONTENTS, ALLOC, LOAD, CODE
4 .aivt 0000007c 00000084 00000084 00000f30 2**1
CONTENTS, ALLOC, LOAD, CODE
5 __c30_signature 0000007e 0000005e 0000005e 00001028 2**1
CONTENTS, DEBUGGING
6 .data 0000008e 00000800 00000800 00001124 2**1
CONTENTS, ALLOC, DATA, NEVER_LOAD
7 .bss 00000002 0000088e 0000088e 00000000 2**1
ALLOC
8 .data 00000002 00000890 00000890 00001240 2**1
CONTENTS, ALLOC, DATA, NEVER_LOAD
9 .bss 00000002 00000892 00000892 00000000 2**1
ALLOC
10 .heap 00000080 00000894 00000894 00000000 2**1
ALLOC
11 .const 00000008 00008676 00000676 00001244 2**1
CONTENTS, ALLOC, LOAD, READONLY, PSV
12 .dinit 00000082 0000067e 0000067e 00001254 2**1
CONTENTS, ALLOC, LOAD, CODE
13 .text 0000000a 00000700 00000700 00001358 2**1
CONTENTS, ALLOC, LOAD, CODE
14 .isr 00000002 0000070a 0000070a 0000136c 2**1
CONTENTS, ALLOC, LOAD, CODE