TDTool 1.3

Short:        Read/Write ADF files & more (+ source)
Author:       mail@bret-mcgee.me.uk (Bret McGee)
Uploader:     mail bret-mcgee me uk (Bret McGee)
Type:         disk/misc
Version:      1.3
Architecture: m68k-amigaos >= 2.0.4

Version 1.3 now writes ADF files back to disk!

I have spent the last 2 months getting my Amiga 2000 working again
after being in storage for the last 10+ years.  Luckily enough all
my old source code is still intact so I've decided to release it
for the first time.

So here is the first program to be released written back in 1994 but
modified for release.  I have been amazed so many people have found
this little program so useful I've now added (read as 'hacked in')
a WRITE function.


TDTool (TrackdiskTool) is a disk block reader/writer suitable for
creating ADF files, or simply ripping ad-hoc blocks.  You are not
limited to trackdisk.device, you can read blocks from your hard disk
if you wish.

Only runs from command line interface.

Command line template:

FILENAME/A,UNIT/N/A,OFFSET/N,LENGTH/N,DEVICE,WRITE/S

FILENAME - the name of the file you wish to save to/read from
UNIT     - the unit number (e.g. 0 for DF0:)
OFFSET   - block to start reading/writing from/to (default: 0)
LENGTH   - number of blocks to read (default: 2)
DEVICE   - device to read (default: trackdisk.device)
WRITE    - write ADF file to disk (default: read disk)

Example to read an entire 880K floppy:

CLI> TDTool MyDisk.adf 0 0 1760

And to write it back again...

CLI> TDTool MyDisk.adf 0 0 1760 WRITE


NOTES
~~~~~

DON'T use the WRITE mode with anything other than trackdisk.device.  It has not
been tested and might blow up and kill something.  No, really, don't.

TDTool compiles with the DICE compiler.
It's a bit memory hungry as all the blocks are read at once so you'd
probably need 2MB to run.

If you find this program useful I would be very greatful for a small
donation, say, £2 made via PayPal to mail@bret-mcgee.me.uk.  I'm not
planning to make any money but simply to cover the cost of getting my
poor A2000 up and running again.

See all my Amiga mess at http://www.bret-mcgee.me.uk

Any comments or suggestions drop me an email.


HISTORY
~~~~~~~

30.08.10 1.3  Now has WRITE function.
              Some code tidy up done.

21.08.10 1.2  First public release to Aminet
              Changed FidoNet address 
              Created this Readme file
              Added DEVICE command line argument
              Renamed from TDRead to TDTool (more generic name)

31.12.94 1.1  Not released to public