home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpm / help / sid.hqp / SID.HLP
Encoding:
Text File  |  1985-02-10  |  6.4 KB  |  158 lines
  1. Calling SID
  2. SID commands
  3. Some command examples
  4. SID utility files
  5. :Calling the program
  6.  
  7.   Syntax:
  8.  
  9.        SID {pgm-filespec} {,sym-filespec}
  10.  
  11.   Explanation:
  12.  
  13.   The SID symbolic debugger  allows  you  to   monitor   and   test
  14.   programs  developed  for  the  8080 microprocessor.  SID supports
  15.   real-time  breakpoints,  fully  monitored   execution,   symbolic
  16.   disassembly,  assembly,  and  memory  display and fill functions.
  17.   SID  can  dynamically  load  SID  utility  programs  to   provide
  18.   traceback and histogram facilities.
  19.  
  20. : Commands:
  21.  
  22.         Command              Meaning
  23.  
  24.      As              (Assemble)    Enter assembly language
  25.                                    statements
  26.                                    s is the start address
  27.  
  28.      Cs{b{,d}}       (Call)        Call to memory location from SID
  29.                                    s is the called address
  30.                                    b is the value of the BC register
  31.                                    pair d is the value of the DE
  32.                                    register pair
  33.  
  34.      D{W}{s}{,f}     (Display)     Display memory in hex and ASCII
  35.                                    W is a 16-bit word format
  36.                                    s is the start address
  37.                                    f is the finish address
  38.  
  39.         Command              Meaning
  40.  
  41.      Epgm-filespec   (Load)        Load program and symbol table
  42.       {,sym-filespec}              for execution
  43.  
  44.  
  45.  
  46.      E*sym-filespec  (Load)        Load a symbol table file
  47.  
  48.      Fs,f,d          (Fill)        Fill memory with constant value
  49.                                    s is the start address
  50.                                    f is the finish address
  51.                                    d is an eight-bit data item
  52.  
  53.      G{p}{,a{,b}}     (Go)         Begin Execution
  54.                                    p is a start address
  55.                                    a is a temporary breakpoint
  56.  
  57.         Command              Meaning
  58.  
  59.      H                (Hex)        Displays all symbols with
  60.                                    addresses in Hex
  61.      H.a                           Displays hex, decimal, and ASCII
  62.                                    values of a where
  63.                                    a is a symbolic expression
  64.  
  65.      Ha,b                          Computes hex sum and difference
  66.                                    of a and b where
  67.                                    a and b are symbolic expressions
  68.  
  69.      Icommand tail   (Input)       Input CCP command line
  70.  
  71.      L{s}{,f}        (List)        List 8080 mnemonic instructions
  72.                                    s is the start address
  73.                                    f is the finish address
  74.  
  75.         Command              Meaning
  76.  
  77.      Ms,h,d          (Move)        Move Memory Block
  78.                                    s is the start address
  79.                                    h is the high address of the block
  80.                                    d is the destination start address
  81.  
  82.      P{p{,c}}        (Pass)        Pass point set, reset, and display
  83.                                    p is a permanent breakpoint address
  84.                                    c is initial value of pass counter
  85.  
  86.      Rfilespec{,d}   (Read)        Read Code/Symbols
  87.                                    d is an offset to each address
  88.  
  89.      S{W}s           (Set)         Set Memory Values
  90.                                    s is address where value is sent
  91.                                    W is 16 bit word
  92.  
  93.         Command              Meaning
  94.  
  95.      T{n{,c}}        (Trace)       Trace Program Execution
  96.                                    n is the number of program steps
  97.                                    c is the utility entry address.
  98.  
  99.      T{W}{n{,c}}     (Trace)       Trace Without Call
  100.                                    W instructs SID not to trace
  101.                                    subroutines
  102.                                    n is the number of program steps
  103.                                    c is the utility entry address
  104.  
  105.      U{W}{n{,c}}     (Untrace)     Monitor Execution without Trace
  106.                                    n is the number of program steps
  107.                                    c is the utility entry address
  108.                                    W instructs SID not to trace
  109.                                    subroutines
  110.  
  111.         Command              Meaning
  112.  
  113.      V                (Value)      Display the value of the next
  114.                                    available location in memory
  115.                                    (NEXT), the next location after
  116.                                    the largest file read in (MSZE),
  117.                                    the current value of the Program
  118.                                    counter (PC), and the address of
  119.                                    the end of available memory (END)
  120.  
  121.      Wfilespec,s,f  (Write)        Write the contents of a contiguous
  122.                                    block of memory to filespec.
  123.                                    f is finish address
  124.  
  125.      X{f}{r}        (Examine)      Examine/alter CPU state.
  126.                                    f is flag bit C,Z,M,E or I.
  127.                                    r is register A,B,D,H,S or P.
  128.  
  129. : Examples:
  130.  
  131.   A>SID
  132.  
  133.        CP/M loads SID from drive A into memory.  SID displays the
  134.        # prompt when it is ready to accept commands.
  135.  
  136.   A>B:SID SAMPLE.HEX
  137.  
  138.        CP/M loads SID and the program file SAMPLE.HEX into memory
  139.        from drive B.
  140.  
  141. : SID Utilities:
  142.  
  143.   SID utilities, HIST.UTL and TRACE.UTL are special  programs  that
  144.   operate with SID to provide additional debugging facilities.  The
  145.   mechanisms for system  initialization,   data   collection,   and
  146.   data  display  are  described  in the CP/M SID User's Guide.
  147.  
  148.   The HIST utility creates a histogram  (bar  graph)   showing  the
  149.   relative   frequency   of   execution   of   code within selected
  150.   program segments of the test program.  The  HIST  utility  allows
  151.   you   to  monitor  those  sections  of  code  that  execute  most
  152.   frequently.
  153.  
  154.   The TRACE utility obtains a backtrace of  the  instructions  that
  155.   led  to  a particular breakpoint address in a program under test.
  156.   You can collect  the  addresses  of  up   to   256   instructions
  157.   between pass points in U or T modes.
  158.