home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS - Coast to Coast / simteldosarchivecoasttocoast2.iso / asmutil / bin.zip / BIN.DOC < prev   
Text File  |  1987-12-17  |  4KB  |  99 lines
  1. Docs for BIN.com - replacement for exe2bin conversion utility
  2. R. Trevithick, 12/17/87
  3.  
  4.  
  5. This is a general purpose replacement for the EXE2BIN utility which
  6. is no longer supplied free with DOS as it used to be.
  7.  
  8.  
  9. ****************************************************************************
  10. * It is based on the EXE2COM 1.00 program which was placed into the public *
  11. * domain by CHRIS DUNFORD of COVE SOFTWARE.  Thanks, Chris!                *
  12. ****************************************************************************
  13.  
  14. The only (trivial) changes I've made are as follows:
  15.  
  16.  
  17. - It's less than half the size, and a tad faster.
  18.  
  19. - It now allocates it's own 30k read-write buffer, and uses file handles 
  20.   as opposed to streams.
  21.  
  22. - The output file is not opened until _after_ the EXE header information
  23.   has been evaluated and BIN determines that conversion is possible.  An
  24.   existing file which matches the output filespec won't be needlessly 
  25.   trashed now.
  26.  
  27. - The program implements an abort if there is a non-zero code segment 
  28.   value in the EXE header.  This was defined but _not_ implemented in
  29.   the original program (I'll probably learn why the hard way;  Chris 
  30.   knows a lot more about this stuff than I do.)
  31.  
  32. - The program was made into a .com file for easy patching with Debug.
  33.  
  34. - The filenames are now handled exactly (I think) like they were in 
  35.   exe2bin, so existing batch and make files shouldn't need to be
  36.   modified (just rename bin.com to exe2bin.com.)  The default output
  37.   extension is '.bin', which dBase programmers will like, and semicolons
  38.   are trimmed off the names if entered.
  39.  
  40. Note that you can easily change the default output file extension
  41. by using Debug to patch the 3 bytes starting at offset 0c3dh.
  42.  
  43. You should probably display this area before patching, in case
  44. someone has given you a newer version of this program together
  45. with the older docs.  It should look like this, except that the 3C2C 
  46. part of the address (far left) will probably be different and does not 
  47. matter.
  48.  
  49. =============================================================================
  50. C>debug bin.com
  51. -d0c3d
  52. 3C2C:0C30                                         62 69 6E                bin
  53. 3C2C:0C40  00 00 00 2E 65 78 65 00-4D 5A 00 2E 63 6F 6D 00   ....exe.MZ..com.
  54. 3C2C:0C50  2D 57 61 72 6E 69 6E 67-3A 20 43 4F 4D 20 66 69   -Warning: COM fi
  55. 3C2C:0C60  6C 65 20 49 50 20 6E 6F-74 20 30 31 30 30 68 0D   le IP not 0100h.
  56. 3C2C:0C70  0A 00 65 78 65 32 62 69-6E 20 63 6F 6E 76 65 72   ..exe2bin conver
  57. 3C2C:0C80  73 69 6F 6E 20 2D 20 42-49 4E 20 73 72 63 66 69   sion - BIN srcfi
  58. 3C2C:0C90  6C 65 5B 2E 65 78 74 5D-20 5B 64 73 74 66 69 6C   le[.ext] [dstfil
  59. 3C2C:0CA0  65 2E 65 78 74 5D 00 2D-6F 75 74 20 6F 66 20 6D   e.ext].-out of m
  60. 3C2C:0CB0  65 6D 6F 72 79 00 6F 70-65 6E 65 64 00            emory.opened.
  61. =============================================================================
  62.  
  63.         The following Debug commands will change the default output file 
  64.         extension from '.bin' to '.com', which is the only thing you're 
  65.         likely to want to change it to:
  66.  
  67.         debug bin.com <enter>
  68.         e0c3d <enter>
  69.         63 <spacebar> 6f <spacebar> 6d <enter>
  70.         w  <enter>
  71.         q  <enter>
  72.  
  73.         You must use the LOWER CASE values for any characters you wish to
  74.         insert here.  E.g., the 'o' in "com" was inserted above as a 6fh
  75.         character rather than as a 4fh.  Note also that you must use HEX
  76.         values, not decimal!  Needless to say, if you have a C compiler
  77.         it will be easier to just change the source code and re-compile.
  78.  
  79.  
  80. This program remains, of course, in the public domain.  NOTE that
  81. although the program is based on Mr. Dunford's work, it has been revised
  82. considerably.  Any bugs or problems should NOT, therefore, be blamed on 
  83. him.  His program (available on most bulletin boards) works as 
  84. advertised.
  85.  
  86. I'm not releasing the source code until Mr. Dunford has a chance to 
  87. review it.
  88.  
  89.  
  90. Bob Trevithick                          GEnie address:  R.TREVITHICK
  91. Information Services Department
  92. Newark DDSO
  93. 703 E. Maple Ave
  94. Newark, NY  14513
  95.  
  96. Days:   (315) 331-1700  Ext. 2658
  97. Eves:   (315) 331-5266
  98.  
  99.