// ARestaure v2.03 - Documentation // \X/ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ \X/ This manual describes the version 2.03 of ARestaure. This tools is ©1992 by Jehan-Yves PROUX, the commercial use is STRICLY FORBIDDEN without author written agreement. This program can be freely distributed, you can spread it in the way you want, but the program MUST be distributed WITH its documentation in all languages (for instance French, German and English) without ANY modification. I made a lot of tests, but I declines any responsability about the use of ARestaure. YOU ARE USING THIS TOOLS AT YOUR OWN RISK. The author is not responsible of any damage, as result of the use of his program. This program is ShareWare. It means that if you like it, you're invited to send a donation of 50FF at the address shown at the end of this file. You will become a registrated user, and I will send you a registrated version. You can pay by these ways: - cheque of a european bank (for french francs), - ready cash (european money or dollar). Contents ~~~~~~~~ 1. Introduction 2. How does it works? 3. Usage 3.1 Restoration Mode 3.2 Cleaning Mode 4. Languages supported 5. Additional Notes 6. Thanks 7. Historic 8. Conclusion 1. Introduction ~~~~~~~~~~~~~~~ Have you ever delete accidentally a file or see after a "delete #?" that you were not in the rigth directory ? Yes? I too... It's why I have written this utility ARestaure, which as it name says (with french spelling), permits you to restore files that you have destroyed... 2. How does it works? ~~~~~~~~~~~~~~~~~~~~~ When you delete a file two main actions occurs on your current volume: - your file is disconnected from the directory tree of your volume. - sectors that your file owned, are declared free in the BitMap block(s) of your volume. These sectors are never zeroed during this operation : the datas are still on your disk. ARestaure will scan your volume, searching for deleted files and permit you to undelete them. 3. Usage ~~~~~~~~ To start ARestaure, click on its icon on the Workbench or type "ARestaure" under the Shell. ARestaure will start to search in your system all the volumes that it can manage, and it will show you only these ones : Also if you have a Mac, Unix, Atari, C=64, Sinclair QL, Apple-II, or why not an MS-DOS partition, you won't see it on your screen. In fact, ARestaure know only how to manage Amiga partitions or volumes: OFS (the Old Filing System) and FFS (the Fast Filing System), and the 4 new of OS3.0 (international FS and DCFS) that it means about 98% of disks connected with our well-known machine. You will notice that ARestaure cannot restore a file deleted on RAM:, this volume is purely memory, and space used by your file is freed when your file is deleted, it's why RAM: is not shown on your screen. But ARestaure can restore files lost in RAD:. You have on your screen the following buttons: DF0: .. DF3: one button per drive connected (empty or not) DH0: .. DHx: .. .. .. .. .. .. .. .. and as many buttons as you have drives Français Deutsch to change the current language English SaveCfg to save the chosen language (only when WB<2.1) Quit to quit ARestaure. 3.1 Restoration Mode ~~~~~~~~~~~~~~~~~~~~ It is the default mode of ARestaure, you can see it by viewing the "Mode" Menu. In this mode, if you select a drive, the program will begin the search immediatly on this drive. A flashing LED on the drive button indicates that the program continue to search. If ARestaure cannot find any files, it will signal it to you in the message box; if it can, it will open a file requester where you can select the files you want to restaure, then type or . After that you will be back in the starting menu to select another drive or to quit. Where to find your files? It is impossible to restore your files in the places they were before the deletion because it is impossible to find where they were linked in the directory tree of your volume. Also I had decided to restore them in T:, the temporary directory of the Amiga. Usually, T: is assigned to RAM: (see your Startup-Sequence). After the restoration, you only have to move the restored files from T: to where you want. NOTA: You should have to enough room in T: for the files you want to restore. NOTA: If several files with the same name are to restore, ARestaure will add a count at the end of the filename (like ".03"). 3.2 Cleaning Mode ~~~~~~~~~~~~~~~~~ After some uses of ARestaure in Restoration Mode, you will see that ARestaure shows you a lot of files which aren't interessant for you. The goal of the Cleaning is to zero all free sectors, this forbid to see the files destroyed before this operation. This Cleaning has two advantages: - You will see only files removed after the cleaning operation. - If you give a disk to someone, you are sure to give only the files you want (and not removed files that the person can restore using ARestaure). To use this mode, select "Cleaning" in the "Mode" menu. Then select the drive you want. After a confirmation requester, the work begins. NOTA: The drive must be not protected against writing ! 4. Languages Supported ~~~~~~~~~~~~~~~~~~~~~~ ARestaure is now almost ready for the Amiga Workbench 2.1, which will support up to 8 languages (according to C=Amiga austria in Amiga Magazin [german magazine] on 9/92): ARestaure supports the three languages I understand: French (my native langage), german and english. You can select the language you want on the main screen. But, it's impossible to change the current language, when you have the file requester opened : I didn't want to manage this, I suppose in fact that a normal user needn't to change the current language all the time. To finish with languages, if you want to get a translation for the docs of your software (that YOU have created for Public Domain only), from german or english to french, please write to me. P.S: I'm searching for someone who can correct my german docs, which certainly contains some mistakes. 5. Additional Notes ~~~~~~~~~~~~~~~~~~~ If you look at the percentage of scanned disk (between Languages buttons and the SaveCfg button), you will see that the scanning speed varies: this is due to the fact that ARestaure only read (or write) free sectors. So it will scan faster allocated sectors. You can stop the search for deleted files or the cleaning by pressing the key. 6. Thanks ~~~~~~~~~ I want to thanks here the following persons and firms: - Muriel PROUX, my wife for her patience and help in building my user interface. - Denis GOUNELLE, for his ideas and tests of béta-versions, he makes on his machine. - Henric GOMES, who made me discover the wonderfull Amiga. - Commodore-Amiga for the machine... What a pity that C= sells MS-DOS machines too... - Free Software Fundation for the best editor I know: GNUEmacs, I used GNUEmacs on Unix machine during my job and on the Amiga. - David GAY (Switzerland) for his GNUEmacs' Amiga port, a very good job, David ! Continue to work for the Amiga. - Carsten Lergenmüller, Arthur Isaak, Bernd Hofmann, Bernd Neudecker, Dehnick Wolf-Peter, and Tim Rühsen (the germans) and Max Roemer, who help me to write a so perfect (!) german documentation. 7. Historic ~~~~~~~~~~~ v1.00 13-Oct-92 o First spread version. v1.XX 11-Nov-92 o Preversion of the v2.00, restricted spreading for validation. o Cleaning Mode added o some I/O are better tested o evolution of percentage is smoother o in restoration mode, if several file have the same name, ".XX" is added at the end of the filenames. v2.00 28-Nov-92 o Date of files are added in FileRequester of deleted files. o GadgetBorder are changed. v2.01 06-Dec-92 o Now I use RemoveGList() during the search or the cleaning, this permit me to forbid user to disturb the display. o The user must now use the Esc key (and no more the SELECT mouse key) to stop the searching or cleaning operation, this avoid to stop accidentally an operation on a 60Mb harddisk. v2.02 21-Feb-93 o Correction due to a bug done by C= [ :-) ] (DosEnvec->de_DosType = 'DOS\0' (on Kickstart 2.04, WB 2.1), even if the floppy disk was formatted as FFS !). To correct this problem, now I read the boot sector of all floppy disks declared OFS in DosEnvec, to know if it's really an OFS ! o All writes on results files t:xx weren't verified, now they are. v2.03 21-May-93 o Now works with new OS3.0 filesystems of C= (international and DCFS). o Best work with AA-modes. o The gadget "SaveCfg" is disabled, if ARestaure find the language to use with the Locale.library. o I added a window, in order to tell the user, that ARestaure is SHAREWARE (On 21-May-93, I have no contribution yet !). 8. Conclusion ~~~~~~~~~~~~~ I'm waiting for your suggestions and beta-tests (there may be some problems, which escaped from source inspection !) and donation, if I save you long hours of work. You can write me in french, in german or in english [in order of my preferences, the French language is my motherlanguage]. My address is the following:  Jehan-Yves PROUX  46bis, Bd Robespierre  F-78300 Poissy  FRANCE - EUROPE E-Mail: jyp@ritd.co.uk C U soon !!