home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / std_unix / volume.27 / text0089.txt < prev    next >
Encoding:
Text File  |  1992-05-20  |  8.7 KB  |  238 lines
  1. Submitted-by: ahby@ui.org (Shane P. McCarron)
  2.  
  3. The UNIX International Programming Languages Special Interest Group
  4. has completed a draft of the DWARF debugger format specification, and
  5. is making it available for industry review.  As with all UNIX 
  6. International developed specifications, this document is available 
  7. for distribution without restriction under an X Window System-like
  8. copyright.
  9.  
  10. Attached below is the Foreword and Introduction from the document.  If
  11. you would like to receive a copy, send mail to archive@ui.org
  12. containing the following:
  13.  
  14.     path yourname@your.site
  15.     send PUBLIC/dwarf.v1.mm
  16.  
  17. for the troff source, or
  18.  
  19.     send PUBLIC/dwarf.v1.ps
  20.  
  21. for the postscript.  If you system supports uncompress and uudecode, you 
  22. can request that the data be compressed by placing the command 'compress'
  23. in the message.
  24.  
  25. If you have any questions about the archive service, please contact
  26. me.  If you have questions about the Programming Languages SIG or the
  27. DWARF specification, please contact the SIG chair, Dan Oldman, at
  28. d.oldman@ui.org.  If you are interested in participating in the
  29. ongoing discussions of the Programming Languages SIG, please send a
  30. message containing your fully qualified internet address to
  31. plsig-request@ui.org.
  32.  
  33. --
  34. Shane P. McCarron            ATT:    +1 201 263-8400 x232
  35. Project Manager                UUCP:    s.mccarron@ui.org
  36.  
  37.  
  38.  
  39.        DWARF Debugging Information Format
  40.  
  41.  
  42.        FOREWORD
  43.  
  44.        This  document  specifies  a  new  generation  of   symbolic
  45.        debugging  information  that  has been developed by the UNIX
  46.        International Programming Languages Special  Interest  Group
  47.        (SIG),  and  is  being  circulated  for industry review.  We
  48.        started  from  the  document  DWARF  Debugging   Information
  49.        Requirements  - Issue 2, dated April 4, 1990, made available
  50.        by AT&T to its source licensees,  and  added  a  significant
  51.        amount  of material to clarify what was originally specified
  52.        and to support additional language constructs that were  not
  53.        in the original specification.
  54.  
  55.        At  this  point,  the  SIG  believes  that   this   document
  56.        sufficiently  supports  the  debugging  needs of C, C++, and
  57.        FORTRAN 77, and we have released it for public comment.   We
  58.        will  accept  comments on this document until June 15, 1992.
  59.        Comments may be directed via email to me or  posted  to  the
  60.        SIG  mailing list (plsig@ui.org).  If you are unable to send
  61.        email, paper mail, FAX, or machine readable  copy  on  UNIX,
  62.        MS-DOS, or Macintosh compatible media can be sent to me, and
  63.        I will post it for you.
  64.  
  65.                            Tony D'Annunzio
  66.                            Vice President of Technology
  67.                            UNIX International
  68.                            Waterview Corporate Center
  69.                            20 Waterview Boulevard
  70.                            Parsippany, NJ 07054
  71.                            Phone:    +1 201-263-8400
  72.                            Fax: +1 201-263-8401
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.        Revision: 1.0.0            Page 1           January 20, 1992
  96.                           Industry Review Draft
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.                                           Programming Languages SIG
  106.  
  107.  
  108.        1.  INTRODUCTION
  109.  
  110.        This  document  defines  the  format  for  the   information
  111.        generated  by compilers, assemblers and linkage editors that
  112.        is necessary  for  symbolic,  source-level  debugging.   The
  113.        debugging  information  format  does not favor the design of
  114.        any compiler or debugger.  Instead, the goal is to create  a
  115.        method  of  communicating  an accurate picture of the source
  116.        program to any debugger  in  a  form  that  is  economically
  117.        extensible  to  different languages while retaining backward
  118.        compatibility.
  119.  
  120.        The design of the  debugging  information  format  is  open-
  121.        ended,   allowing   for   the   addition  of  new  debugging
  122.        information  to  accommodate  new  languages   or   debugger
  123.        capabilities while remaining compatible with other languages
  124.        or different debuggers.
  125.  
  126.        1.1  Purpose and Scope
  127.  
  128.        The debugging information format described in this  document
  129.        is  designed  to  meet  the symbolic, source-level debugging
  130.        needs  of  different  languages  in  a  unified  fashion  by
  131.        requiring   language   independent   debugging   information
  132.        whenever possible.  Individual needs, such  as  C++  virtual
  133.        functions  or  Fortran  common  blocks  are  accommodated by
  134.        creating attributes that are used only for those languages.
  135.  
  136.        This document describes DWARF Version 1, which  is  designed
  137.        to  be binary compatible with the debugging information that
  138.        is described in the  document  DWARF  Debugging  Information
  139.        Requirements  -  Issue  2,  dated  April  4,  1990, and made
  140.        available by AT&T to its  source  licencess.  The  April  4,
  141.        1990,  document  describes the debugging information that is
  142.        generated by the UNIX System V  Release  4  C  compiler  and
  143.        consumed by the System V Release 4 debugger, sdb.
  144.  
  145.        By ``binary compatibility'' we mean that
  146.  
  147.          1.  All  features  intended  to  support  C  and   Fortran
  148.              described  in the April 4, 1990, document are included
  149.              in this document, and
  150.  
  151.          2.  DWARF produced according to  this  (DWARF  Version  1)
  152.              specification  should  be  considered well formed by a
  153.              System V Release 4 compatible DWARF consumer,  but may
  154.              contain  information that such a consumer is unable to
  155.              interpret.  Consumers  are  expected  to  ignore  such
  156.              information.
  157.  
  158.  
  159.  
  160.  
  161.        Revision: 1.0.0            Page 3           January 20, 1992
  162.                           Industry Review Draft
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.        DWARF Debugging Information Format
  172.  
  173.  
  174.        The intended audience for this document are  the  developers
  175.        of  both  producers  and consumers of debugging information,
  176.        typically language compilers, debuggers and other tools that
  177.        need  to interpret a binary program in terms of its original
  178.        source.
  179.  
  180.        This version of the document is a draft for industry review.
  181.        Vendors  developing  products  based on this draft should be
  182.        aware that the review process may produce changes.
  183.  
  184.        1.2  Overview
  185.  
  186.        There are two major pieces to the description of  the  DWARF
  187.        format  in  this document.  The first piece is the debugging
  188.        information, itself.   Section  two  describes  the  overall
  189.        structure  of that information.  Section three describes the
  190.        specific  debugging  information  entries   and   how   they
  191.        communicate  the  necessary  information  about  the  source
  192.        program to a debugger.
  193.  
  194.        The second piece of the DWARF description  is  the  way  the
  195.        debugging  information  is  encoded  and  represented  in an
  196.        object file.  The DWARF encoding  is  presented  in  section
  197.        four.
  198.  
  199.        Section five  describes  compatibility  constraints  on  the
  200.        format.     Finally,    section   six   describes   external
  201.        dependencies.
  202.  
  203.        In the following sections, text  in  normal  font  describes
  204.        required  aspects  of  the DWARF format.  Text in italics is
  205.        explanatory or supplementary material, and not part  of  the
  206.        format definition itself.
  207.  
  208.        1.3  Vendor Extensibility
  209.  
  210.        This document describes only the features of DWARF that have
  211.        been  implemented  and tested by at least one vendor (with a
  212.        very few exceptions).  It does  not  attempt  to  cover  all
  213.        languages  or even to cover all of the interesting debugging
  214.        information needs for its primary target languages (C,  C++,
  215.        Fortran).   Therefore the document provides vendors a way to
  216.        define their own  debugging  information  tags,  attributes,
  217.        fundamental   types,  type  modifiers,  location  atoms  and
  218.        language names, by reserving a portion of the name space and
  219.        valid  values  for  these  constructs  for  vendor  specific
  220.        additions.  Future versions of this document  will  not  use
  221.        names or values reserved for vendor specific additions.  All
  222.        names and values not reserved for vendor additions, however,
  223.        are  reserved  for  future  versions  of this document.  See
  224.        section 4 for details.
  225.  
  226.  
  227.        Revision: 1.0.0            Page 4           January 20, 1992
  228.                           Industry Review Draft
  229. -- 
  230. Shane P. McCarron            ATT:    +1 201 263-8400 x232
  231. Project Manager                UUCP:    s.mccarron@ui.org
  232.  
  233. [ I wasn't sure about allowing this here.  Please let me know whether
  234.  or not you, the readers, want information like this posted  -- mod ]
  235.  
  236. Volume-Number: Volume 27, Number 88
  237.  
  238.