dwarf2dbg.h   [plain text]

/* dwarf2dbg.h - DWARF2 debug support
   Copyright 1999, 2000, 2002, 2003 Free Software Foundation, Inc.

   This file is part of GAS, the GNU Assembler.

   GAS is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation; either version 2, or (at your option)
   any later version.

   GAS is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   GNU General Public License for more details.

   You should have received a copy of the GNU General Public License
   along with GAS; see the file COPYING.  If not, write to the Free
   Software Foundation, 51 Franklin Street - Fifth Floor, Boston, MA
   02110-1301, USA.  */

#ifndef AS_DWARF2DBG_H
#define AS_DWARF2DBG_H

/* HACKS for bfd_* and BFD_RELOC_* These would come from bfd/reloc.c */
typedef int bfd_boolean;

#include "as.h"

#define DWARF2_FLAG_IS_STMT		(1 << 0)
#define DWARF2_FLAG_BASIC_BLOCK		(1 << 1)
#define DWARF2_FLAG_PROLOGUE_END	(1 << 2)

struct dwarf2_line_info {
  unsigned int filenum;
  unsigned int line;
  unsigned int column;
  unsigned int isa;
  unsigned int flags;

/* When creating dwarf2 debugging information for assembly files, the variable
   dwarf2_file_number is used to generate a .file for each assembly source file
   in read_a_source_file() in read.c .  */
extern uint32_t dwarf2_file_number;

/* Info that is needed to be gathered for each symbol that will have a 
   dwarf2_subprogram when generating debug info directly for assembly files.
   This is done in make_subprogram_for_symbol() in symbols.c . */
struct dwarf2_subprogram_info {
    char *name; /* without a leading underbar, if any */
    uint32_t file_number; /* the dwarf file number this symbol is in */
    uint32_t line_number; /* the line number this symbol is at */
     * The low_pc for the dwarf2_subprogram is taken from the symbol's
     * n_value.  The high_pc is taken from the next symbol's value or
     * the end of the section for the last symbol.
    symbolS *symbol;
    struct dwarf2_subprogram_info *next;
extern struct dwarf2_subprogram_info *dwarf2_subprograms_info;

/* Implements the .file FILENO "FILENAME" directive.  FILENO can be 0
   to indicate that no file number has been assigned.  All real file
   number must be >0.  */
extern char *dwarf2_directive_file (uintptr_t dummy);

 * dwarf2_file() is what is called when generating
 * debug info directly for assembly files with --gdwarf2.
extern void dwarf2_file (char *filename, offsetT num);

/* Implements the .loc FILENO LINENO [COLUMN] directive.  FILENO is
   the file number, LINENO the line number and the (optional) COLUMN
   the column of the source code that the following instruction
   corresponds to.  FILENO can be 0 to indicate that the filename
   specified by the textually most recent .file directive should be
   used.  */
extern void dwarf2_directive_loc (uintptr_t dummy);

 * dwarf2_loc() is what is called when generating
 * debug info directly for assembly files with --gdwarf2.
extern void dwarf2_loc (offsetT filenum, offsetT line);

/* Implements the .loc_mark_labels {0,1} directive.  */
extern void dwarf2_directive_loc_mark_labels (uintptr_t dummy);

/* Returns the current source information.  If .file directives have
   been encountered, the info for the corresponding source file is
   returned.  Otherwise, the info for the assembly source file is
   returned.  */
extern void dwarf2_where (struct dwarf2_line_info *l);

/* A hook to allow the target backend to inform the line number state 
   machine of isa changes when assembler debug info is enabled.  */
extern void dwarf2_set_isa (unsigned int isa);

/* This function generates .debug_line info based on the address and
   source information passed in the arguments.  ADDR should be the
   frag-relative offset of the instruction the information is for and
   L is the source information that should be associated with that
   address.  */
extern void dwarf2_gen_line_info (addressT addr, struct dwarf2_line_info *l);

/* Must be called for each generated instruction.  */
extern void dwarf2_emit_insn (int);

/* Should be called for each code label.  */
extern void dwarf2_emit_label (symbolS *);

/* True when we're supposed to set the basic block mark whenever a label
   is seen.  Unless the target is doing Something Weird, just call 
   dwarf2_emit_label.  */
bfd_boolean dwarf2_loc_mark_labels;

extern void dwarf2_finish (void);

extern int dwarf2dbg_estimate_size_before_relax (fragS *);
extern int dwarf2dbg_relax_frag (fragS *);
extern void dwarf2dbg_convert_frag (fragS *);

/* An enumeration which describes the sizes of offsets (to DWARF sections)
   and the mechanism by which the size is indicated.  */
enum dwarf2_format {
  /* 32-bit format: the initial length field is 4 bytes long.  */
  /* DWARF3 64-bit format: the representation of the initial length
     (of a DWARF section) is 0xffffffff (4 bytes) followed by eight
     bytes indicating the actual length.  */
  /* SGI extension to DWARF2: The initial length is eight bytes.  */

#endif /* AS_DWARF2DBG_H */