aboutsummaryrefslogtreecommitdiff
path: root/gdb/osdata.h
AgeCommit message (Expand)AuthorFilesLines
2024-01-12Update copyright year range in header of all files managed by GDBAndrew Burgess1-1/+1
2023-01-01Update copyright year range in header of all files managed by GDBJoel Brobecker1-1/+1
2022-01-01Automatic Copyright Year update after running gdb/copyright.pyJoel Brobecker1-1/+1
2021-01-01Update copyright year range in all GDB filesJoel Brobecker1-1/+1
2020-01-01Update copyright year range in all GDB files.Joel Brobecker1-1/+1
2019-01-01Update copyright year range in all GDB files.Joel Brobecker1-1/+1
2018-01-02Update copyright year range in all GDB filesJoel Brobecker1-1/+1
2017-11-22C++ify osdataSimon Marchi1-20/+22
2017-04-05-Wwrite-strings: MI -info-osPedro Alves1-1/+5
2017-01-01update copyright year range in GDB filesJoel Brobecker1-1/+1
2016-01-01GDB copyright headers update after running GDB's copyright.py script.Joel Brobecker1-1/+1
2015-01-01Update year range in copyright notice of all files owned by the GDB project.Joel Brobecker1-1/+1
2014-01-01Update Copyright year range in all files maintained by GDB.Joel Brobecker1-1/+1
2013-01-01Update years in copyright notice for the GDB files.Joel Brobecker1-1/+1
2012-05-242012-05-23 Stan Shebs <stan@codesourcery.com>Stan Shebs1-0/+1
2012-01-04Copyright year update in most files of the GDB Project.Joel Brobecker1-1/+1
2011-01-01run copyright.sh for 2011.Joel Brobecker1-1/+1
2010-01-01Update copyright year in most headers.Joel Brobecker1-1/+1
2009-01-03 Updated copyright notices for most files.Joel Brobecker1-1/+1
2008-12-02 * target.h (target_get_osdata): Describe.Pedro Alves1-0/+1
2008-12-02 Implement -list-thread-groups --availableVladimir Prus1-0/+52
generated by cgit v1.1 at 2025-02-06 06:03:50 +0000
n251' href='#n251'>251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739 740 741 742 743 744 745 746 747 748 749 750 751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784 785 786 787 788 789 790 791 792 793 794 795 796 797 798 799 800 801 802 803 804 805 806 807 808 809 810 811 812 813 814 815 816 817 818 819 820 821 822 823 824 825 826 827 828 829 830 831 832 833 834 835 836 837 838 839 840 841 842 843 844 845 846 847 848 849 850 851 852 853 854 855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 882 883 884 885 886 887 888 889 890 891 892 893 894 895 896 897 898 899 900 901 902 903 904 905 906 907 908 909 910 911 912 913 914 915 916 917 918 919 920 921 922 923 924 925 926 927 928 929 930 931 932 933 934 935 936 937 938 939 940 941 942 943 944 945 946 947 948 949 950 951 952 953 954 955 956 957 958 959 960 961 962 963 964 965 966 967 968 969 970 971 972 973 974 975 976 977 978 979 980 981 982 983 984 985 986 987 988 989 990 991 992 993 994 995 996 997 998 999 1000 1001 1002 1003 1004 1005 1006 1007 1008 1009 1010 1011 1012 1013 1014 1015 1016 1017 1018 1019 1020 1021 1022 1023 1024 1025 1026 1027 1028 1029 1030 1031 1032 1033 1034 1035 1036 1037 1038 1039 1040 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050 1051 1052 1053 1054 1055 1056 1057 1058 1059 1060 1061 1062 1063 1064 1065 1066 1067 1068 1069 1070 1071 1072 1073 1074 1075 1076 1077 1078 1079 1080 1081 1082 1083 1084 1085 1086 1087 1088 1089 1090 1091 1092 1093 1094 1095 1096 1097 1098 1099 1100 1101 1102 1103 1104 1105 1106 1107 1108 1109 1110 1111 1112 1113 1114 1115 1116 1117 1118 1119 1120 1121 1122 1123 1124 1125 1126 1127 1128 1129 1130 1131 1132 1133 1134 1135 1136 1137 1138 1139 1140 1141 1142 1143 1144 1145 1146 1147 1148 1149 1150 1151 1152 1153 1154 1155 1156 1157 1158 1159 1160 1161 1162 1163 1164 1165 1166 1167 1168 1169 1170 1171 1172 1173 1174 1175 1176 1177 1178 1179 1180 1181 1182 1183 1184 1185 1186 1187 1188 1189 1190 1191 1192 1193 1194 1195 1196 1197 1198 1199 1200 1201 1202 1203 1204 1205 1206 1207 1208 1209 1210 1211 1212 1213 1214 1215 1216 1217 1218 1219 1220 1221 1222 1223 1224 1225 1226 1227 1228 1229 1230 1231 1232 1233 1234 1235 1236 1237 1238 1239 1240 1241 1242 1243 1244 1245 1246 1247 1248 1249 1250 1251 1252 1253 1254 1255 1256 1257 1258 1259 1260 1261 1262 1263 1264 1265 1266 1267 1268 1269 1270 1271 1272 1273 1274 1275 1276 1277 1278 1279 1280 1281 1282 1283 1284 1285 1286 1287 1288 1289 1290 1291 1292 1293 1294 1295 1296 1297 1298 1299 1300 1301 1302 1303 1304 1305 1306 1307 1308 1309 1310 1311 1312 1313 1314 1315 1316 1317 1318 1319 1320 1321 1322 1323 1324 1325 1326 1327 1328 1329 1330 1331 1332 1333 1334 1335 1336 1337 1338 1339 1340 1341 1342 1343 1344 1345 1346 1347 1348 1349 1350 1351 1352 1353 1354 1355 1356 1357 1358 1359 1360 1361 1362 1363 1364 1365 1366 1367 1368 1369 1370 1371 1372 1373 1374 1375 1376 1377 1378 1379 1380 1381 1382 1383 1384 1385 1386 1387 1388 1389 1390 1391 1392 1393 1394 1395 1396 1397 1398 1399 1400 1401 1402 1403 1404 1405 1406 1407 1408 1409 1410 1411 1412 1413 1414 1415 1416 1417 1418 1419 1420 1421 1422 1423 1424 1425 1426 1427 1428 1429 1430 1431 1432 1433 1434 1435 1436 1437 1438 1439 1440 1441 1442 1443 1444 1445 1446 1447 1448 1449 1450 1451 1452 1453 1454 1455 1456 1457 1458 1459 1460 1461 1462 1463 1464 1465 1466 1467 1468 1469 1470 1471 1472 1473 1474 1475 1476 1477 1478 1479 1480 1481 1482 1483 1484 1485 1486 1487 1488 1489 1490 1491 1492 1493 1494 1495 1496 1497 1498 1499 1500 1501 1502 1503 1504 1505 1506 1507 1508 1509 1510 1511 1512 1513 1514 1515 1516 1517 1518 1519 1520 1521 1522 1523 1524 1525 1526 1527 1528 1529 1530 1531 1532 1533 1534 1535 1536 1537 1538 1539 1540 1541 1542 1543 1544 1545 1546 1547 1548 1549 1550 1551 1552 1553 1554 1555 1556 1557 1558 1559 1560 1561 1562 1563 1564 1565 1566 1567 1568 1569 1570 1571 1572 1573 1574 1575 1576 1577 1578 1579 1580 1581 1582 1583 1584 1585 1586 1587 1588 1589 1590 1591 1592 1593 1594 1595 1596 1597 1598 1599 1600 1601 1602 1603 1604 1605 1606 1607 1608 1609 1610 1611 1612 1613 1614 1615 1616 1617 1618 1619 1620 1621 1622 1623 1624 1625 1626 1627 1628 1629 1630 1631 1632 1633 1634 1635 1636 1637 1638 1639 1640 1641 1642 1643 1644 1645 1646 1647 1648 1649 1650 1651 1652 1653 1654 1655 1656 1657 1658 1659 
/* <apollo/dst.h> */
/* Apollo object module DST (debug symbol table) description */

#ifndef apollo_dst_h
#define apollo_dst_h 

#if defined(apollo) && !defined(__GNUC__)
#define ALIGNED1  __attribute( (aligned(1)) )
#else
/* Remove attribute directives from non-Apollo code: */
#define ALIGNED1   /* nil */
#endif



/* Identification of this version of the debug symbol table.  Producers of the
   debug symbol table must write these values into the version number field of
   the compilation unit record in .blocks .
*/
#define dst_version_major    1    
#define dst_version_minor    3    


/*
** Enumeration of debug record types appearing in .blocks and .symbols ...
*/
typedef enum
    {
    dst_typ_pad,                   /*  0 */
    dst_typ_comp_unit,             /*  1 */
    dst_typ_section_tab,           /*  2 */
    dst_typ_file_tab,              /*  3 */
    dst_typ_block,                 /*  4 */
    dst_typ_5,
    dst_typ_var,
    dst_typ_pointer,               /*  7 */
    dst_typ_array,                 /*  8 */
    dst_typ_subrange,              /*  9 */
    dst_typ_set,                   /* 10 */
    dst_typ_implicit_enum,         /* 11 */
    dst_typ_explicit_enum,         /* 12 */
    dst_typ_short_rec,             /* 13 */
    dst_typ_old_record,
    dst_typ_short_union,           /* 15 */
    dst_typ_old_union,
    dst_typ_file,                  /* 17 */
    dst_typ_offset,                /* 18 */
    dst_typ_alias,                 /* 19 */
    dst_typ_signature,             /* 20 */
    dst_typ_21,
    dst_typ_old_label,		   /* 22 */
    dst_typ_scope,		   /* 23 */
    dst_typ_end_scope,             /* 24 */
    dst_typ_25,
    dst_typ_26,
    dst_typ_string_tab,            /* 27 */
    dst_typ_global_name_tab,       /* 28 */
    dst_typ_forward,               /* 29 */
    dst_typ_aux_size,              /* 30 */
    dst_typ_aux_align,             /* 31 */
    dst_typ_aux_field_size,        /* 32 */
    dst_typ_aux_field_off,         /* 33 */
    dst_typ_aux_field_align,       /* 34 */
    dst_typ_aux_qual,              /* 35 */
    dst_typ_aux_var_bound,         /* 36 */
    dst_typ_extension,             /* 37 */
    dst_typ_string,                /* 38 */
    dst_typ_old_entry,
    dst_typ_const,                 /* 40 */
    dst_typ_reference,             /* 41 */
    dst_typ_record,                /* 42 */
    dst_typ_union,                 /* 43 */
    dst_typ_aux_type_deriv,        /* 44 */
    dst_typ_locpool,               /* 45 */
    dst_typ_variable,              /* 46 */
    dst_typ_label,                 /* 47 */
    dst_typ_entry,                 /* 48 */
    dst_typ_aux_lifetime,          /* 49 */
    dst_typ_aux_ptr_base,          /* 50 */
    dst_typ_aux_src_range,         /* 51 */
    dst_typ_aux_reg_val,           /* 52 */
    dst_typ_aux_unit_names,        /* 53 */
    dst_typ_aux_sect_info,         /* 54 */
    dst_typ_END_OF_ENUM
    }    
    dst_rec_type_t;


/*
** Dummy bounds for variably dimensioned arrays:
*/
#define dst_dummy_array_size  100


/*
** Reference to another item in the symbol table.
**
** The value of a dst_rel_offset_t is the relative offset from the start of the
** referencing record to the start of the referenced record, string, etc. 
**
** The value of a NIL dst_rel_offset_t is zero.
*/

typedef long dst_rel_offset_t  ALIGNED1;


/* FIXME: Here and many places we make assumptions about sizes of host
   data types, structure layout, etc.  Only needs to be fixed if we care
   about cross-debugging, though.  */

/*
** Section-relative reference. 
**
** The section index field is an index into the local compilation unit's
** section table (see dst_rec_section_tab_t)--NOT into the object module
** section table!
**
** The sect_offset field is the offset in bytes into the section.
**
** A NIL dst_sect_ref_t has a sect_index field of zero.  Indexes originate
** at one.
*/

typedef struct
    {
    unsigned short  sect_index;
    unsigned long   sect_offset ALIGNED1;
    }
    dst_sect_ref_t;

#define dst_sect_index_nil    0
#define dst_sect_index_origin 1


/*
** Source location descriptor.
**
** The file_index field is an index into the local compilation unit's
** file table (see dst_rec_file_tab_t).
**
** A NIL dst_src_loc_t has a file_index field of zero.  Indexes originate
** at one.
*/

typedef struct
    {
    boolean  reserved    :  1;  /* reserved for future use */
    int      file_index  : 11;  /* index into .blocks source file list */
    int      line_number : 20;  /* source line number */
    }
    dst_src_loc_t;

#define dst_file_index_nil    0
#define dst_file_index_origin 1


/*
** Standard (primitive) type codes.
*/

typedef enum
    {
    dst_non_std_type,
    dst_int8_type,         /* 8 bit integer */
    dst_int16_type,        /* 16 bit integer */
    dst_int32_type,        /* 32 bit integer */
    dst_uint8_type,        /* 8 bit unsigned integer */
    dst_uint16_type,       /* 16 bit unsigned integer */
    dst_uint32_type,       /* 32 bit unsigned integer */
    dst_real32_type,       /* single precision ieee floatining point */
    dst_real64_type,       /* double precision ieee floatining point */
    dst_complex_type,      /* single precision complex */    
    dst_dcomplex_type,     /* double precision complex */
    dst_bool8_type,        /* boolean =logical*1 */
    dst_bool16_type,       /* boolean =logical*2 */
    dst_bool32_type,       /* boolean =logical*4 */
    dst_char_type,         /* 8 bit ascii character */
    dst_string_type,       /* string of 8 bit ascii characters */
    dst_ptr_type,          /* univ_pointer */
    dst_set_type,          /* generic 256 bit set */
    dst_proc_type,         /* generic procedure (signature not specified) */
    dst_func_type,         /* generic function (signature not specified) */
    dst_void_type,         /* c void type */
    dst_uchar_type,        /* c unsigned char */
    dst_std_type_END_OF_ENUM
    }    
    dst_std_type_t;


/*
** General data type descriptor
**
** If the user_defined_type bit is clear, then the type is a standard type, and
** the remaining bits contain the dst_std_type_t of the type.  If the bit is
** set, then the type is defined in a separate dst record, which is referenced
** by the remaining bits as a dst_rel_offset_t.
*/

typedef union
    {
    struct
        {
        boolean         user_defined_type :  1;  /* tag field */
        int             must_be_zero      : 23;  /* 23 bits of pad */
        dst_std_type_t  dtc               :  8;  /* 8 bit primitive data */
        }
        std_type;
   
    struct
        {
        boolean         user_defined_type :  1;  /* tag field */
        int             doffset           : 31;  /* offset to type record */
        }
        user_type;
    }
    dst_type_t ALIGNED1;

/* The user_type.doffset field is a 31-bit signed value.  Some versions of C
   do not support signed bit fields.  The following macro will extract that
   field as a signed value:
*/
#define dst_user_type_offset(type_rec) \
    ( ((int) ((type_rec).user_type.doffset << 1)) >> 1 )


/*================================================*/
/*========== RECORDS IN .blocks SECTION ==========*/
/*================================================*/

/*-----------------------
  COMPILATION UNIT record 
  -----------------------
  This must be the first record in each .blocks section.
  Provides a set of information describing the output of a single compilation
  and pointers to additional information for the compilation unit.
*/

typedef enum
    { 
    dst_pc_code_locs,          /* ranges in loc strings are pc ranges */
    dst_comp_unit_END_OF_ENUM
    }    
    dst_comp_unit_flag_t;

typedef enum
    {
    dst_lang_unk,          /* unknown language */
    dst_lang_pas,          /* Pascal */
    dst_lang_ftn,          /* FORTRAN */
    dst_lang_c,            /* C */
    dst_lang_mod2,         /* Modula-2 */
    dst_lang_asm_m68k,     /* 68K assembly language */
    dst_lang_asm_a88k,     /* AT assembly language */
    dst_lang_ada,          /* Ada */
    dst_lang_cxx,          /* C++ */
    dst_lang_END_OF_ENUM
    }    
    dst_lang_type_t;

typedef struct
    {
    struct
        {
        unsigned char major_part;         /* = dst_version_major */
        unsigned char minor_part;         /* = dst_version_minor */
        }           
        version;                          /* version of dst */
    unsigned short    flags;              /* mask of dst_comp_unit_flag_t */
    unsigned short   lang_type;          /* source language */
    unsigned short    number_of_blocks;   /* number of blocks records */
    dst_rel_offset_t  root_block_offset;  /* offset to root block (module?) */
    dst_rel_offset_t  section_table       /* offset to section table record */;
    dst_rel_offset_t  file_table;         /* offset to file table record */
    unsigned long     data_size;          /* total size of .blocks data */
    }
    dst_rec_comp_unit_t ALIGNED1;


/*--------------------
  SECTION TABLE record
  --------------------
  There must be one section table associated with each compilation unit.
  Other debug records refer to sections via their index in this table.  The
  section base addresses in the table are virtual addresses of the sections,
  relocated by the linker.
*/

typedef struct
    {
    unsigned short  number_of_sections;   /* size of array: */    
    unsigned long   section_base[dst_dummy_array_size] ALIGNED1;
    }
    dst_rec_section_tab_t ALIGNED1;


/*-----------------
  FILE TABLE record
  -----------------
  There must be one file table associated with each compilation unit describing
  the source (and include) files used by each compilation unit.  Other debug 
  records refer to files via their index in this table.  The first entry is the
  primary source file.
*/

typedef struct
    {
    long              dtm;        /* time last modified (time_$clock_t) */
    dst_rel_offset_t  noffset;    /* offset to name string for source file */
    }
    dst_file_desc_t;

typedef struct
    {
    unsigned short   number_of_files;    /* size of array: */
    dst_file_desc_t  files[dst_dummy_array_size] ALIGNED1;
    }
    dst_rec_file_tab_t ALIGNED1;


/*-----------------
  NAME TABLE record
  -----------------
  A name table record may appear as an auxiliary record to the file table,
  providing additional qualification of the file indexes for languages that 
  need it (i.e. Ada).  Name table entries parallel file table entries of the
  same file index.
*/

typedef struct
    {
    unsigned short    number_of_names;    /* size of array: */
    dst_rel_offset_t  names[dst_dummy_array_size] ALIGNED1;
    }
    dst_rec_name_tab_t ALIGNED1;


/*--------------
  BLOCK record
  --------------
  Describes a lexical program block--a procedure, function, module, etc.
*/

/* Block types.  These may be used in any way desired by the compiler writers. 
   The debugger uses them only to give a description to the user of the type of
   a block.  The debugger makes no other assumptions about the meaning of any
   of these.  For example, the fact that a block is executable (e.g., program)
   or not (e.g., module) is expressed in block attributes (see below), not
   guessed at from the block type.
*/    
typedef enum
    {
    dst_block_module,          /* some pascal = modula = ada types */
    dst_block_program,         
    dst_block_procedure,      
    dst_block_function,        /* C function */
    dst_block_subroutine,      /* some fortran block types */
    dst_block_block_data,      
    dst_block_stmt_function,  
    dst_block_package,         /* a few particular to Ada */
    dst_block_package_body,  
    dst_block_subunit,        
    dst_block_task,            
    dst_block_file,            /* a C outer scope? */
    dst_block_class,           /* C++ or Simula */
    dst_block_END_OF_ENUM
    }    
    dst_block_type_t;

/* Block attributes.  This is the information used by the debugger to represent
   the semantics of blocks.
*/
typedef enum
    {
    dst_block_main_entry,      /* the block's entry point is a main entry into
                                  the compilation unit */    
    dst_block_executable,      /* the block has an entry point */
    dst_block_attr_END_OF_ENUM
    }    
    dst_block_attr_t;

/* Code range.  Each block has associated with it one or more code ranges. An
   individual code range is identified by a range of source (possibly nil) and
   a range of executable code.  For example, a block which has its executable
   code spread over multiple sections will have one code range per section.
*/
typedef struct
    {
    unsigned long   code_size;      /* size of executable code (in bytes ) */
    dst_sect_ref_t  code_start;     /* starting address of executable code */
    dst_sect_ref_t  lines_start;    /* start of line number tables */
    }
    dst_code_range_t;

typedef struct
    {
    dst_block_type_t  block_type : 8; 
    unsigned short    flags      : 8;       /* mask of dst_block_attr_t flags */
    dst_rel_offset_t  sibling_block_off;    /* offset to next sibling block */
    dst_rel_offset_t  child_block_off;      /* offset to first contained block */
    dst_rel_offset_t  noffset;              /* offset to block name string */    
    dst_sect_ref_t    symbols_start;        /* start of debug symbols  */
    unsigned short    n_of_code_ranges;     /* size of array... */
    dst_code_range_t  code_ranges[dst_dummy_array_size] ALIGNED1;
    }
    dst_rec_block_t ALIGNED1;


/*--------------------------
  AUX SECT INFO TABLE record
  --------------------------
  Appears as an auxiliary to a block record.  Expands code range information
  by providing references into additional, language-dependent sections for 
  information related to specific code ranges of the block.  Sect info table
  entries parallel code range array entries of the same index.
*/

typedef struct
    {
    unsigned char    tag;               /* currently can only be zero */
    unsigned char    number_of_refs;    /* size of array: */
    dst_sect_ref_t   refs[dst_dummy_array_size] ALIGNED1;
    }
    dst_rec_sect_info_tab_t ALIGNED1;

/*=================================================*/
/*========== RECORDS IN .symbols SECTION ==========*/
/*=================================================*/

/*-----------------
  CONSTANT record
  -----------------
  Describes a symbolic constant.
*/

typedef struct
    {
    float    r;      /* real part */
    float    i;      /* imaginary part */
    }
    dst_complex_t;

typedef struct
    {
    double    dr;     /* real part */
    double    di;     /* imaginary part */
    }
    dst_double_complex_t;

/* The following record provides a way of describing constant values with 
   non-standard type and no limit on size. 
*/
typedef union
    {
    char    char_data[dst_dummy_array_size];
    short   int_data [dst_dummy_array_size];
    long    long_data[dst_dummy_array_size];
    }
    dst_big_kon_t;

/* Representation of the value of a general constant.
*/
typedef struct
    {
    unsigned short            length;     /* size of constant value (bytes) */

    union
        {
        unsigned short        kon_int8;
        short                 kon_int16;
        long                  kon_int32   ALIGNED1;
        float                 kon_real    ALIGNED1;
        double                kon_dbl     ALIGNED1;
        dst_complex_t         kon_cplx    ALIGNED1;
        dst_double_complex_t  kon_dcplx   ALIGNED1;
        char                  kon_char;
        dst_big_kon_t         kon         ALIGNED1;
        }                    
        val;                              /* value data of constant */
    }
    dst_const_t ALIGNED1;

typedef struct
    {
    dst_rel_offset_t   noffset;        /* offset to name string */
    dst_src_loc_t      src_loc;        /* file/line of const definition */
    dst_type_t         type_desc;      /* type of this (manifest) constant */
    dst_const_t        value; 
    }
    dst_rec_const_t ALIGNED1;

/*----------------
  VARIABLE record
  ----------------
  Describes a program variable.
*/

/* Variable attributes.  These define certain variable semantics to the
   debugger.
*/
typedef enum
    {
    dst_var_attr_read_only,      /* is read-only (a program literal) */
    dst_var_attr_volatile,       /* same as compiler's VOLATILE attribute */
    dst_var_attr_global,         /* is a global definition or reference */    
    dst_var_attr_compiler_gen,   /* is compiler-generated */
    dst_var_attr_static,         /* has static location */
    dst_var_attr_END_OF_ENUM
    }    
    dst_var_attr_t;

typedef struct
    {
    dst_rel_offset_t  noffset;       /* offset to name string */
    dst_rel_offset_t  loffset;       /* offset to loc string */
    dst_src_loc_t     src_loc;       /* file/line of variable definition */
    dst_type_t        type_desc;     /* type descriptor */
    unsigned short    attributes;    /* mask of dst_var_attr_t flags */
    }
    dst_rec_variable_t ALIGNED1;


/*----------------
  old VAR record
 -----------------
 Used by older compilers to describe a variable
*/

typedef enum
    {
    dst_var_loc_unknown,	/* Actually defined as "unknown" */
    dst_var_loc_abs,		/* Absolute address */
    dst_var_loc_sect_off,	/* Absolute address as a section offset */
    dst_var_loc_ind_sect_off,	/* An indexed section offset ???? */
    dst_var_loc_reg,		/* register */
    dst_var_loc_reg_rel,	/* register relative - usually fp */
    dst_var_loc_ind_reg_rel,	/* Indexed register relative */
    dst_var_loc_ftn_ptr_based,	/* Fortran pointer based */
    dst_var_loc_pc_rel,		/* PC relative. Really. */
    dst_var_loc_external,	/* External */
    dst_var_loc_END_OF_ENUM
    }
    dst_var_loc_t;

/* Locations come in two versions. The sort, and the long. The difference
 * between the short and the long is the addition of a statement number
 * field to the start andend of the range of the long, and and unkown
 * purpose field in the middle. Also, loc_type and loc_index aren't
 * bitfields in the long version.
 */

typedef	struct
    {
    unsigned short	loc_type : 4;
    unsigned short	loc_index : 12;
    long		location;
    short		start_line;	/* start_line and end_line? */
    short		end_line;	/* I'm guessing here.	    */
    } dst_var_loc_short_t;

typedef struct
    {
    unsigned short	loc_type;
    unsigned short	loc_index;
    long		location;
    short		unknown;	/* Always 0003 or 3b3c. Why? */
    short		start_statement;
    short		start_line;
    short		end_statement;
    short		end_line;
    } dst_var_loc_long_t;


typedef struct
    {
    dst_rel_offset_t	noffset;	/* offset to name string */
    dst_src_loc_t	src_loc;	/* file/line of description */
    dst_type_t		type_desc;	/* Type description */
    unsigned short	attributes;	/* mask of dst_var_attr_t flags */
    unsigned short	no_of_locs : 15;/* Number of locations */
    unsigned short	short_locs : 1;	/* True if short locations. */
    union
	{
	dst_var_loc_short_t shorts[dst_dummy_array_size];
	dst_var_loc_long_t longs[dst_dummy_array_size];
	} locs;
    } dst_rec_var_t;

/*----------------
  old LABEL record
 -----------------
 Used by older compilers to describe a label
*/

typedef struct
    {
    dst_rel_offset_t	noffset;	/* offset to name string */
    dst_src_loc_t	src_loc;	/* file/line of description */
    char		location[12];	/* location string */
    }
    dst_rec_old_label_t ALIGNED1;

/*----------------
  POINTER record
  ----------------
  Describes a pointer type.
*/

typedef struct
    {
    dst_rel_offset_t  noffset;    /* offset to the name string for this type */
    dst_src_loc_t     src_loc;    /* file/line of definition */
    dst_type_t        type_desc;  /* base type of this pointer */
    }
    dst_rec_pointer_t ALIGNED1;


/*-------------
  ARRAY record
  -------------
  Describes an array type.

  Multidimensional arrays are described with a number of dst_rec_array_t 
  records, one per array dimension, each linked to the next through the
  elem_type_desc.doffset field.  Each record must have its multi_dim flag
  set.

  If column_major is true (as with FORTRAN arrays) then the last array bound in
  the declaration is the first array index in memory, which is the opposite of
  the usual case (as with Pascal and C arrays).

  Variable array bounds are described by auxiliary records; if aux_var_bound
  records are present, the lo_bound and hi_bound fields of this record are
  ignored by the debugger.

  span_comp identifies one of the language-dependent ways in which the distance
  between successive array elements (span) is calculated.  
     dst_use_span_field    -- the span is the value of span field.
     dst_compute_from_prev -- the span is the size of the previous dimension.
     dst_compute_from_next -- the span is the size of the next dimension.
  In the latter two cases, the span field contains an amount of padding to add
  to the size of the appropriate dimension to calculate the span.
*/

typedef enum
    {
    dst_use_span_field,  
    dst_compute_from_prev,
    dst_compute_from_next,        
    dst_span_comp_END_OF_ENUM
    }
    dst_span_comp_t;

typedef struct
    {
    dst_rel_offset_t  noffset;           /* offset to name string */
    dst_src_loc_t     src_loc;           /* file/line of definition */
    dst_type_t        elem_type_desc;    /* array element type */    
    dst_type_t        indx_type_desc;    /* array index type */
    long              lo_bound;          /* lower bound of index */
    long              hi_bound;          /* upper bound of index */
    unsigned long     span;              /* see above */
    unsigned long     size;              /* total array size (bytes) */
    boolean           multi_dim : 1;
    boolean           is_packed : 1;     /* true if packed array */    
    boolean           is_signed : 1;     /* true if packed elements are signed */
    dst_span_comp_t   span_comp : 2;     /* how to compute span */
    boolean           column_major : 1;
    unsigned short    reserved  : 2;     /* must be zero */
    unsigned short    elem_size : 8;     /* element size if packed (bits) */
    }    
    dst_rec_array_t ALIGNED1;


/*-----------------
  SUBRANGE record
  -----------------
  Describes a subrange type.
*/

/* Variable subrange bounds are described by auxiliary records; if aux_var_bound
   records are present, the lo_bound and hi_bound fields of this record are
   ignored by the debugger.
*/

typedef struct
    {
    dst_rel_offset_t  noffset;       /* offset to name string */
    dst_src_loc_t     src_loc;       /* file/line of subrange definition */
    dst_type_t        type_desc;     /* parent type */    
    long              lo_bound;      /* lower bound of subrange */
    long              hi_bound;      /* upper bound of subrange */
    unsigned short    size;          /* storage size (bytes) */
    }
    dst_rec_subrange_t ALIGNED1;


/*---------------
  STRING record 
  ---------------
  Describes a string type.
*/

/* Variable subrange bounds are described by auxiliary records; if aux_var_bound
   records are present, the lo_bound and hi_bound fields of this record are
   ignored by the debugger.
*/

typedef struct
    {
    dst_rel_offset_t  noffset;          /* offset to name string */
    dst_src_loc_t     src_loc;          /* file/line of string definition */
    dst_type_t        elem_type_desc;   /* element type */    
    dst_type_t        indx_type_desc;   /* index type */
    long              lo_bound;         /* lower bound */
    long              hi_bound;         /* upper bound */
    unsigned long     size;             /* total string size (bytes) if fixed */
    }
    dst_rec_string_t ALIGNED1;


/*---------------
  SET record 
  ---------------
  Describes a set type.
*/

typedef struct
    {
    dst_rel_offset_t  noffset;       /* offset to name string */
    dst_src_loc_t     src_loc;       /* file/line of definition */
    dst_type_t        type_desc;     /* element type */    
    unsigned short    nbits;         /* number of bits in set */
    unsigned short    size;          /* storage size (bytes) */
    }
    dst_rec_set_t ALIGNED1;


/*-----------------------------
  IMPLICIT ENUMERATION record 
  -----------------------------
  Describes an enumeration type with implicit element values = 0, 1, 2, ...
  (Pascal-style).
*/

typedef struct
    {
    dst_rel_offset_t   noffset;      /* offset to name string */    
    dst_src_loc_t      src_loc;      /* file/line of definition */
    unsigned short     nelems;       /* number of elements in enumeration */
    unsigned short     size;         /* storage size (bytes) */
    /* offsets to name strings of elements 0, 1, 2, ... */
    dst_rel_offset_t   elem_noffsets[dst_dummy_array_size]; 
    }
    dst_rec_implicit_enum_t ALIGNED1;


/*-----------------------------
  EXPLICIT ENUMERATION record 
  -----------------------------
  Describes an enumeration type with explicitly assigned element values
  (C-style).
*/

typedef struct
    {
    dst_rel_offset_t   noffset;       /* offset to element name string */
    long               value;         /* element value */
    }
    dst_enum_elem_t;

typedef struct
    {
    dst_rel_offset_t   noffset;       /* offset to name string */
    dst_src_loc_t      src_loc;       /* file/line of definition */
    unsigned short     nelems;        /* number of elements in enumeration */
    unsigned short     size;          /* storage size (bytes) */
    /* name/value pairs, one describing each enumeration value: */
    dst_enum_elem_t    elems[dst_dummy_array_size]; 
    }
    dst_rec_explicit_enum_t ALIGNED1;


/*-----------------------
  RECORD / UNION record 
  -----------------------
  Describes a record (struct) or union.

  If the record is larger than 2**16 bytes then an attached aux record
  specifies its size.  Also, if the record is stored in short form then
  attached records specify field offsets larger than 2**16 bytes.

  Whether the fields[] array or sfields[] array is used is selected by
  the dst_rec_type_t of the overall dst record.
*/

/*
   Record field descriptor, short form.  This form handles only fields which
   are an even number of bytes long, located some number of bytes from the
   start of the record.
*/
typedef struct
    {
    dst_rel_offset_t  noffset;     /* offset to field name string */
    dst_type_t        type_desc;   /* field type */
    unsigned short    foffset;     /* field offset from start of record (bytes) */
    }
    dst_short_field_t ALIGNED1;

typedef struct
    {
    dst_rel_offset_t	noffset;	/* offset to name string */
    dst_type_t		type_desc;	/* field type */
    unsigned short	foffset;	/* byte offset */
    unsigned short	is_packed : 1;	/* True if field is packed */
    unsigned short	bit_offset : 6;	/* Bit offset */
    unsigned short	size : 6;	/* Size in bits */
    unsigned short	sign : 1;	/* True if signed */
    unsigned short	pad : 2;	/* Padding. Must be 0 */
    }
    dst_old_field_t ALIGNED1;

/* Tag enumeration for long record field descriptor:
*/
typedef enum
    {
    dst_field_byte,
    dst_field_bit,
    dst_field_loc,
    dst_field_END_OF_ENUM
    }
    dst_field_format_t;

/*
   Record field descriptor, long form.  The format of the field information
   is identified by the format_tag, which contains one of the above values.
   The field_byte variant is equivalent to the short form of field descriptor.
   The field_bit variant handles fields which are any number of bits long,
   located some number of bits from the start of the record.  The field_loc
   variant allows the location of the field to be described by a general loc
   string.
*/
typedef struct
    {
    dst_rel_offset_t   noffset;                 /* offset to name of field */
    dst_type_t         type_desc;               /* type of field */
    union
        {
        struct {
            dst_field_format_t format_tag: 2;   /* dst_field_byte */
            unsigned long      offset: 30;      /* offset of field in bytes */
            }
            field_byte ALIGNED1;
        struct {
            dst_field_format_t format_tag: 2;   /* dst_field_bit */
            unsigned long      nbits: 6;        /* bit size of field */
            unsigned long      is_signed: 1;    /* signed/unsigned attribute */
            unsigned long      bit_offset: 3;   /* bit offset from byte boundary */
            int                pad: 4;          /* must be zero */
            unsigned short     byte_offset;     /* offset of byte boundary */
            }
            field_bit ALIGNED1;
        struct {
            dst_field_format_t format_tag: 2;   /* dst_field_loc */
            int                loffset: 30;     /* dst_rel_offset_t to loc string */
            }
            field_loc ALIGNED1;
        }
        f ALIGNED1;
    }
    dst_field_t;

/* The field_loc.loffset field is a 30-bit signed value.  Some versions of C do
   not support signed bit fields.  The following macro will extract that field
   as a signed value:
*/
#define dst_field_loffset(field_rec) \
    ( ((int) ((field_rec).f.field_loc.loffset << 2)) >> 2 )


typedef struct
    {
    dst_rel_offset_t   noffset;      /* offset to record name string */
    dst_src_loc_t      src_loc;      /* file/line where this record is defined */
    unsigned short      size;        /* storage size (bytes) */
    unsigned short      nfields;     /* number of fields in this record */
    union
        {
        dst_field_t        fields[dst_dummy_array_size];
        dst_short_field_t  sfields[dst_dummy_array_size];
	dst_old_field_t	   ofields[dst_dummy_array_size];
        }
        f;                           /* array of fields */
    }
    dst_rec_record_t ALIGNED1;


/*-------------
  FILE record
  -------------
  Describes a file type.
*/

typedef struct
    {
    dst_rel_offset_t  noffset;       /* offset to name string */
    dst_src_loc_t     src_loc;       /* file/line where type was defined */
    dst_type_t        type_desc;     /* file element type */
    }
    dst_rec_file_t ALIGNED1;


/*---------------
  OFFSET record 
  ---------------
   Describes a Pascal offset type.
   (This type, an undocumented Domain Pascal extension, is currently not
   supported by the debugger)
*/

typedef struct
    {
    dst_rel_offset_t   noffset;           /* offset to the name string */
    dst_src_loc_t      src_loc;           /* file/line of definition */
    dst_type_t         area_type_desc;    /* area type */    
    dst_type_t         base_type_desc;    /* base type */
    long               lo_bound;          /* low bound of the offset range */
    long               hi_bound;          /* high bound of the offset range */
    long               bias;              /* bias */    
    unsigned short     scale;             /* scale factor */
    unsigned short     size;              /* storage size (bytes) */
    }
    dst_rec_offset_t ALIGNED1;


/*--------------
  ALIAS record 
  --------------
  Describes a type alias (e.g., typedef).
*/

typedef struct
    {
    dst_rel_offset_t   noffset;      /* offset to name string */
    dst_src_loc_t      src_loc;      /* file/line of definition */
    dst_type_t         type_desc;    /* parent type */
    }
    dst_rec_alias_t ALIGNED1;


/*------------------
  SIGNATURE record
  ------------------
  Describes a procedure/function type.
*/

/* Enumeration of argument semantics.  Note that most are mutually
   exclusive.
*/
typedef enum
    {
    dst_arg_attr_val,          /* passed by value */
    dst_arg_attr_ref,          /* passed by reference */
    dst_arg_attr_name,         /* passed by name */
    dst_arg_attr_in,           /* readable in the callee */
    dst_arg_attr_out,          /* writable in the callee */    
    dst_arg_attr_hidden,       /* not visible in the caller */
    dst_arg_attr_END_OF_ENUM
    }    
    dst_arg_attr_t;

/* Argument descriptor.  Actually points to a variable record for most of the
   information.
*/
typedef struct
    {
    dst_rel_offset_t  var_offset;     /* offset to variable record */
    unsigned short    attributes;     /* a mask of dst_arg_attr_t flags */
    }
    dst_arg_t ALIGNED1;

typedef struct
    {
    dst_rel_offset_t   noffset;    /* offset to name string */
    dst_src_loc_t      src_loc;    /* file/line of function definition */
    dst_rel_offset_t   result;     /* offset to function result variable record */
    unsigned short     nargs;      /* number of arguments */
    dst_arg_t          args[dst_dummy_array_size]; 
    }
    dst_rec_signature_t ALIGNED1;

/*--------------
  SCOPE record
  --------------
  Obsolete. Use the new ENTRY type instead.
  Old compilers may put this in as the first entry in a function,
  terminated by an end of scope entry.
*/

typedef struct
    {
    dst_rel_offset_t	noffset;	/* Name offset */
    dst_src_loc_t	start_line;	/* Starting line */
    dst_src_loc_t	end_line;	/* Ending line */
    }
    dst_rec_scope_t ALIGNED1;

/*--------------
  ENTRY record
  --------------
  Describes a procedure/function entry point.  An entry record is to a
  signature record roughly as a variable record is to a type descriptor record.

  The entry_number field is keyed to the entry numbers in .lines -- the 
  debugger locates the code location of an entry by searching the line
  number table for an entry numbered with the value of entry_number.  The
  main entry is numbered zero.
*/

typedef struct
    {
    dst_rel_offset_t  noffset;           /* offset to entry name string */
    dst_rel_offset_t  loffset;           /* where to jump to call this entry */
    dst_src_loc_t     src_loc;           /* file/line of definition */
    dst_rel_offset_t  sig_desc;          /* offset to signature descriptor */
    unsigned int      entry_number: 8;
    int               pad: 8;            /* must be zero */
    }
    dst_rec_entry_t ALIGNED1;

/*-----------------------
  Old format ENTRY record
  -----------------------
  Supposedly obsolete but still used by some compilers.
 */

typedef struct
    {
    dst_rel_offset_t	noffset;	/* Offset to entry name string */
    dst_src_loc_t	src_loc;	/* Location in source */
    dst_rel_offset_t	sig_desc;	/* Signature description */
    char		unknown[36];
    }
    dst_rec_old_entry_t ALIGNED1;

/*--------------
  LABEL record 
  --------------
  Describes a program label.
*/

typedef struct
    {
    dst_rel_offset_t   noffset;        /* offset to label string */
    dst_rel_offset_t   loffset;        /* offset to loc string */
    dst_src_loc_t      src_loc;        /* file/line of definition */
    }
    dst_rec_label_t ALIGNED1;


/*-----------------------
  AUXILIARY SIZE record
  -----------------------
  May appear in the auxiliary record list of any type or variable record to
  modify the default size of the type or variable.
*/

typedef struct
    {
    unsigned long  size;       /* size (bytes) */
    }
    dst_rec_aux_size_t ALIGNED1;


/*-----------------------
  AUXILIARY ALIGN record
  -----------------------
  May appear in the auxiliary record list of any type or variable record to
  modify the default alignment of the type or variable.
*/

typedef struct
    {
    unsigned short    alignment;  /* # of low order zero bits */
    }
    dst_rec_aux_align_t ALIGNED1;


/*-----------------------------
  AUXILIARY FIELD SIZE record
  -----------------------------
  May appear in the auxiliary record list of any RECORD/UNION record to 
  modify the default size of a field.
*/

typedef struct
    {
    unsigned short field_no;       /* field number */
    unsigned long  size;           /* size (bits) */
    }
    dst_rec_aux_field_size_t ALIGNED1;



/*-----------------------------
  AUXILIARY FIELD OFFSET record
  -----------------------------
  May appear in the auxiliary record list of any RECORD/UNION record to 
  specify a field offset larger than 2**16.
*/

typedef struct
    {
    unsigned short field_no;       /* field number */
    unsigned long  foffset;        /* offset */
    }
    dst_rec_aux_field_off_t ALIGNED1;


/*-----------------------------
  AUXILIARY FIELD ALIGN record
  -----------------------------
  May appear in the auxiliary record list of any RECORD/UNION record to 
  modify the default alignment of a field.
*/

typedef struct
    {
    unsigned short field_no;       /* field number */
    unsigned short alignment;      /* number of low order zero bits */
    }
    dst_rec_aux_field_align_t ALIGNED1;


/*----------------------------
  AUXILIARY VAR BOUND record
  ----------------------------
  May appear in the auxiliary record list of any ARRAY, SUBRANGE or STRING
  record to describe a variable bound for the range of the type.
*/

typedef enum
    {
    dst_low_bound,       /* the low bound is variable */
    dst_high_bound,      /* the high bound is variable */
    dst_var_bound_END_OF_ENUM
    }
    dst_var_bound_t;

typedef struct
    {
    unsigned short    which;              /* which bound */
    dst_rel_offset_t   voffset ALIGNED1;   /* variable that defines bound */
    }    
    dst_rec_aux_var_bound_t ALIGNED1;


/*----------------------------------
  AUXILIARY TYPE DERIVATION record 
  ----------------------------------
  May appear in the auxiliary record list of any RECORD/UNION record to denote
  class inheritance of that type from a parent type.

  Inheritance implies that it is possible to convert the inheritor type to the
  inherited type, retaining those fields which were inherited.  To allow this,
  orig_field_no, a field number into the record type, is provided.  If 
  orig_is_pointer is false, then the start of the inherited record is located
  at the location of the field indexed by orig_field_no.  If orig_is_pointer
  is true, then it is located at the address contained in the field indexed
  by orig_field_no (assumed to be a pointer).
*/

typedef struct
    {
    dst_type_t     parent_type;             /* reference to inherited type */
    unsigned short orig_field_no;
    boolean        orig_is_pointer: 1;
    int            unused: 15;              /* must be zero */
    }
    dst_rec_aux_type_deriv_t ALIGNED1;


/*------------------------------------
  AUXILIARY VARIABLE LIFETIME record
  ------------------------------------
  May appear in the auxiliary record list of a VARIABLE record to add location
  information for an additional variable lifetime.
*/

typedef struct
    {
    dst_rel_offset_t loffset;
    }
    dst_rec_aux_lifetime_t ALIGNED1;


/*-------------------------------
  AUXILIARY POINTER BASE record 
  -------------------------------
  May appear in the auxiliary record list of a VARIABLE record to provide a
  pointer base to substitute for references to any such bases in the location
  string of the variable.  A pointer base is another VARIABLE record.  When
  the variable is evaluated by the debugger, it uses the current value of the
  pointer base variable in computing its location.

  This is useful for representing FORTRAN pointer-based variables.
*/

typedef struct
    {
    dst_rel_offset_t voffset;
    }
    dst_rec_aux_ptr_base_t ALIGNED1;


/*---------------------------------
  AUXILIARY REGISTER VALUE record 
  ---------------------------------
  May appear in the auxiliary record list of an ENTRY record to specify
  a register that must be set to a specific value before jumping to the entry
  point in a debugger "call".  The debugger must set the debuggee register,
  specified by the register code, to the value of the *address* to which the
  location string resolves.  If the address is register-relative, then the
  call cannot be made unless the current stack frame is the lexical parent
  of the entry.  An example of this is when a (Pascal) nested procedure
  contains references to its parent's variables, which it accesses through
  a static link register.  The static link register must be set to some
  address relative to the parent's stack base register.
*/

typedef struct
    {
    unsigned short    reg;        /* identifies register to set (isp enum) */
    dst_rel_offset_t  loffset;    /* references a location string */
    }
    dst_rec_aux_reg_val_t ALIGNED1;


/*==========================================================*/
/*========== RECORDS USED IN .blocks AND .symbols ==========*/
/*==========================================================*/

/*---------------------
  STRING TABLE record
  ---------------------
  A string table record contains any number of null-terminated, variable length
  strings.   The length field gives the size in bytes of the text field, which
  can be any size.

  The global name table shares this format.  This record appears in the
  .blocks section.  Each string in the table identifies a global defined in
  the current compilation unit.

  The loc pool record shares this format as well.  Loc strings are described
  elsewhere.
*/

typedef struct
    {
    unsigned long length;               
    char          text[dst_dummy_array_size];
    }
    dst_rec_string_tab_t ALIGNED1;


/*-----------------------
  AUXILIARY QUAL record 
  -----------------------
  May appear in the auxiliary record list of any BLOCK, VARIABLE, or type record
  to provide it with a fully-qualified, language-dependent name.
*/

typedef struct
    {
    dst_rel_offset_t   lang_qual_name;
    }
    dst_rec_aux_qual_t ALIGNED1;


/*----------------
  FORWARD record
  ----------------
  Reference to a record somewhere else.  This allows identical definitions in
  different scopes to share data.
*/

typedef struct
    {
    dst_rel_offset_t   rec_off;
    }
    dst_rec_forward_t ALIGNED1;


/*-------------------------------
  AUXILIARY SOURCE RANGE record
  -------------------------------
  May appear in the auxiliary record list of any BLOCK record to specify a
  range of source lines over which the block is active.
*/

typedef struct
    {
    dst_src_loc_t   first_line;             /* first source line */
    dst_src_loc_t   last_line;              /* last source line */
    }
    dst_rec_aux_src_range_t ALIGNED1;


/*------------------
  EXTENSION record 
  ------------------
  Provision for "foreign" records, such as might be generated by a non-Apollo
  compiler.  Apollo software will ignore these.
*/

typedef struct
    {
    unsigned short  rec_size;   /* record size (bytes) */
    unsigned short  ext_type;   /* defined by whoever generates it */
    unsigned short  ext_data;   /* place-holder for arbitrary amount of data */
    }
    dst_rec_extension_t ALIGNED1;


/*
** DEBUG SYMBOL record -- The wrapper for all .blocks and .symbols records.
**
** This record ties together all previous .blocks and .symbols records 
** together in a union with a common header.  The rec_type field of the
** header identifies the record type.  The rec_flags field currently only
** defines auxiliary record lists. 
**
** If a record carries with it a non-null auxiliary record list, its
** dst_flag_has_aux_recs flag is set, and each of the records that follow
** it are treated as its auxiliary records, until the end of the compilation
** unit or scope is reached, or until an auxiliary record with its
** dst_flag_last_aux_rec flag set is reached.
*/

typedef enum
    {
    dst_flag_has_aux_recs,
    dst_flag_last_aux_rec,
    dst_rec_flag_END_OF_ENUM
    }    
    dst_rec_flags_t;

typedef struct
    {
    dst_rec_type_t    rec_type : 8;     /* record type */
    int               rec_flags: 8;     /* mask of dst_rec_flags_t */
    union                               /* switched on rec_type field above */
        {
           /* dst_typ_pad requires no additional fields */
        dst_rec_comp_unit_t        comp_unit_;
        dst_rec_section_tab_t      section_tab_;
        dst_rec_file_tab_t         file_tab_;  
        dst_rec_block_t            block_;   
	dst_rec_var_t		   var_;
        dst_rec_pointer_t          pointer_;   
        dst_rec_array_t            array_; 
        dst_rec_subrange_t         subrange_;
        dst_rec_set_t              set_;
        dst_rec_implicit_enum_t    implicit_enum_;   
        dst_rec_explicit_enum_t    explicit_enum_;
           /* dst_typ_short_{rec,union} are represented by 'rec' (below) */
        dst_rec_file_t             file_;   
        dst_rec_offset_t           offset_;   
        dst_rec_alias_t            alias_; 
        dst_rec_signature_t        signature_;
	dst_rec_old_label_t	   old_label_;
	dst_rec_scope_t		   scope_;
           /* dst_typ_end_scope requires no additional fields */
        dst_rec_string_tab_t       string_tab_;   
           /* dst_typ_global_name_tab is represented by 'string_tab' (above) */
        dst_rec_forward_t          forward_;   
        dst_rec_aux_size_t         aux_size_;   
        dst_rec_aux_align_t        aux_align_;  
        dst_rec_aux_field_size_t   aux_field_size_; 
        dst_rec_aux_field_off_t    aux_field_off_;
        dst_rec_aux_field_align_t  aux_field_align_;
        dst_rec_aux_qual_t         aux_qual_;   
        dst_rec_aux_var_bound_t    aux_var_bound_;  
        dst_rec_extension_t        extension_;
        dst_rec_string_t           string_;  
        dst_rec_const_t            const_; 
           /* dst_typ_reference is represented by 'pointer' (above) */
        dst_rec_record_t           record_; 
           /* dst_typ_union is represented by 'record' (above) */
        dst_rec_aux_type_deriv_t   aux_type_deriv_; 
           /* dst_typ_locpool is represented by 'string_tab' (above) */
        dst_rec_variable_t         variable_;  
        dst_rec_label_t            label_; 
        dst_rec_entry_t            entry_; 
        dst_rec_aux_lifetime_t     aux_lifetime_;
        dst_rec_aux_ptr_base_t     aux_ptr_base_;
        dst_rec_aux_src_range_t    aux_src_range_;  
        dst_rec_aux_reg_val_t      aux_reg_val_;
        dst_rec_name_tab_t         aux_unit_names_;
        dst_rec_sect_info_tab_t    aux_sect_info_;
        }
        rec_data    ALIGNED1;
    }
    dst_rec_t, *dst_rec_ptr_t;


/*===============================================*/
/*========== .lines SECTION DEFINITIONS =========*/
/*===============================================*/
/*
  The .lines section contains a sequence of line number tables.  There is no
  record structure within the section.  The start of the table for a routine
  is pointed to by the block record, and the end of the table is signaled by
  an escape code.

  A line number table is a sequence of bytes.  The default entry contains a line
  number delta (-7..+7) in the high 4 bits and a pc delta (0..15) in the low 4 
  bits. Special cases, including when one or both of the values is too large
  to fit in 4 bits and other special cases are handled through escape entries.
  Escape entries are identified by the value 0x8 in the high 4 bits.  The low 4
  bits are occupied by a function code.  Some escape entries are followed by
  additional arguments, which may be bytes, words, or longwords.  This data is
  not aligned. 

  The initial PC offset, file number and line number are zero.  Normally, the
  table begins with a dst_ln_file escape which establishes the initial file
  and line number.  All PC deltas are unsigned (thus the table is ordered by
  increasing PC); line number deltas are signed.  The table ends with a 
  dst_ln_end escape, which is followed by a final table entry whose PC delta
  gives the code size of the last statement.

  Escape     Semantic
  ---------  ------------------------------------------------------------
  file       Changes file state.  The current source file remains constant
             until another file escape.  Though the line number state is
             also updated by a file escape, a file escape does NOT 
             constitute a line table entry.

  statement  Alters the statement number of the next table entry.  By 
             default, all table entries refer to the first statement on a
             line.  Statement number one is the second statement, and so on.

  entry      Identifies the next table entry as the position of an entry 
             point for the current block.  The PC position should follow 
             any procedure prologue code.  An argument specifies the entry
             number, which is keyed to the entry number of the corresponding
             .symbols ENTRY record.

  exit       Identifies the next table entry as the last position within 
             the current block before a procedure epiloge and subsequent
             procedure exit.

  gap        By default, the executable code corresponding to a table entry 
             is assumed to extend to the beginning of the next table entry.
             If this is not the case--there is a "hole" in the table--then
             a gap escape should follow the first table entry to specify
             where the code for that entry ends.
*/

#define dst_ln_escape_flag    -8    

/*
  Escape function codes:
*/
typedef enum
    {
    dst_ln_pad,          /* pad byte */
    dst_ln_file,         /* file escape.  Next 4 bytes are a dst_src_loc_t */
    dst_ln_dln1_dpc1,    /* 1 byte line delta, 1 byte pc delta */    
    dst_ln_dln2_dpc2,    /* 2 bytes line delta, 2 bytes pc delta */
    dst_ln_ln4_pc4,      /* 4 bytes ABSOLUTE line number, 4 bytes ABSOLUTE pc */
    dst_ln_dln1_dpc0,    /* 1 byte line delta, pc delta = 0 */
    dst_ln_ln_off_1,     /* statement escape, stmt # = 1 (2nd stmt on line) */
    dst_ln_ln_off,       /* statement escape, stmt # = next byte */
    dst_ln_entry,        /* entry escape, next byte is entry number */    
    dst_ln_exit,         /* exit escape */
    dst_ln_stmt_end,     /* gap escape, 4 bytes pc delta */
    dst_ln_escape_11,    /* reserved */
    dst_ln_escape_12,    /* reserved */
    dst_ln_escape_13,    /* reserved */
    dst_ln_nxt_byte,     /* next byte contains the real escape code */
    dst_ln_end,          /* end escape, final entry follows */
    dst_ln_escape_END_OF_ENUM
    }    
    dst_ln_escape_t;

/*
  Line number table entry
*/
typedef union
    {
    struct
        {
        unsigned int    ln_delta : 4;           /* 4 bit line number delta */
        unsigned int    pc_delta : 4;           /* 4 bit pc delta */
        }
        delta;
    
    struct
        {
        unsigned int    esc_flag : 4;       /* alias for ln_delta */
        dst_ln_escape_t esc_code : 4;       /* escape function code */
        }
        esc;
    
    char               sdata;                  /* signed data byte */    
    unsigned char      udata;                  /* unsigned data byte */
    }
    dst_ln_entry_t,
    *dst_ln_entry_ptr_t,
    dst_ln_table_t[dst_dummy_array_size];

/* The following macro will extract the ln_delta field as a signed value:
*/
#define dst_ln_ln_delta(ln_rec) \
    ( ((short) ((ln_rec).delta.ln_delta << 12)) >> 12 )




typedef struct dst_sec_struct {
	char	*buffer;
	long	position;
	long	size;
	long	base;
} dst_sec;


/* Macros for access to the data */

#define DST_comp_unit(x) 	((x)->rec_data.comp_unit_)
#define DST_section_tab(x) 	((x)->rec_data.section_tab_)
#define DST_file_tab(x) 	((x)->rec_data.file_tab_)
#define DST_block(x) 		((x)->rec_data.block_)
#define	DST_var(x)		((x)->rec_data.var_)
#define DST_pointer(x) 		((x)->rec_data.pointer_)
#define DST_array(x) 		((x)->rec_data.array_)
#define DST_subrange(x) 	((x)->rec_data.subrange_)
#define DST_set(x)	 	((x)->rec_data.set_)
#define DST_implicit_enum(x) 	((x)->rec_data.implicit_enum_)
#define DST_explicit_enum(x) 	((x)->rec_data.explicit_enum_)
#define DST_short_rec(x) 	((x)->rec_data.record_)
#define DST_short_union(x) 	((x)->rec_data.record_)
#define DST_file(x) 		((x)->rec_data.file_)
#define DST_offset(x) 		((x)->rec_data.offset_)
#define DST_alias(x)	 	((x)->rec_data.alias_)
#define DST_signature(x) 	((x)->rec_data.signature_)
#define DST_old_label(x) 	((x)->rec_data.old_label_)
#define DST_scope(x) 		((x)->rec_data.scope_)
#define DST_string_tab(x) 	((x)->rec_data.string_tab_)
#define DST_global_name_tab(x) 	((x)->rec_data.string_tab_)
#define DST_forward(x) 		((x)->rec_data.forward_)
#define DST_aux_size(x) 	((x)->rec_data.aux_size_)
#define DST_aux_align(x) 	((x)->rec_data.aux_align_)
#define DST_aux_field_size(x) 	((x)->rec_data.aux_field_size_)
#define DST_aux_field_off(x) 	((x)->rec_data.aux_field_off_)
#define DST_aux_field_align(x) 	((x)->rec_data.aux_field_align_)
#define DST_aux_qual(x) 	((x)->rec_data.aux_qual_)
#define DST_aux_var_bound(x) 	((x)->rec_data.aux_var_bound_)
#define DST_extension(x) 	((x)->rec_data.extension_)
#define DST_string(x) 		((x)->rec_data.string_)
#define DST_const(x) 		((x)->rec_data.const_)
#define DST_reference(x) 	((x)->rec_data.pointer_)
#define DST_record(x) 		((x)->rec_data.record_)
#define DST_union(x) 		((x)->rec_data.record_)
#define DST_aux_type_deriv(x) 	((x)->rec_data.aux_type_deriv_)
#define DST_locpool(x) 		((x)->rec_data.string_tab_)
#define DST_variable(x) 	((x)->rec_data.variable_)
#define DST_label(x) 		((x)->rec_data.label_)
#define DST_entry(x) 		((x)->rec_data.entry_)
#define DST_aux_lifetime(x) 	((x)->rec_data.aux_lifetime_)
#define DST_aux_ptr_base(x) 	((x)->rec_data.aux_ptr_base_)
#define DST_aux_src_range(x) 	((x)->rec_data.aux_src_range_)
#define DST_aux_reg_val(x) 	((x)->rec_data.aux_reg_val_)
#define DST_aux_unit_names(x) 	((x)->rec_data.aux_unit_names_)
#define DST_aux_sect_info(x) 	((x)->rec_data.aux_sect_info_)


/*
 * Type codes for loc strings. I'm not entirely certain about all of
 * these, but they seem to work.
 *				troy@cbme.unsw.EDU.AU
 * If you find a variable whose location can't be decoded, you should
 * find out it's code using "dstdump -s filename". It will record an
 * entry for the variable, and give a text representation of what
 * the locstring means. Before that explaination there will be a
 * number. In the LOCSTRING table, that number will appear before
 * the start of the location string. Location string codes are
 * five bit codes with a 3 bit argument. Check the high 5 bits of
 * the one byte code, and figure out where it goes in here.
 * Then figure out exactly what the meaning is and code it in
 * dstread.c
 *
 * Note that ranged locs mean that the variable is in different locations
 * depending on the current PC. We ignore these because (a) gcc can't handle
 * them, and (b), If you don't use high levels of optimisation they won't
 * occur.
 */
typedef enum
{
	dst_lsc_end,		/* End of string */
	dst_lsc_indirect,	/* Indirect through previous. Arg == 6 */
				/* Or register ax (x=arg) */
	dst_lsc_dreg,		/* register dx (x=arg) */
	dst_lsc_03,
	dst_lsc_section,	/* Section (arg+1) */
	dst_lsc_05,
	dst_lsc_06,
	dst_lsc_add,		/* Add (arg+1)*2 */
	dst_lsc_sub,		/* Subtract (arg+1)*2 */
	dst_lsc_09,
	dst_lsc_0a,
	dst_lsc_sec_byte,	/* Section of next byte+1 */
	dst_lsc_add_byte,	/* Add next byte (arg == 5) or next word
				 * (arg == 6)
				 */
	dst_lsc_sub_byte,	/* Subtract next byte. (arg == 1) or next
				 * word (arg == 6 ?)
				 */
	dst_lsc_sbreg,		/* Stack base register (frame pointer). Arg==0*/
	dst_lsc_0f,
	dst_lsc_ranged,		/* location is pc dependent */
	dst_lsc_11,
	dst_lsc_12,
	dst_lsc_13,
	dst_lsc_14,
	dst_lsc_15,
	dst_lsc_16,
	dst_lsc_17,
	dst_lsc_18,
	dst_lsc_19,
	dst_lsc_1a,
	dst_lsc_1b,
	dst_lsc_1c,
	dst_lsc_1d,
	dst_lsc_1e,
	dst_lsc_1f
} dst_loc_string_code_t;

/* If the following occurs after an addition/subtraction, that addition
 * or subtraction should be multiplied by 256. It's a complete byte, not
 * a code.
 */

#define	dst_multiply_256	((char) 0x73)

typedef struct
{
	char	code : 5;
	char	arg : 3;
} dst_loc_header_t ALIGNED1;

typedef union
{
	dst_loc_header_t header;
	char	data;
} dst_loc_entry_t ALIGNED1;

#undef ALIGNED1
#endif  /* apollo_dst_h */
generated by cgit v1.1 at 2025-02-06 06:03:44 +0000