home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 June / SIMTEL_0692.cdr / msdos / dskutl / cross10.arc / CROSS.DOC next >
Encoding:
Text File  |  1980-01-01  |  5.1 KB  |  134 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.     CROSS and UNCROSS 1.0 (c) 1989 by Craig Markwardt
  8.     
  9.     Description:  Splits large files into diskette-sized chunks.
  10.  
  11.     Usage:    CROSS [{/|-}{sSIZE|oOUTFILE|h|?}] [d:path]filename d:[outputpath]
  12.  
  13.               UNCROSS [{/|-}{t|h|?}] [d:path]filename d:[outputpath]
  14.  
  15.        OPTIONS:
  16.  
  17.          sSIZE     Forces output files to be SIZE bytes in size.
  18.  
  19.          oOUTFILE  Forces output file name to OUTFILE (don't include extension).
  20.  
  21.          t         Tests CROSSed file for integrity.
  22.  
  23.          ? or h    Brings up quick help.
  24.  
  25.     Synopsis:  CROSS takes any sized file and chops it into smaller, disk-sized
  26.                files for floppy disk transfer.  It allows for disk swapping and
  27.                hard disk operation.  CROSS determines whether the output disk is
  28.                removable media or not.  If it is removable, CROSS calculates the
  29.                size of the disk and then copies the data from the input file onto
  30.                the disk and includes a small (less than 50 bytes) header
  31.                describing the filename, attributes, creation dates, and a 16-bit
  32.                CRC.  It automatically prompts for the next disk when needed.  It
  33.                appends the extension ."xxx" where "xxx" is the chunk number.  If
  34.                CROSS detects a hard disk as the output drive, then it
  35.                automatically writes chunks of 360k unless otherwise specified by
  36.                the s option.  If you specify a size for the s option, CROSS will
  37.                create output files of that size in bytes.  Specifying an output
  38.                name using the o option creates files with that name.  However,
  39.                don't specify an extension for the o option since the chunk number
  40.                will replace it.  Remember, don't leave spaces between the option
  41.                letter and its argument.
  42.                    CROSS uses 50 bytes for each output chunk it processes for
  43.                header information and other stuff.  It calculates and records a
  44.                16-bit CRC for each chunk during CROSSing for data verification.
  45.                    UNCROSS assembles the original files from its disk-sized
  46.                chunks.  It first checks the header to see if it was created with
  47.                a compatible version of CROSS.  If it is compatible, then it
  48.                creates the output file on the designated disk.  It then copies
  49.                the data from chunk to the output file and performs CRC data
  50.                checking.  When it is finished with all of the chunks, it then
  51.                resets file attributes and creation dates.  The t option is used
  52.                to test the integrity of CROSSed chunks.
  53.  
  54.     Examples:  CROSS myfile.dat A:
  55.                CROSSes myfile.dat to the A: drive and uses all free space on A:.
  56.                The output files will be named A:myfile.0, A:myfile.1, etc.
  57.                
  58.                CROSS -s1200000 myfile.dat A:
  59.                Forces the output files to be 1.2 meg in size.
  60.                
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. CROSS, UNCROSS          Craig Markwardt                      page 2
  71.  
  72.  
  73.                CROSS /oYOURFILE myfile.dat B:
  74.                CROSSes myfile.dat to the B: drive with output files named
  75.                yourfile.0, yourfile.1, yourfile.2, etc.  UNCROSSing will restore
  76.                the original filename of myfile.dat.
  77.                
  78.                CROSS myfile.dat C:\TEMP
  79.                CROSSes myfile.dat to the hard drive directory \TEMP with a
  80.                default chunk size of 360K.  Use the s option to change the
  81.                default size.
  82.                
  83.                UNCROSS A:yourfile C:
  84.                UNCROSSes the file yourfile from the A: drive to the C: drive.  As
  85.                in the example above, yourfile would be converted back to the
  86.                original filename myfile.dat.
  87.                
  88.                UNCROSS /t A:yourfile
  89.                Tests integrity of A:yourfile chunks.
  90.  
  91.     Bugs:      CROSS and UNCROSS cannot handle wildcards.
  92.                
  93.                You must have 78K free RAM to run CROSS or UNCROSS.
  94.                
  95.                Currently, CRC checking/calculating is kind of slow, but future
  96.                releases will have table lookup CRC.
  97.                
  98.                Remember, this program is in its first release, and there are
  99.                bound to be bugs a-crawling everywhere, especially on special
  100.                configurations.  Please send all bug reports to the addresses
  101.                listed below.
  102.  
  103.     Send all bug reports or suggestions to wboson@portia.stanford.edu on
  104.          Internet, or Jacob Brostoff in the Private Email conference on
  105.          Exec-PC, or to Jacob Brostoff at the Forecast Office (Milwaukee).
  106.  
  107.     If you find CROSS and UNCROSS useful and can spare a small contribution, I
  108.          would appreciate any donation that you feel appropriate.  Please contact
  109.          the above locations by Email if you're interested in making
  110.          contributions.
  111.  
  112.     Craig Markwardt and Jacob Brostoff
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.