home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / unix / volume13 / zap / Read.Me < prev    next >
Encoding:
Text File  |  1988-01-31  |  1.9 KB  |  71 lines
  1. This is zap, a binary file inspector/patcher.
  2.  
  3. Written by Johan Vromans at Multihouse Research, Gouda, the Netherlands.
  4. Copyright 1987 Johan Vromans.
  5. Distribution free as long as you give credit to the original author.
  6. Military use and explicit resale prohibited.
  7.  
  8. Features include -
  9.  
  10.  - looking at the file by byte, word or longword,
  11.  - display contents in octal, hex, decimal and ascii,
  12.  - searching for bytes/words/longwords
  13.  - verification of changes
  14.  - buffered update with optional checksum
  15.  - runs on Unix, VAX/VMS and MS-DOS
  16.  
  17. Zap mimics a program called SIPP (Save Image Patch Program), which
  18. was supplied by Digital Equipment Corp. with the RT-11 operating system.
  19.  
  20. ----------------
  21.  
  22. Building zap
  23.  
  24. Zap is pretty portable, mainly because it does not use difficult things.
  25. No shell escapes, no tty rubbish, only standard IO.
  26.  
  27. The only thing which is important to zap is whether your system
  28. has byte ordering like a VAX or not.
  29. When it has its bytes ordered VAX-wise, you may compile zap with -DSWAB=1,
  30. otherwise use -DSWAB=0. If you are not sure: don't specify -DSWAB and zap 
  31. will find out itself.
  32.  
  33. This distribution contains:
  34.  
  35.     Read.Me        this file
  36.     zap.c        C program source
  37.     zap.1        nroff -man manual page
  38.     Makefile    makefile for unix
  39.     mkzap.com    compile for VAX/VMS
  40.     mkzap.bat    compile for MS-DOS
  41.  
  42. ----------------
  43. Special notes for Unix:
  44.  
  45.  - the program has been tested on System V and BSD.
  46.  
  47.  - on swabbing and non-swabbing machines.
  48.  
  49. Special notes for VAX/VMS:
  50.  
  51.  - the program has been tested with VAX-C (not VAX11C).
  52.  
  53.  - always compile with /DEFINE=(SWAB=2) (use the mkzap.com file).
  54.  
  55.  - performs well, but probably limited to stream-lf files.
  56.  
  57. Special notes for MS-DOS:
  58.  
  59.  - the program has been tested with Microsoft C V4 using small model.
  60.  
  61.  - always compile with -DLINT_ARGS.
  62.  
  63. ----------------
  64.  
  65. Suggestions and enhancements are welcome!
  66.  
  67. Johan Vromans, Multihouse Research
  68. Usenet: jv@mh.nl via european backbone mcvax.
  69.  
  70. Disclaimer: Usage of this program is always at your own risk.
  71.