home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_progs / prog_oth / ninfo662.lha / ninfo.doc < prev    next >
Text File  |  1992-05-20  |  4KB  |  101 lines
  1.             ***************************************
  2.             ****Object/Executable Disassembler*****
  3.             *******Version 2.0 07 Aug 1991*********
  4.             *********** Copyrighted 1991  *********
  5.             **********All Rights Reserve  *********
  6.             **********Shareware Fee:  $5.00********
  7.             *********Custom Services      *********
  8.             *********P. O. Box 254        *********
  9.             *********Moorestown, NJ, 08057*********
  10.             ***************************************
  11.   Note:
  12.  
  13.   This program may be distributted on any system that does not
  14.   charge for time.  No charge may be made for this program without
  15.   the expressed written consent of Custom Services.  This program
  16.   and all documentation are the sole property of Custom
  17.   Services.  No warranty is supplied with this program.  This program
  18.   may be distributed as part of any shareware/PD collection where the
  19.   charges for the disks does not exceed the cost of the media by more
  20.   than five times.
  21.  
  22.  
  23.   General:
  24.  
  25.   This utility grew out of an attempt to understand the format of an
  26.   executable.  It is loosely based on the example given by the Lattice
  27.   compiler utility OMD.  Since OMD will only do object files, I create
  28.   this utility.
  29.  
  30.   NINFO should do objects, executables, and library files.  The library
  31.   index hunks are treated as raw data hunks.  The disassemble for the
  32.   code has a few small problems(see the known bugs section) but is mostly
  33.   complete for all 680x0 processors.  It will also do memory and virus
  34.   files(described later).
  35.  
  36.   Invoke NINFO as follows:
  37.  
  38.   NINFO [options]  file1 file2....filen
  39.  
  40.  Options:
  41.    -m<address> : Decode a block of memory aprox. 40 bytes in size.
  42.    -v          : Decode boot block dump (check virus code)
  43.    -s          : symbols supressed
  44.    -d          : data words supressed
  45.    -c          : code words supressed
  46.  
  47.  Default is to not suppress anything and the "-v" and "-m" are off(a regular
  48.  executable or object file not a bootblock).
  49.  
  50.  Realize that most files have alot of executable code.  A file that
  51.  is 4K in size might output over 1000 lines of code alone!  I usually
  52.  run a program thru NINFO with "-s -d -c" just to see the basic size
  53.  and structure of a program.
  54.  
  55.  The boot block code dump was written to decode virus code captured
  56.  using a utility such as DiskX.  It knows the structure of a system
  57.  boot block and will expect a 1024 word block of raw boot block to
  58.  work with.
  59.  
  60.  The Memory dump was written to allow you to examine code already loaded
  61.  into memory(like the trackdisk.device, or the graphics library).  The
  62.  option includes an address.  Note: the option "-m" must be followed by
  63.  an address without intervening spaces.  The default address is zero.
  64.  
  65.  Comercial time:
  66.  I only ask for a small registration fee if you would like updates
  67.  to this program.  I plan on fixing all reported bugs.  If you would
  68.  like an update send a Self-Addressed, Stamped mailer($0.65 postage)
  69.  and a disk(with your registration fee of $5.00 the first time) to:
  70.  
  71.      Custom Services
  72.      P. O. Box 254
  73.      Moorestown, NJ 08057
  74.  
  75.  If you include some of your PD/Shareware I will return the disk with
  76.  several programs I have done.
  77.  
  78.  
  79.  Revision History:
  80.  
  81.   Version 0.6  - Initial build, never released Lattice Compiler 3.02
  82.   Version 0.7  -                  "      "       "        "     3.10
  83.   Version 0.8  -                  "      "       "        "     4.00
  84.   Version 0.9  - First Shareware Release: Lattice Compiler  5.02
  85.                  added the MULU/MULS/DIVU/DIVS instructions.
  86.   Version 1.0  - Updated to fix several small bugs in instruction decoding
  87.                  Lattice 5.05.  Fixed the Hunks that have special loading
  88.                  flags in the high order bytes.
  89.   Version 2.0  - Updated to fix any instructions not decoding properly.
  90.                  Added the -v and -m options for bootblock and memory
  91.                  examine.  Recompiled with SAS/C 5.10a.
  92.                  removed the highlighting and italics in the banner.
  93.  Known Bugs:
  94.  
  95.  
  96.    Certain 68030/040 opcodes do not decode properly.
  97.  
  98.    If you find a problem with this program, please drop me a note
  99.    (a disk with the file having the problem would be nice!).
  100.  
  101.