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-2004 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 const char* MakeLabelName (unsigned Addr);
  90 /* Make the default label name from the given address and return it in a
  91  * static buffer.
  92  */
  93
  94 void AddLabel (unsigned Addr, attr_t Attr, const char* Name);
  95 /* Add a label */
  96
  97 void AddDepLabel (unsigned Addr, attr_t Attr, const char* BaseName, unsigned Offs);
  98 /* Add a dependent label at the given address using "base name+Offs" as the new
  99  * name.
 100  */
 101
 102 void AddIntLabelRange (unsigned Addr, const char* Name, unsigned Count);
 103 /* Add an internal label for a range. The first entry gets the label "Name"
 104  * while the others get "Name+offs".
 105  */
 106
 107 void AddExtLabelRange (unsigned Addr, const char* Name, unsigned Count);
 108 /* Add an external label for a range. The first entry gets the label "Name"
 109  * while the others get "Name+offs".
 110  */
 111
 112 int HaveLabel (unsigned Addr);
 113 /* Check if there is a label for the given address */
 114
 115 int MustDefLabel (unsigned Addr);
 116 /* Return true if we must define a label for this address, that is, if there
 117  * is a label at this address, and it is an external or internal label.
 118  */
 119
 120 const char* GetLabel (unsigned Addr);
 121 /* Return the label for an address or NULL if there is none */
 122
 123 unsigned char GetStyleAttr (unsigned Addr);
 124 /* Return the style attribute for the given address */
 125
 126 unsigned char GetLabelAttr (unsigned Addr);
 127 /* Return the label attribute for the given address */
 128
 129 void DefOutOfRangeLabels (void);
 130 /* Output any labels that are out of the loaded code range */
 131
 132
 133
 134 /* End of attrtab.h */
 135 #endif
 136
 137
 138