Restore 6.4 build: 9639 released: 2009-03-09 Restore old MS DOS floppy backups. Copyright: (c) 2017 Canadian Mind Products. asm command line utility. Download from: http://mindprod.com/products4.html#RESTORE ---- Notes: This program can only be used from the command prompt, (or via an command line style icon shortcut) e.g. under Windows command.exe or JPSoft tcmd.exe, formerly called the DOS box. Just clicking the programs in a directory listing will not do anything useful. Just typing the program names at the command prompt will not either. This program requires a manual install! See below. This program works with vanilla text files, (e.g. ASCII files or UTF-8 Unicode files). You will need a text editor to create and view them, not a word processor. e.g. notepad, Visual Slick Edit or other suitable text editor http://mindprod.com/jgloss/editor.html. You must use a monospaced font http://mindprod.com/jgloss/monospacedfonts.html (aka fixed pitch, aka programmer font) to view your files, or they won't look properly aligned. I put out an avalanche of free software into the world, and submit PAD files to hundreds of distribution sites, but I rarely hear back from anyone. What's happening? Does it all just work fine? It is so complicated nobody can figure out how to use it and they give up on it? It is it useful? Since everyone has the source, do people just fix the programs to their liking themselves? Did you have trouble installing? Do I presume you know too much? I would be happy to hear from you about your experiences, positive or negative and your requests for improvements. A one-line email to roedy@mindprod.com would be great. ===> Free <=== Full source included. You may even include the source code, modified or unmodified in free/commercial open source/proprietary programs that you write and distribute. May be used freely for any purpose but military. For more details on this restriction, see http://mindprod.com/contact/nonmil.html If you include any Canadian Mind Products code in your own applications, your app too must be labelled non-military use only. http://mindprod.com/contact/nonmil.html All ASM source and EXE files code are included. ---- Prerequisites: This program runs under Microsoft Windows or DOS only (e.g. Win2K/XP/Vista) in a DOS compatibility box). ---- Installing on a PC: Download source and executable files to run on your own machine as a standalone utility. To install, extract the zip download with WinZip (or similar unzip utility) into any directory you please, often J:\ -- ticking off the use folder names option. ---- Installing on a MacIntosh: This assembler program will not run on a Mac. ---- Rebuilding: The zip already contains the necessary exe, so unless you modify the program, there is no need to recompile the source or re-assemble it.. Configure.java basedir="E:/" in rebuild.xml to the drive where your files are and tweak rebuild.xml. Use ANT and rebuild.xml, not build.xml, to reassemble and link. ---- Use: RESTORE 6.3 is freware replacement for the official DOS Restore. It restore old MSDOS or PCDOS floppy backups. What's wrong with the official DOS Restore versions 2.0 to 7.0. 1. You may no longer have the PC DOS or MS DOS softaware or know how to install it. 2. The DOS 3.2 version according to a Microsoft technician has 22 reported bugs. It is "the lemon of MS DOS" to use his phrase. 3. Under DOS 3.2, MS DOS and PC DOS use incompatible formats for Restore diskettes. You cannot restore files backed up on IBM PC DOS to an MS DOS system and vice versa. 4. DOS 3.2 and 3.3 disk formats are incompatible. You cannot restore files backed up on DOS 3.3 to a machine running DOS 3.2. Version 3.2 Restore will not run under DOS 3.3, etc. 5. DOS 5.0 restore can now read DOS 3.2 backups, but not vice versa. 6. DOS 6.0 backup is completely incompatible with earlier versions. Canadian Mind Products Restore works under all versions of PC and MS DOS from 2.0 to 7.0 and will restore diskettes created by DOS BACKUP 2.0 through 5.0. It runs fine under Windows or OS/2 in the DOS emulation box. This allows you to restore your backups even if you have changed operating systems. It also allows you to distribute large files or programs on floppy to people running an unknown variety of operating systems. This is how the Federal Aviation Administration distributed code to all the airports. WARNING! RESTORE only works with 8.3 filenames. Copyright: (c) 1986-2017 Canadian Mind Products freeware May be freely distributed and used for any purpose but military. For more details on the restriction, see http://mindprod.com/roedy.html#NONMILITARY The only restriction is that this is for non-military use only. The command line options are compatible with PC and MS Dos restore. Syntax ====== RESTORE.COM A: [C:][path\][filespec] [/S] [/P] [/Q] Where: A: = source floppy drive, i.e. A:, B:, etc. C: = target hard drive, i.e. C:, D:, etc. path = the directory where the files will be placed. filespec = the specification of files to be restored. May include wildcard chars. * and ?. /S = restore subdirectories also. /P = prompt before restoring each file. /Q = quiet, suppress advertising banner. Samples of Use ============== RESTORE.COM A: C:\*.* /S /P -- restores all files, letting you decide which ones to restore individually. RESTORE A: C:\*.BAT/S -- restores all BAT files in all subdirectories. RESTORE A: C:\MySub\MyFile.Ext RESTORE A: C:\MySub\*.*/P/S/Q RESTORE A: C:\MySub/P RESTORE A: C:\MySub RESTORE A: \MySub -- presumes default drive RESTORE A: C:*.* -- presumes default directory RESTORE A: C:\*.BAT/S -- restores all BAT files in all subdirectories. It is not as elaborate as the commercial versions, only the /S and /P switches are supported. Version 6.2 displays the new address and phone number. Also documentation and program listings clarify the use of Restore under DOS 5.0 and 7.0. Clarification on site licenses and bundling restore to install your software. ASSEMBLING You can use the ANT scripts, or assemble and link manually. REBUILD.XML is a simple restore build that presumes all files are already in the project directory. Build with ant -f rebuild.xml zip Assemble restore using ANT Invoke with [ant clean] to erase class files and start over. Invoke with [ant assemble] to just assemble and link. Invoke with [ant zip] to create zip files containing source and executables. You must have ml.exe, ml.err (the assembler) and link.exe on the path. You can get ml.exe 6.15 from http://download.microsoft.com/download/vb60ent/Update/6/W9X2KXP/EN-US/vcpp5.exe extract with WinZip. You can get link.exe 5.6 from http://download.microsoft.com/download/vc15/Update/1/WIN98/EN-US/Lnk563.exe and extract with WinZip. ml.exe/link.exe 9.0, bundled with Visual C++ Express available from http://www.microsoft.com/express/download/#webInstall, will NOT work unless you modify the ANT script and modify the source code drastically. You could assemble manually with: ml.exe /AT/c /Fl /Zf restore.asm and link with: link.exe /MAP /TINY restore.obj,restore.com,restore.map; For details of ANT use, see http://mindprod.com/jgloss/ant.html ---- Version History: 1.0 1985-11-01 not released to the public restored all files ignoring the filespec 2.0 1986-12-25 /P /Q /S options. allowed you to select files to be restored. 3.0 1987-01-28 released to Charware subscribers fixed bug when restore had to handle 10 or more diskettes. 4.0 1987-03-05 fixed bug RESTORE A: C:*.* /S in root directory did not work. was treated as RESTORE A: C:\\*.* /S instead of C:\*.* /S fixed bug. Originally all disks in the backup set were checked to makes sure they were created on the same day to make sure they were part of the same set. Because backups can be created with the /A option, it is possible each diskette in the set is part of a different set. Thus the check was removed. 4.1 1987-05-08 version number now prints as part of the "Screwed up" message RESTORE.TXT documention separated from ASM source code change mailing address 4.2 1987-07-09 beeps when wants disk 4.3 1988-04-09 change of mailing address in banner 4.4 1988-12-24 change of mailing address in banner 5.0 1989-03-03 very limited distribution added support for DOS 3.3 through DOS 4.01 this was a major rewrite that took many times longer to write than the original. For this reason Version 5.0 is not Charware, but rather ShareWare. 5.1 1989-05-24 more friendly, simpler, less technical error messages. fancier prompts. tidier source code. bug fixed that restored a file fragment when you inserted the wrong diskette. avoid reprompting entire prompt when input bad. Abort Retry Ignore keystrokes no longer echo. / options no longer picky about leading space. warning message if source not A: or B: warning message if target not C: through G: fancier banner, with pause 5.2 1989-07-26 add extra blank line ahead of insert disk prompt extra information on site licenses separate registering text. now assembled with Optasm 5.3 1990-02-05 there are bugs in DOS 2.0 and 2.1 that can interfere with Restore. changes to Default_Subdir now account for the DOS bug when DOS gives mixed upper and lower case for the current directory and when DOS sometimes give directory names that are too long. 5.4 1990-08-03 better explanation of registration in banner. 5.5 1990-10-13 new documentation warning that RESTORE cannot restore to a different directory. new docs on how to handle problem of a restoring a backup when you don't know what is on it. better heading in the docs now works on LANS, no more IOCTL calls on hard drives. ^ now accepted as valid character in a filename. You can now assemble RESTORE in a way that makes it more suitable as an install program for multi-disk software packages. Some versions of DOS and some cachers have a bug that they fail to notice when you change the diskette in a floppy drive and thus give the program data from the previous diskette instead of the current one. To bypass this bug I added a disk reset just prior to each diskette swap. The symptom is that the program claims diskette 1 is in the drive, and demands diskette 2, when in fact you have already inserted diskette 2. 5.6 1992-02-06 notes that works on DOS 5.0 6.0 1993-06-17 notes on DOS 5 and DOS 6 use. new address and phone number. new information on site licensing. 6.1 1996 10-29 embed Quathiaski address notes on DOS 7.0. 6.2 1998-11-08 embed Barker address 6.3 2007-07-21 now free 6.4 2009-03-09 bundled with ANT build script. -30-