RealView® Developer Kit Command Line Reference Guide 2.3.46. DTFILE

2.3.46. DTFILE

The DTFILE command 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 direct its output. This must be a user-defined windowid or fileid. See Window and file numbers for details.

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 pane.

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 quotes 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 illustrates the output of DTFILE, displaying information about a loaded executable called shapes.axf.

> dtfile =1
File 1 with modid 1: Symbols Loaded. 2 Sections.
  'shapes.axf' As 'c:\src\cpp\shapes_Data\DebugRel\shapes.axf'
  Code section of size 10732 at 0x00008000: ER_RO
  BSS  section of size   356 at 0x0000A9EC: ER_ZI

Alias

DMAP and DVFILE are aliases of DTFILE.

Copyright © 2005, 2006 ARM Limited. All rights reserved.	ARM DUI 0284C
Non-Confidential
PDF version

2.3.46. DTFILE

Syntax

Description

Example

Alias

See also