2.3.52. DTFILE

Displays information about one or more specified files or all files of the current process.

Syntax

DTFILE [=file_num,...] [{;windowid | ;fileid}]

where:

file_num

One or more integer numbers that identify the file or files about which you want to see information. If you do not supply this parameter, details of all the currently loaded files are displayed.

windowid | fileid

Identifies the window or file where the command is to send the output.

If you do not supply a windowid or fileid parameter, output is displayed on the screen. If you are using the GUI, then the output is displayed in the Output view.

Description

The DTFILE command displays information about the currently loaded executable file. The file numbers are the same as those used in the ADDFILE and DELFILE commands. The information displayed varies:

  • if the file has been loaded onto the target, then the information contains details about the code and data section sizes and the load addresses

  • if the file has not been loaded, the debugger has not yet determined the code and data sizes and so does not display them.

The first line of the output includes the following information:

File file_num

Used by the ADDFILE, DELFILE, RELOAD and UNLOAD commands to refer to the file.

modid num

An internal number.

Symbols Loaded

This item tells you whether the executable file has program debug symbols and whether they have been loaded. In most cases you require debug symbols to make sense of the program instructions.

n sections

This item tells you how many program sections there are in the file. Each loaded program section is normally listed with any associated information.

The second line of output contains first the shortname and then the file path name of the file. The short name is an abbreviation of the name, normally the filename with no directory specification. The file path name includes the full directory path name for the file. You must normally specify the file path name enclosed in double quotation marks when entering it in commands.

If a file was built with separate load regions defined, these load regions are also shown in the output.

Example

The following example shows the output of DTFILE, displaying information about a loaded executable called shapes.axf.

> dtfile =1
File 1 with modid 1: Symbols Loaded. 3 Sections.
  'shapes.axf' As 'c:\src\cpp\shapes_Data\Debug\shapes.axf'
  Code section of size 0x02154 at 0x00008000: ER_RO
  Data section of size 0x00018 at 0x0000A154: ER_RW
  BSS  section of size 0x00190 at 0x0000A16C: ER_ZI

Alias

DMAP and DVFILE are aliases of DTFILE.

See also

Copyright © 2002-2011 ARM. All rights reserved.ARM DUI 0175N
Non-ConfidentialID052111