git.sur5r.net Git - cc65/blob - src/da65/attrtab.h

   1 /*****************************************************************************/
   2 /*                                                                           */
   3 /*                                 attrtab.h                                 */
   4 /*                                                                           */
   5 /*                       Disassembler attribute table                        */
   6 /*                                                                           */
   7 /*                                                                           */
   8 /*                                                                           */
   9 /* (C) 2000-2005 Ullrich von Bassewitz                                       */
  10 /*               Römerstrasse 52                                             */
  11 /*               D-70794 Filderstadt                                         */
  12 /* EMail:        uz@cc65.org                                                 */
  13 /*                                                                           */
  14 /*                                                                           */
  15 /* This software is provided 'as-is', without any expressed or implied       */
  16 /* warranty.  In no event will the authors be held liable for any damages    */
  17 /* arising from the use of this software.                                    */
  18 /*                                                                           */
  19 /* Permission is granted to anyone to use this software for any purpose,     */
  20 /* including commercial applications, and to alter it and redistribute it    */
  21 /* freely, subject to the following restrictions:                            */
  22 /*                                                                           */
  23 /* 1. The origin of this software must not be misrepresented; you must not   */
  24 /*    claim that you wrote the original software. If you use this software   */
  25 /*    in a product, an acknowledgment in the product documentation would be  */
  26 /*    appreciated but is not required.                                       */
  27 /* 2. Altered source versions must be plainly marked as such, and must not   */
  28 /*    be misrepresented as being the original software.                      */
  29 /* 3. This notice may not be removed or altered from any source              */
  30 /*    distribution.                                                          */
  31 /*                                                                           */
  32 /*****************************************************************************/
  33
  34
  35
  36 #ifndef ATTRTAB_H
  37 #define ATTRTAB_H
  38
  39
  40
  41 /*****************************************************************************/
  42 /*                                   Data                                    */
  43 /*****************************************************************************/
  44
  45
  46
  47 typedef enum attr_t {
  48
  49     /* Styles */
  50     atDefault   = 0x00,         /* Default style */
  51     atCode      = 0x01,
  52     atIllegal   = 0x02,
  53     atByteTab   = 0x03,         /* Same as illegal */
  54     atDByteTab  = 0x04,
  55     atWordTab   = 0x05,
  56     atDWordTab  = 0x06,
  57     atAddrTab   = 0x07,
  58     atRtsTab    = 0x08,
  59     atTextTab   = 0x09,
  60     atSkip      = 0x0A,         /* Skip code completely */
  61
  62     /* Label flags */
  63     atNoLabel   = 0x00,         /* No label for this address */
  64     atExtLabel  = 0x10,         /* External label */
  65     atIntLabel  = 0x20,         /* Internally generated label */
  66     atDepLabel  = 0x40,         /* Dependent label */
  67
  68     atStyleMask = 0x0F,         /* Output style */
  69     atLabelMask = 0x70          /* Label information */
  70 } attr_t;
  71
  72
  73
  74 /*****************************************************************************/
  75 /*                                   Code                                    */
  76 /*****************************************************************************/
  77
  78
  79
  80 unsigned GetGranularity (attr_t Style);
  81 /* Get the granularity for the given style */
  82
  83 void MarkRange (unsigned Start, unsigned End, attr_t Attr);
  84 /* Mark a range with the given attribute */
  85
  86 void MarkAddr (unsigned Addr, attr_t Attr);
  87 /* Mark an address with an attribute */
  88
  89 void AddLabel (unsigned Addr, attr_t Attr, const char* Name, const char* Comment);
  90 /* Add a label */
  91
  92 void AddIntLabel (unsigned Addr);
  93 /* Add an internal label using the address to generate the name. */
  94
  95 void AddExtLabel (unsigned Addr, const char* Name, const char* Comment);
  96 /* Add an external label */
  97
  98 void AddDepLabel (unsigned Addr, attr_t Attr, const char* BaseName, unsigned Offs);
  99 /* Add a dependent label at the given address using "base name+Offs" as the new
 100  * name.
 101  */
 102
 103 void AddIntLabelRange (unsigned Addr, const char* Name, unsigned Count);
 104 /* Add an internal label for a range. The first entry gets the label "Name"
 105  * while the others get "Name+offs".
 106  */
 107
 108 void AddExtLabelRange (unsigned Addr, const char* Name, const char* Comment, unsigned Count);
 109 /* Add an external label for a range. The first entry gets the label "Name"
 110  * while the others get "Name+offs".
 111  */
 112
 113 int HaveLabel (unsigned Addr);
 114 /* Check if there is a label for the given address */
 115
 116 int MustDefLabel (unsigned Addr);
 117 /* Return true if we must define a label for this address, that is, if there
 118  * is a label at this address, and it is an external or internal label.
 119  */
 120
 121 const char* GetLabel (unsigned Addr);
 122 /* Return the label for an address or NULL if there is none */
 123
 124 const char* GetComment (unsigned Addr);
 125 /* Return the comment for an address */
 126
 127 unsigned char GetStyleAttr (unsigned Addr);
 128 /* Return the style attribute for the given address */
 129
 130 unsigned char GetLabelAttr (unsigned Addr);
 131 /* Return the label attribute for the given address */
 132
 133 void DefOutOfRangeLabels (void);
 134 /* Output any labels that are out of the loaded code range */
 135
 136
 137
 138 /* End of attrtab.h */
 139 #endif
 140
 141
 142