home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Interactive Guide / c-cplusplus-interactive-guide.iso / c_ref / csource4 / 210_01 / dump.doc < prev    next >
Encoding:
Text File  |  1985-11-15  |  2.9 KB  |  50 lines
  1.  
  2.                      --- Dump.Doc for Dump.C V 1.7 ---
  3.                 A memory HEX/ASCII Dump program by K.G.Busch
  4.                 --------------------------------------------
  5.  
  6.         Dump.C a 'C' language utility was written, as was this DOC file on
  7.     the Mix Split Screen Text Editor. The Mix 'C' Compiler and Linker were
  8.     also used to compile and link the program by K.G.Busch in Oct 1986.
  9.         All were done on the Radio Shack TRS-80 Model 4 with the Montezuma
  10.     Micro CP/M 2.2 operating system. For those who intend to rewrite this
  11.     utility for another system or compiler, the peek function used in my
  12.     hlook and alook functions is a non-standard function. Beyond that one
  13.     discrepancy it should be a very easy task to rewrite and improve this
  14.     utility for use with another system or for other purposes.
  15.         The program essentially consists of two nested DO WHILE loops, a
  16.     FOR loop and four functions written by me.
  17.         The first of the four functions is the head() function that prints
  18.     out the headers for the memory address columns and sixteen low byte
  19.     addresses.
  20.         The border() function prints a double line separator, composed of
  21.     equal characters, between the header line and the lines of memory data
  22.     that are in HEX format.
  23.         The hlook() function extracts the bytes of data from sixteen
  24.     sequential memory addresses and prints the information out in a HEXA-
  25.     DECIMAL format.
  26.         The alook() function extracts the same sixteen bytes as the hlook()
  27.     function and checks to see if they are printable characters. If the
  28.     bytes of data are printable they are then printed, otherwise a period
  29.     is substituted for non-printable characters.
  30.         The first input is for the location address in memory to start
  31.     looking at data. This address must be in the HEXADECIMAL format. The
  32.     subsequent inputs are a <ENTER> key to read the next page of data,
  33.     consisting of two hundred fifty six bytes of data or another key and
  34.     the <ENTER> key. The later will return you to the HEX address input
  35.     request. A control 'C' will exit the program and return control to the
  36.     CP/M operating system.
  37.         There are two COM files, DUMP.COM and DUMPS.COM. Both are from the
  38.     DUMP.C file, however the DUMP.COM file was linked with the RUNTIME.OVY
  39.     and the DUMPS.COM was linked with the SMALLCOM.OVY. Neither file has
  40.     had the SPEED UTILITY or the SHRINK UTILITY applied to them and each
  41.     will perform in an identical manner.
  42.         I would appreciate receiving printed copies of any 'C' source
  43.     improvements that may be made.
  44.                                             Kenneth G. Busch
  45.                                             12615 Higa Place
  46.                                             San Diego, Ca. 92128
  47.  
  48.  
  49. th the RUNTIME.OVY
  50.     and the DUMPS.COM was linked with the SMALLCOM.OVY.