.file

Specifies the source code file; enables correlation of generated assembly code and source

code.

  .file "filename"
    
Parameter

filename

Name of source-code file, in double quotes.

Remarks

If you do not have .line directives in your code, using a .file directive will prevent the assembler from generating DWARF .debug_line information, and lines in the source file will not appear during debugging.

If you do have .line directives in your code, it is not necessary to use the .file directive, as the .function directive will provide source-level debugging.

Example

The following listing shows how to use the .file directive for your own DWARF code.

Listing: File directive for DWARF code


.file "MyFile.c"

.text

.function "MyFunction",start,end-start

start:

.line 5

ldr r3,[r2]

.line 7

blx

end: