================================================================================
  FREE PUBLIC LICENSE
================================================================================

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:

  1. Every product and solution using this software, must be free
     of any charge. If the software is used by a client part, the
     server part must also be free and vice versa.

  2. Each redistribution must retain the copyright notice, and
     this list of conditions and the following disclaimer.

  3. Redistributions in binary form must reproduce the above copyright
     notice, this list of conditions and the following disclaimer in
     the documentation and/or other materials provided with the
     distribution.

  4. All advertising materials mentioning features or use of this
     software must display the following acknowledgment:
       "This product includes software developed by BebboSoft,
        written by Stefan Bebbo Franke. (http://www.bebbosoft.de)"

  5. Redistributions of any form whatsoever must retain the following
     acknowledgment:
       "This product includes software developed by BebboSoft,
        written by Stefan Bebbo Franke. (http://www.bebbosoft.de)"

================================================================================
DISCLAIMER OF WARRANTY

Software is provided "AS IS," without a warranty of any kind.
You may use it on your own risk.

================================================================================
LIMITATION OF LIABILITY

I SHALL NOT BE LIABLE FOR ANY DAMAGES SUFFERED BY YOU OR ANY THIRD PARTY
AS A RESULT OF USING OR DISTRIBUTING SOFTWARE. IN NO EVENT WILL I BE LIABLE
FOR ANY LOST REVENUE, PROFIT OR DATA, OR FOR DIRECT, INDIRECT, SPECIAL,
CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES, HOWEVER CAUSED AND REGARDLESS
OF THE THEORY OF LIABILITY, ARISING OUT OF THE USE OF OR INABILITY TO USE
SOFTWARE, EVEN IF I HAVE ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

================================================================================
COPYRIGHT

(c) 2020 by BebboSoft, Stefan "Bebbo" Franke, all rights reserved 

================================================================================
NAME

partcopy
	
================================================================================
HISTORY 

2021-03-17: Version 1.4
* I (Holger Hippenstiel) reported slow speed on big files and after writing
  Bebbo about it, i have added 64k buffers via setvbuf to read/write operations
making
  them upto 17 times faster.
  I have made a similar tool which handles a whole drive ->
  http://aminet.net/package/disk/misc/DriveMirror

2021-03-14: Version 1.3
* use NSCMD_TD_READ64 and NSCMD_TD_WRITE64 to support devices > 4GB
* add a patch command to update the RDB with custom values

2020-11-03: Version 1.2
* write cmd misspelled (due to renaming...)

2020-11-03: Version 1.1
* print kiB (=1024 bytes) instead of bytes
* print partition names
* show progress bar

2020-11-02: Version 1.0 initial release.

================================================================================
SYNOPSIS 

partcopy list  <device> <unit>						display the partitions
partcopy read  <device> <unit> <n> <file>			copy the partition <n> to the <file>
partcopy write <device> <unit> <n> <file>			copy the <file> to the partition <n>
partcopy patch <device> <unit> <heads> <sectors>	modify disk geometry to the
given heads and sectors

================================================================================
EXAMPLES

List the partitions:

> partcopy list scsi.device 1
partcopy 1.1
using scsi.device 1
block size = 512 b
found RDB at 0 using 512 kiB per cylinder
partition #0: block 1:     UDH0 [     2 -  1366] = 698880 kiB
partition #1: block 2:     UDH1 [  1367 -  2731] = 698880 kiB
partition #2: block 3:     UDH2 [  2732 -  4095] = 698368 kiB

Backup a partition:
> partcopy read uaehf.device 1 0 part0
partcopy 1.1
using uaehf.device 1
block size = 512 b
found RDB at 0 using 512 kiB per cylinder
partition #0: block 1:     UDH0 [     2 -  1366] = 698880 kiB
partition #1: block 2:     UDH1 [  1367 -  2731] = 698880 kiB
partition #2: block 3:     UDH2 [  2732 -  4095] = 698368 kiB
copying partition #0 UDH0 to file p0.raw
==================================================100
done

Restore a partition:
> partcopy write uaehf.device 1 0 part0
partcopy 1.1
using uaehf.device 1
block size = 512 b
found RDB at 0 using 512 kiB per cylinder
partition #0: block 1:     UDH0 [     2 -  1366] = 698880 kiB
partition #1: block 2:     UDH1 [  1367 -  2731] = 698880 kiB
partition #2: block 3:     UDH2 [  2732 -  4095] = 698368 kiB
copying file p0.raw to partition #0 UDH0
==================================================100
done

PERMISSION  UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP     NAME
---------- ----------- ------- ------- ------ ---------- ------------ ----------
[unknown]                   86     111  77.5% -lh5- b6aa Nov  2 19:47 Makefile
[unknown]                13318   23016  57.9% -lh5- 862e Mar 17 18:58 partcopy
[unknown]                 3081    9653  31.9% -lh5- db81 Mar 17 18:57 partcopy.c
[unknown]                 1833    5132  35.7% -lh5- ed2a Mar 17 19:09 partcopy.readme
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total         4 files   18318   37912  48.3%            Mar 18 03:45