home *** CD-ROM | disk | FTP | other *** search
/ The CIA World Factbook 1992 / k3bimage.iso / sel / 04 / 0034 / iso_0088.iso < prev    next >
Encoding:
Text File  |  1991-12-02  |  4.4 KB  |  119 lines
  1. COMMAND:  DEBUG
  2.  
  3. FUNCTION: Loads, displays and allows changes to machine code files. Controls
  4.           the execution of assembler programs so that they may be debugged
  5.           without reassembling them.
  6.  
  7. FORMAT:   DEBUG [d:][path][filename[.ext]][parm1][parm2]
  8.  
  9. TYPE:     DOS external command
  10.  
  11. REMARKS:  If a filename is specified on the command line, then DEBUG loads
  12.           the specified file into memory and operates on it. If no filename
  13.           is specified, DEBUG operates on the present contents of memory and
  14.           any required files must be loaded using the Name and Load commands.
  15.           The optional command line parameters allow various memory address
  16.           and file specification options to be specified at startup. These
  17.           are described in detail in the DOS Manual.Once DEBUG is started,
  18.           commands can be entered interactively at the hyphen (-) prompt.
  19.           Commands may be in upper or lower case and may be separated from
  20.           parameters by delimiters. Press Ctrl-Break to terminate a command
  21.           and Ctrl-NumLock to suspend the display (press any other character
  22.           to restart the display). The available commands are:
  23.  
  24.           A [address]
  25.  
  26.           Assembles IBM PC Macro Assembler language statements directly into
  27.           memory starting at the specified address.  Press Enter to return to
  28.           the DEBUG prompt.
  29.  
  30.           C range address
  31.  
  32.           Compares the contents of two blocks of memory, where the length of
  33.           the comparison is specified by range and the start points are
  34.           specified by range and address.
  35.  
  36.           D [address] or D [range]
  37.  
  38.           Displays the contents of the specified portion of memory in both
  39.           hexadecimal and ASCII formats.
  40.  
  41.           E address [list]
  42.  
  43.           Replaces the contents of one or more bytes, starting at the specified
  44.           address, with the values contained in the list or displays and allows
  45.           modification of bytes in a sequential manner.
  46.  
  47.           F range list
  48.  
  49.           Fills the memory locations specified in the range with the values in
  50.           the list.
  51.  
  52.           G [=address] [address[address...]]
  53.  
  54.           Executes the program currently being debugged with or without
  55.           specified breakpoints.
  56.  
  57.           H value value
  58.  
  59.           Adds the two hexadecimal values, subtracts the second from the
  60.           first, and displays the sum and difference on one line.
  61.  
  62.           I portaddress
  63.  
  64.           Inputs and displays in hexadecimal one byte from the specified port.
  65.  
  66.           L [address[drive sector sector]]
  67.  
  68.           Loads a file or absolute diskette sectors into memory.
  69.  
  70.           M range address
  71.  
  72.           Moves the contents of the memory locations specified by range to the
  73.           locations beginning at address.
  74.  
  75.           N filespec [filespec...]
  76.  
  77.           Formats file control blocks for the first two filespecs for use by
  78.           the Load and Write commands.
  79.  
  80.           O portaddress byte
  81.  
  82.           Sends the byte to the specified output port.
  83.  
  84.           Q
  85.  
  86.           Quits DEBUG and returns to DOS without saving the work file currently
  87.           in memory.
  88.  
  89.           R [registername]
  90.  
  91.           Displays the hexadecimal contents of a single register and allows
  92.           changes to be made to those contents, or displays the hexadecimal
  93.           contents of all the registers, the alphabetic flag settings, and the
  94.           next instruction to be executed, or displays the alphabetic flag
  95.           settings and allows changes to be made to any or all of them.
  96.  
  97.           S range list
  98.  
  99.           Searches the range in memory for the character(s) in list and
  100.           displays the addresses where matches are found.
  101.  
  102.           T [=address][value]
  103.  
  104.           Executes one or more instructions at a time and displays the contents
  105.           of all registers and flags after each instruction executes.
  106.  
  107.           U [address] or U [range]
  108.  
  109.           Unassembles instructions and displays their addresses and hexadecimal
  110.           values along with assembler-like statements in the specified memory
  111.           locations.
  112.  
  113.           W [address[drive sector sector]]
  114.  
  115.           Writes the data being debugged to a diskette file.
  116.  
  117.           Refer to the DOS Manual for details on these commands and for
  118.           more information on the formats of individual parameters.
  119.