
  Disk-Image Transfer Utility                              Backup Utility

  Usage:
     DITU <Source> <Target>

  Purpose:
     Copy disk sectors into a file, or vice versa

  Options:
     Source and Target must be either ...

     <Disk>:<Geometry>  - Where <Disk> is the BIOS disk number
                        - <Geometry> is the disk geometry in
                          <Tracks>:<Heads>:<Sector> format
                        - Examples  0:80:2:18, 1:40:2:9

     <Filename>         - File or path name of the disk image
                        - The filename should NOT start with a digit
                        - File extension of IMG will be assumed
                        - Examples  FLOPPY, FLOPPY.IMG

     Source and Target may not be the same type of media.

  Examples:
     DITU 1:80:2:15 ROOTDISK
       Copies the entire disk (1.2 Mb) from drive B: to a file
       called ROOTDISK.IMG

     DITU NET$DOS.SYS 0:80:2:18
       Copies the contents of the file NET$DOS.SYS to the 1.44 Mb
       disk in drive A:

     DITU SYSTEM 128:160:4:18
       Copies 160 cylinders of data from drive C (the first hard
       disk) into a file called SYSTEM.IMG. The hard disk has 4
       drive heads per cylinder, and 18 sectors per drive head.

  Responses:
     Specify Source and Target parameters
       Not enough parameters were specified on the command line.
       Check the usage and try again.
     Transfer type must be disk-image or image-disk
       Wrong kind of parameters were specified. Transfer can only
       take place between disk and file, not between two types of
       the same media (ie, disk-disk and file-file are invalid).
     Source: BIOS Drive: 0 [80:2:15]
     Target: Image File: FLOPPY.IMG
        Ready to start copying. Press Enter to start, or any other
        key to cancel.
     Copy aborted
        User did not press Enter when asked to verify parameters.
     open() failed
        Unable to open the image file for image-disk transfer.
        Check that the path is correct, and that the file exists.
     creat() failed
        Unable to create image file for disk-image transfer.
        Check that the path is correct, and that you have write
        permission.
     write() failed
        Unable to write data to the image file. Usually caused by
        the storage space running out.
     Copy aborted: Too many errors
        Copying exceeded the error threshold (set to 18 errors).
     Copy Completed with x errors
        Copying completed, but errors occured during the transfer.
     Partial Copy Complete
        Image file was copied successfully, but it was not long
        enough to span the entire target disk.
     Copy Completed
        Transfer completed successfully.

  Notes:
     This program is freeware and you are encouraged to distribute it.
     Source code (for TopSpeed or Watcom C) is included.

     Written by Fauzan Mirza (F.U.Mirza@sheffield.ac.uk)

