readme for devcp.exe
WARNING: THIS TOOL CAN DESTROY VALUABLE DATA IF NOT PROPERLY USED!

Created 2007-2008 by Rene Tegel for Dubaron.
This application is released under GPL license http://www.gnu.org/licenses/

devcp copies data from file to raw device, from device to file, or directly from device to device.

WARNING: THIS TOOL CAN DESTROY VALUABLE DATA IF NOT PROPERLY USED!

SECTIONS:
  1. USAGE
  2. PARAMETERS
  3. COMPILING

1. USAGE
devcp [dev_in|file_in dev_out|file_out [options]]

Both source and target can be a filename or a device ID.
Source and target must be of identical size unless target is a file.
A device is indicated by # followed by its logical number.

Without parameters, devcp will display short usage information and list all devices:

>devcp
devcp - Device Copy - version 0.015 ALPHA
Usage:
devcp inputfile|devid outputfile|devid
Listing devices:
Device #0 - size: 250059350016 bytes (238475MB)
Device #1 - size: 262144000 bytes (250MB)
Device #2 - size: 262144000 bytes (250MB)

To dump a usb stick (or cdrom, harddisk, whatever) to file, enter
as input the device ID (numeric) and as output the filename
>devcp #2 testdump.dat


To restore a file dump to this device
>devcp testdump.dat #2

To copy from device to device directly
>devcp #2 #1


2. PARAMETERS
  agree=yes
When writing to a device or overwriting an existing file, confirmation is required.
You will have to enter 'i agree' to confirm you are to overwrite data.
To skip this question, you can give as option to the command line 'agree=yes'
>devcp myimage.dat #2 agree=yes
Notice that you should NEVER do this (or need this) unless you are running large batches.
  ignore_error=targetsize
To ignore target size, add "ignore_error=targetsize" to the command line. This option is considered dangerous, and before version 0.17 mutually exclusive with autoagree. This restriction has been removed.




3. COMPILING
devcp can be compiled using either Delphi ("Any" version, presumably 4+) or the FreePascal compiler (FPC). However, stream operations using FPC libraries seem to be lot slower, i.e. the binaries compiled with delphi operate faster than the ones created with FPC. Might be fixed in next version.
FreePascal:
  C:\projects\devcp>fpc devcp.dpr
Delphi:
  Open the file devcp.dpr and compile ( CTRL-F9) 

  This application uses the 'APILIB' library from the JEDI project
http://jedi-apilib.sourceforge.net. This library should be included in the source package of this project, but you might want to retreive a newer version.
Make sure this library is in your library search path.