home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / sigm / vol179 / trace.lbr / TRACE.DQC / TRACE.DOC
Text File  |  1985-02-09  |  3KB  |  86 lines
  1.  
  2. TRACE.DOC ver. 1.1
  3.  
  4.      This is a simple-minded trace facility for Aztec CII
  5. programs.  When it is in operation, the C program prints out
  6. each source code line to CON: before executing it.  It may be
  7. helpful for debugging C programs.  The idea is very simple.
  8. The CII compiler can be requested to place the source code line
  9. into the .ASM file preceeding the assembler code generated by
  10. that line (the -T option).  The program TRACE reads such an
  11. .ASM file and writes a .TRA trace file where this is replaced
  12. by a call to a routine TRACE1 that prints out the source code
  13. line to the console (NOT to stdout).
  14.  
  15.  --------------------------------------------------------------
  16.  
  17.      The files required for TRACE are:
  18.  
  19.     TRACE.DOC    documentation
  20.     TRACE.C        trace program
  21.     TRACE1.ASM    run-time subroutine
  22.  
  23.      First, TRACE.C should be compiled and assembled.  This can
  24. be done by the following commands:  (Alternatives for Microsoft
  25. M80 use are in square brackets [] .)
  26.  
  27. A>CII TRACE.C        [ A>CII -M TRACE.C ]
  28.      Compilation produces TRACE.ASM.
  29. A>AS TRACE.ASM        [ A>M80 =TRACE.ASM/M ]
  30.      Assembly produces TRACE.O [TRACE.REL].
  31. A>ERA TRACE.ASM        [ A>ERA TRACE.ASM ]
  32.      Removes an unneeded file from the disk.
  33. A>LN TRACE.O LIBC.LIB    [ A>L80 TRACE/N,TRACE,SOFTLIB/S/E ]
  34.      Use your own library here.  Link produces TRACE.COM.
  35. A>ERA TRACE.O        [ A>ERA TRACE.REL ]
  36.  
  37.      Next, a relocatable module must be created from
  38. TRACE1.ASM.  This is done as follows:
  39.  
  40. A>AS TRACE1.ASM        [ A>M80 =TRACE1.ASM ]
  41.      Produces relocatable object file TRACE1.O [TRACE1.REL].
  42.  
  43.  --------------------------------------------------------------
  44.  
  45.      When these steps have been completed, you are ready to use
  46. TRACE.  You should have the two files TRACE.COM and TRACE1.O
  47. [or TRACE1.REL] on any disk where you want to prepare a trace.
  48. To trace the program TEST.C, for example, the following
  49. commands would be used:  (I have a SUBMIT file prepared to do
  50. this sequence automatically.)
  51.  
  52. A>CII -T TEST.C        [ A>CII -MT TEST.C ]
  53.      The -T option must be used.  This creates TEST.ASM.
  54. A>TRACE TEST        [ A>TRACE TEST ]
  55.      This creates TEST.TRA.
  56. A>ERA TEST.ASM        [ A>ERA TEST.ASM ]
  57. A>AS TEST.TRA        [ A>M80 =TEST.TRA/M ]
  58.      This creates TEST.O [or TEST.REL].
  59. A>ERA TEST.TRA        [ A>ERA TEST.TRA ]
  60. A>LN TEST.O TRACE1.O MY.LIB MATH.LIB LIBC.LIB
  61.     [ A>L80 TEST/N,TEST,TRACE1,MYLIB/S,MATHLIB/S,CLIB/S/E ]
  62.      Use your own libraries here.
  63. A>ERA TEST.O        [ A>ERA TEST.REL ]
  64.      Now TEST.COM should exist.  When it is executed, it will
  65. be traced.
  66.  
  67.  --------------------------------------------------------------
  68.      NOTE:  While a trace is in effect, the following control
  69. codes will be operable:
  70.  
  71.     ^S    freeze the program
  72.     ^Q    restart after ^S
  73.     ^T    stop trace printout, but continue program
  74.     ^R    restart trace printout
  75.     ^C    exit to CP/M
  76.  
  77.      I hope this weapon will be of some small use in the
  78. endless contest with the bug.
  79.  
  80. Gerald A. Edgar            September 4, 1983
  81. 107 W. Dodridge St.
  82. Columbus, OH 43202
  83.  
  84. CIS 70715,1324
  85. >CII -MT TEST.C ]
  86.      The -