home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR16 / T2B120A.ZIP / BIN2TXT.DOC next >
Text File  |  1994-01-04  |  4KB  |  132 lines
  1.            BIN2TXT - Binary-to-Text Conversion Program
  2.                   Version 1.00 (January 3, 1994)
  3.                      Copyright 1994 Bruce Lum
  4.  
  5.  
  6.  
  7. DISCLAIMER
  8. ----------
  9.  
  10. The BIN2TXT program is provided "AS-IS".  You use this program
  11. strictly at your own risk.  No warranty of any kind exists.  The
  12. author is not responsible for any incidental or consequential
  13. damages to your computer or the data stored on it as a result of
  14. misuse or the inability to run the program.  By running BIN2TXT,
  15. you agree to this.
  16.  
  17.  
  18.  
  19. INTRODUCTION
  20. ------------
  21.  
  22. BIN2TXT is a utility program for the IBM PC (or compatible) that
  23. converts a binary file into a textual format.  This text file can
  24. be modified and reassembled into a binary format via the TXT2BIN
  25. program.
  26.  
  27.  
  28.  
  29. COMMAND SYNTAX
  30. --------------
  31.  
  32. To run BIN2TXT from the DOS prompt, use the following syntax:
  33.  
  34.     BIN2TXT  [option...]  <binaryfile>  <target>
  35.  
  36. where:
  37.  
  38.     [option] is one or more special instructions to be used
  39.     during the conversion process;
  40.  
  41.     <binaryfile> is the name of the binary file to be converted;
  42.  
  43.     <target> is the name of the output text file or device.
  44.  
  45.  
  46.  
  47. THE CONTENTS OF THE TEXT FILE
  48. -----------------------------
  49.  
  50. BIN2TXT generates a text file that is compatible with the TXT2BIN
  51. format.  Thus, if you make any changes, you can use the TXT2BIN
  52. program to recreate the binary file.  (See TXT2BIN.DOC for
  53. instructions.)
  54.  
  55.  
  56. The text file starts with a header area which identifies the name
  57. of the binary file:
  58.  
  59.  
  60. ;-----------------------------------------------------------------
  61. ; FILENAME.EXT
  62. ;
  63. ; Converted to text format by BIN2TXT on Mon Jan 03 23:00:59 1994
  64. ;
  65. ; (Use TXT2BIN to generate the binary image)
  66. ;-----------------------------------------------------------------
  67.  
  68.  
  69. Since the bytes are represented in hexadecimal format, the next
  70. line changes the radix accordingly:
  71.  
  72.     .RADIX 16       ; Set radix to HEXADECIMAL (base 16)
  73.  
  74.  
  75. All the bytes in the binary file are now presented in one or more
  76. lines.  Sixteen (16) bytes, along with their ASCII character
  77. representations, appear on each line.  The starting file offset
  78. for each line of bytes appears between the hexadecimal bytes and
  79. the ASCII characters.
  80.  
  81.  
  82. For example:
  83.  
  84.  
  85. ;  0  1  2  3  4 ...  A  B  C  D  E  F            0123456789ABCDEF
  86. ;-----------------------------------------------------------------
  87.   4D 5A 20 00 2C ... 00 00 FF FF 3A 05    ;00000  MZ .,.1. .....:.
  88.   80 00 00 00 00 ... 00 00 01 00 FB 30    ;00010  ........>......0
  89.  
  90. <-------------- BYTES --------------->       ^    <--- ASCII ---->
  91.                                              |       CHARACTER
  92.                                              |     REPRESENTATION
  93.                                              |
  94.                                          STARTING
  95.                                         FILE OFFSET
  96.  
  97.  
  98.  
  99. COMMAND-LINE OPTIONS
  100. --------------------
  101.  
  102. Only one option is currently available in BIN2TXT that you can
  103. use during the conversion process.
  104.  
  105.     -q      QUIET switch.  This option eliminates all status and
  106.             error messages that are normally displayed on the
  107.             screen.
  108.  
  109.                 Example:
  110.  
  111.                     BIN2TXT -q INFILE.BIN OUTFILE.TXT
  112.  
  113.  
  114.  
  115. CORRESPONDENCE
  116. --------------
  117.  
  118. If you have any problems, questions, or any type of feedback,
  119. electronic mail may be sent to the author (Bruce Lum) at the
  120. following addresses:
  121.  
  122.     Compuserve:     72727,3104
  123.     Internet:       72727.3104@compuserve.com
  124.  
  125.  
  126. If you are using the postal service, the address is:
  127.  
  128.     Bruce Lum
  129.     P.O. Box 5098, Station A
  130.     Toronto, Ontario
  131.     CANADA  M5W 1N4
  132.