home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / utility / emulator / apple2em.lzh / Cli.doc < prev    next >
Encoding:
Text File  |  1991-04-18  |  5.0 KB  |  145 lines
  1.  
  2. CLI Basics
  3. ----------
  4. The ~ key (default value) will break the emulation and put the User into 
  5. the Command Language Interpreter (CLI). The CLI prompt is >>> .  The 
  6. user may type ? to see a list of available commands in the CLI. The CLI 
  7. allows partial completion of commands.  The partial command name must 
  8. be unambiguous.  For instance, "e" or "exam" may be 
  9. substituted for "examine".
  10.  
  11. General Commands
  12. ----------------
  13.  
  14. cd [path]    - With no paramters, displays current working directory (CWD).
  15.           Otherwise attempts to set the CWD to path.
  16.  
  17. continue or c    - Resume the emulation and refresh the screen.
  18.  
  19. escape [char]    - Make the character which breaks the emulator into char or
  20.           display current escape char.
  21.  
  22. dup l|p        
  23. pop l|p    
  24. push l|p|addr
  25.         - The CLI maintains a value stack for the convenience of 
  26.            the user.  The emulator doesnt use the stack at all.
  27.           Values may be pushed on the stack with push and
  28.           retrieved later with pop or dup.  The l and p parameters
  29.           are used to retrive/store values into the lpoint (list
  30.           point) and pc.
  31.  
  32. help        - Gives a quick list of commands
  33.  
  34. map        - Toggle lower to uppercase mapping during emulation.  The
  35.           default is to perform mapping.
  36.  
  37. quit         - Exit the Emulator
  38.  
  39. .            - Display the current point
  40.  
  41. ![command]    - Unix Shell escape.  Without command, the shell is called.
  42.            Otherwise, command is executed.
  43.  
  44. File Commands
  45. -------------
  46.  
  47. bload file addr
  48.       -  Bload will Allow the loading of binary images into the memory of
  49.          the emulator.  bload binfile F000  will load file "binfile" at
  50.      address F000.
  51.  
  52. bsave file addr1 size
  53.        - Bsave will save a section of memory to a file.  For instance,
  54.        bsave mybin 300 FF  will save all of the memory from 300 to 3FF
  55.      to file "mybin".
  56.  
  57. disk
  58.        - Display the names of the disks which are currently inserted in
  59.      the virtual disk drives.
  60.  
  61. insert file [drive#]
  62.        - Insert will make a file the disk in a particular drive. For 
  63.          Instance: insert mydisk  will make the file "mydisk" appear
  64.        to the emulator as the disk in drive 1.
  65.  
  66. Register Manipulation
  67. ---------------------
  68.  
  69. cl[cdinvz] - Clears Status register bit.  For instance, clc will clear
  70.          the carry bit.  clz will clear the zero bit.
  71.  
  72. se[cdinvz] - Set Status register bit.  For instance, sec will set the
  73.          carry flag.  sez will set the zero bit.
  74.  
  75. ld[axys] value 
  76.        - Load a value into a register.  lda ff will load ff into
  77.          the accumulator.  lds 02 will load 02 into the Stack Pointer.
  78.  
  79. jmp addr
  80.        - Sets PC = addr.  A continue will resume at that location.
  81.  
  82. reset or ~
  83.        - Sets PC = addr in the Apple II reset Vector.  Combined
  84.          with continue, will emulate the pressing of the reset
  85.          button on the Apple II.
  86.  
  87. Memory Manipulation/Examination
  88. -------------------------------
  89.  
  90. examine addr [addr]
  91.        - Display current memory location if no paramters are givin.
  92.          If one parameter is givin, the contents of that location are
  93.          displayed.  If two parameters are givin, all memory between
  94.          the two locations is displayed. examine 300 400 will display
  95.          all memory between $300 and $400. e 300 will display the
  96.          8 bit contents of $300
  97.  
  98. deposit addr value [value]+
  99.        - Put values into memory.  Addr must be specified as well as
  100.          one or more values.  Deposit 300 20  will put 20 into memory
  101.          location 300.  Deposit 300 10 20 30 40 will load 10,20,30,40
  102.          into consequtive addresses beginning at 300.
  103.  
  104. list [low] [high]
  105.        - Dissassembly.  If noparameters are supplied, dissassembly
  106.          begins at the current point and continues for 1 page. If
  107.          low is specified, dissassembly begins at low and continues
  108.          for 1 page.  If both low and high are specified the region
  109.          between low and high is dissassembled.
  110.  
  111. Debugging Commands
  112. ------------------
  113.  
  114. breakpoint [addr]
  115.        - Set breakpoint.  If addr is not specified, the current
  116.          breakpoint is displayed.  Otherwise, the breakpoint is set
  117.          to addr.  When PC == addr, the emulator breaks into the
  118.          command mode.  break 3FFF   sets the breakpoint to 3FFF.
  119.  
  120. nobreak       - Turn of breakpoint.
  121.  
  122. trace [low high] [file]
  123.        - Enable tracing.  With no parameters, the current trace status
  124.          is displayed.  When low and high are givin, tracing for that
  125.          region is enabled (i.e. when low <= pc <= high ).  An output
  126.          consisting of dissassembly and status registers is written to
  127.          the trace file.  If file is specified, output is sent to that
  128.          file, otherwise the file "trace" is used. For instance,
  129.          trace 3F0 400  will trace the region of 3F0-400 and send its
  130.          output to trace.
  131.  
  132. notrace       - Disable tracing.
  133.  
  134. phantom location high low [file]
  135.        - Enable phantom tracing of range low,high.  Phantom tracing
  136.          allows a trace to be performed AFTER location is reached.
  137.          For instance, phantom 300 F300 F400 will enable tracing of
  138.          f300-f400 only AFTER PC == 300. Once the PC has reached 300,
  139.          tracing between F300-F400 is enabled.  If file is specified
  140.          trace output will go to the specified file.  Otherwise, "trace"
  141.          is assumed.
  142. nophantom
  143.        - disable phantom trace.
  144.  
  145.