Short: Extract files out of DOS ADF files. Author: Andrew Bell Uploader: Andrew Bell Type: disk/misc Requires: 020+, OS 3.0+, 2MB of fast memory recommended. Version: 1.1 Introduction ------------ UnADF is a Shell tool that allows you to extract the files out of an AmigaDOS OFS/FFS formatted ADF disk image file. With the various versions of UAE available, ADF files have become very common. An ADF file is simply the entire data of an Amiga floppy disk saved as a file. UnADF allows you to save the entire contents (i.e files & dirs) of these ADF files to your harddrive. AmigaDOS ADF files are very similar to archives, they contain files just like archives do, but weren't actually intended for this purpose. Features -------- UnADF supports OFS, OFS-Intl, OFS-DirCache, FFS, FFS-Intl and FFS-DirCache ADF floppy formats. It also supports hard links to files and directories, that are normally created with the AmigaDOS "makelink" command. With the help of xfdmaster.library, UnADF can decompress compressed ADF files before extracting. xfdmaster.library is not included with UnADF, but can be obtained from Aminet. UnADF does not require xfdmaster.library and will work without it. Notes ----- Softlinks are currently not supported in this version of UnADF, and all checksums are ignored, so always check that your data is valid after you extract it. UnADF might slow down a little if it encounters an ADF with heavily fragmented hash chains or data blocks. UnADF does not support high density floppy image dumps, only standard DD ADF type (i.e. If it's 901120 bytes long, it should work). Background on UnADF ------------------- The actual program evolved from a test program I was writing for another one of my projects, FloppyFlux. Version 2 of FF is currently in development and allows the user to access the contents of backed-up ADF images. I received many e-mails from people requesting this feature to be added to FF, but since I'm still in the middle of developing FF 2, and it won't be finished for a few months yet, I decided to release this small tool to the public. But floppies are obsolete! -------------------------- Just because the medium itself is becoming obsolete, it doesn't mean that the data on those disks is obsolete too. For example, I bought 9 or 10 commercial Amiga titles fairly recently, and half of these came on floppy disks! I use FloppyFlux to store backups of these disks on my harddrive as ADFs. If I need to get files from them, I use UnADF. I try to avoid them little plastic floppy disks as much as possible, I'm only interested in the data they hold. ;) You can get the latest version (currently 1.2) of FloppyFlux on Aminet at: disk/bakup/FloppyFlux.lha, this version will eventually be replaced by version 2, which is due sometime early 2000. Non-DOS ADF files ----------------- Not all ADFs are formatted with FFS/OFS, but instead use their own custom disk format. This includes most games and demos, so UnADF will report these types of ADF files as non-DOS/corrupt or will report the rootblock as invalid. Requirements ------------ 020+, OS 3.0+, 2MB of fast memory recommended. UnADF is *VERY* memory hungry, especially while decompressing ADFs. Usage ----- UnADF is very easy to use. There are currently two parameters: LIST - Switch, this tells UnADF to list the contents of the ADF only. DEST - The destination directory. A little note: UnADF doesn't actually save the contents directly to this directory, but instead creates a sub-directory inside it, with the name of the disk. So for example, if an ADF was formatted with the name "Empty", UnADF will use this name as the name of the sub-directory. If a sub- directory already exists with this name, then UnADF will append an extension in the form of ., e.g. Empty.001. Examples: UnADF Store:MyADF.adf DEST=ram: ; save dir to ram: UnADF dh1:ADisk LIST ; view contents of an ADF Copyright --------- UnADF is Copyright © 1999 Andrew Bell. All rights reserved. UnADF is FREEWARE, this means you can copy it as many times as you like as long as no profit is gained from it's distribution and all of the files remain together in their original and unmodified state. You are not allowed to distribute modifed versions of UnADF or it's related files. With the rise of WinUAE, a lot of illegal ADF files have appeared on the Internet that contain copyrighted material, mainly games. I received a lot of emails assuming that FloppyFlux had been designed for storing such ADFs, let me put the record straight, I DID NOT! Both FloppyFlux and UnADF were designed for storing and handling personal disk collections such as PD or magazine floppy disks, and not illegal ADFs from pirate web sites. The author does not condone the use of illegal ADFs with UnADF or FloppyFlux. Author ------ My name is Andrew Bell and you can contact me via email at: -- andrew.ab2000@bigfoot.com Or to get the latest version of this program and to see my other work you can visit my web page at: -- http://www2.prestel.co.uk/ab2000 Enjoy! :-)