home *** CD-ROM | disk | FTP | other *** search
/ Fish 'n' More 1 / FishNMoreVol1.bin / more / disks / amicus / 17 / texts / filebasics.doc < prev    next >
Encoding:
Text File  |  1987-04-25  |  5.4 KB  |  151 lines
  1.  
  2.          Help For Chopping, Hunkpadding, Squeezing, Unsqueezing, and
  3.                           Archiving Your Files.
  4.  
  5.                       By Stephen Pietrowicz (DR RITZ)
  6.                                    and
  7.                            Harv Laser (CBM*HARV)
  8.                                People Link
  9.  
  10.  
  11.  
  12. Chopping Files
  13. --------------
  14.  
  15.    The Xmodem protocol transmits data in 128 bytes "chunks".  When a file
  16. is uploaded using the Xmodem protocol, Xmodem automatically pads the file
  17. with null characters.  These characters must be stripped from executable
  18. files in order for the Amiga to recognize the file. (If you don't strip
  19. the characters, you'll get the message "Not an Object file").
  20.  
  21.    Files that need to be chopped normally include in their description
  22. what the exact byte count the program must be.
  23.  
  24. There are several utilities located in the library to chop your files to
  25. the correct length:
  26.  
  27. File           Format      Needs byte count? Description
  28. ------------------------------------------------------------------------
  29. Chop.msb       AmigaBasic  Yes               Prompts for files and count
  30. Trunc          Executable  Yes               Trunc <orig> <dest> <bytes>
  31. FixObj         Executable  No                FixObj <orig> <dest>
  32. Chop.Exe       Executable  Yes               Chop <orig> <dest> <bytes>
  33. Comm           Executable  No                Terminal Program
  34.  
  35. Where:
  36.  
  37.    <orig>      is what you called your downloaded file
  38.    <dest>      is what you want your chopped file to be called
  39.    <bytes>     is the count of how much the file should be chopped (in bytes)
  40.  
  41. For first time you first time "choppers", you should ASCII capture the file
  42. Chop.msb from section 14 of the library.  Download FixObj, and chop it
  43. to the correct length using your AmigaBasic program.  Be sure to specify
  44. different file names for the <orig> and <dest>.
  45.  
  46. Since FixObj is an intelligent chop program, you don't have to specify the
  47. correct byte count on your disk.
  48.  
  49. There are several terminal programs that automatically chop your files as
  50. they are being downloaded.  We recommend that you use the "Comm" series of
  51. terminal programs written by DJJAMES.  It is one of the more advanced public
  52. domain terminal programs, and has many features.   The current version of
  53. "Comm" can be found in the library by searching for the keyword "Comm".
  54.  
  55. HunkPad
  56. -------
  57.  
  58. FORMAT:        HunkPad  <obj>
  59.  
  60. Where:         <obj> is the name of the file to hunkpad.
  61.  
  62. In an effort to eliminate having to chop your downloads, a program called
  63. HunkPad "fixes" files before they are uploaded.  It adds the correct number
  64. of bytes to a file to make the total byte count divisible by 128.  Since
  65. Xmodem transmits 128 bytes per "chunk", no extra bytes will be added the
  66. xmodem upload once you HunkPad it.  HunkPad is located in the PLINK library.
  67.  
  68. Squeezing and Unsqueezing
  69. -------------------------
  70.  
  71. SQ -- Compact a file
  72.  
  73. FORMAT:     SQ <exe1>
  74.  
  75. Where:      <exe1> is the file you want to squeeze
  76.  
  77.  
  78.    When a file is squeezed using SQ, a new file is created, with a "q"
  79. somewhere in it's name.  For example, when the file  PLINK.TXT is squeezed,
  80. a new file is created, and is called:  PLINK.TQT.   This helps identify
  81. squeezed programs.                            ^
  82.  
  83. USQ -- Un-compact a file
  84.  
  85. FORMAT:     USQ <exe2>
  86.  
  87. Where:      <exe2> is the file you want to un-squeeze
  88.  
  89.    USQ is used to un-squeeze your compacted files.  It doesn't matter what
  90. you call the program when you download it to your system.  The correct file
  91. name is automatically saved when the program is squeezed.  USQing a file
  92. creates a new file on your disk.
  93.  
  94. Archives
  95. --------
  96.  
  97.    The most preferred format is ARC format.  The current version of the
  98. archiver can be found in the library.  Archives contain the best of both
  99. worlds:  They are always a multiple of 128, so they don't have to be
  100. chopped, and they automatically compact files.
  101.  
  102.    The archive program has a built in help command; all you have to type is
  103. the name of the archiver, and it will list the commands that you can use.
  104. The following are a few of the most frequently used commands:
  105.  
  106. ----
  107.  
  108. Archive Command: a   -- adds (creates) files to an archive
  109.  
  110. FORMAT:   ARC a <name> <file1> <file2> ... <filen>
  111.  
  112. Where:    <name>  is the name of the archive you want to add files to.  If
  113.                   the archive doesn't exist, ARC automatically creates it.
  114.  
  115.           <file1><file2>...<filen> are the names of the files to add.
  116.  
  117. ----
  118.  
  119. Archive Command: e   -- extract files from an archive
  120.  
  121. FORMAT:   ARC e <name>
  122.  
  123. Where:    <name>  is the name of the archive you are extracting files from.
  124.                   It's generally a good idea to list the contents of an
  125.                   archive to find out the size of the extracted files to
  126.                   make sure that you have enough room on the disk.
  127.  
  128. ----
  129.  
  130. Archive Command: v   -- list the contents of an archive
  131.  
  132. FORMAT:   ARC v <name>
  133.  
  134. Where:    <name>  is the name of the archive.
  135.  
  136. ARCing is the preferred method of storing files.  Please ARC programs before
  137. uploading them.
  138.  
  139. ----
  140.  
  141. Please print out this file and keep it handy for a ready-reference to these
  142. terms and their actions if these concepts are new to you.  Most popular
  143. computers, such as the IBM-PC and compatibles, don't care about Xmodem
  144. padding, on downloads... however Amiga is different... Xmodem padding
  145. on executable files is significant, and can cause you problems unless
  146. you are aware of the problem and its solutions.
  147.  
  148. DR RITZ (Steve)
  149. CBM*HARV (Harv)
  150.  
  151.