gccint: File Names and DBX

1 
1 18.21.4 File Names in DBX Format
1 --------------------------------
1 
1 This describes file names in DBX format.
1 
1  -- Macro: DBX_OUTPUT_MAIN_SOURCE_FILENAME (STREAM, NAME)
1      A C statement to output DBX debugging information to the stdio
1      stream STREAM, which indicates that file NAME is the main source
1      file--the file specified as the input file for compilation.  This
1      macro is called only once, at the beginning of compilation.
1 
1      This macro need not be defined if the standard form of output for
1      DBX debugging information is appropriate.
1 
1      It may be necessary to refer to a label equal to the beginning of
1      the text section.  You can use 'assemble_name (stream,
1      ltext_label_name)' to do so.  If you do this, you must also set the
1      variable USED_LTEXT_LABEL_NAME to 'true'.
1 
1  -- Macro: NO_DBX_MAIN_SOURCE_DIRECTORY
1      Define this macro, with value 1, if GCC should not emit an
1      indication of the current directory for compilation and current
1      source language at the beginning of the file.
1 
1  -- Macro: NO_DBX_GCC_MARKER
1      Define this macro, with value 1, if GCC should not emit an
1      indication that this object file was compiled by GCC.  The default
1      is to emit an 'N_OPT' stab at the beginning of every source file,
1      with 'gcc2_compiled.' for the string and value 0.
1 
1  -- Macro: DBX_OUTPUT_MAIN_SOURCE_FILE_END (STREAM, NAME)
1      A C statement to output DBX debugging information at the end of
1      compilation of the main source file NAME.  Output should be written
1      to the stdio stream STREAM.
1 
1      If you don't define this macro, nothing special is output at the
1      end of compilation, which is correct for most machines.
1 
1  -- Macro: DBX_OUTPUT_NULL_N_SO_AT_MAIN_SOURCE_FILE_END
1      Define this macro _instead of_ defining
1      'DBX_OUTPUT_MAIN_SOURCE_FILE_END', if what needs to be output at
1      the end of compilation is an 'N_SO' stab with an empty string,
1      whose value is the highest absolute text address in the file.
1