Hard Disk Backup Utility Version 1.2 17 March 1987 by David B. Chiquelin This hard drive backup utility is designed to perform a file based backup of hard drives. It will not perform an image backup, but will speed the backup process by only backing up new files and those files which have been modified since the last backup. Old versions of files which have been modified are NOT maintained on the backup disks. Hard disk files which have been modified or deleted are deleted from the backup disks and the freed up disk space is used to store the current version of the modified files and new files. It is a GEM-based program to simplify usage. The program will also restore a hard drive using the backup files and data files created during the backup process. Table of Contents 1.0 Requirements 2.0 Startup 3.0 Options menu 3.1 Date on files 3.2 Write verify 3.3 Force backup (f) 3.4 Force backup (p) 3.5 Set 'To-drive' 3.6 40 folder check 3.7 Size 3.8 Date/time 3.9 Archive bit 3.10 Set list options 4.0 Disk menu 4.1 Back-up a hard drive 4.2 Restore a hard drive 4.3 Save defaults 4.4 Create new data files 5.0 Info menu 5.1 List file data 5.2 Search for file(s) 6.0 Quit menu 7.0 Terminology 8.0 Distribution & Notes 8.1 Changes for version 1.1 8.2 Changes for version 1.2 Requirements 1.0 This program will run on Atari ST computers in either medium or high resolution modes. It WILL NOT format disks, so an adequate supply of previously formatted disks should be on hand before beginning a backup. I recommend disks formatted using the Quick Format program by Brian Ames be used to help speed up the file saves. Quick Format is a PD program and available on most BBSs. (Sometimes called FASTFORM) NOTE: Other format utilities may not work properly with BUP. Before relying on them, run a test by using disks formatted by the utility in question in BUP and then looking at the disk contents from the desktop. If the files show up (on ALL disks, not just the first) then the format should work properly with BUP. TWISTER ver 1.0 would NOT work properly with BUP. The Backup Utility Program (BUP) has been tested on both a 520 ST with TOS in ROM and a 1040 ST. It has not been tested on a 520 ST with disk based TOS. The program keeps its internal data in dynamically allocated pointers. This allows the backing up of hard drives of very large size without any limit (other than available free RAM) as would be imposed if arrays were used. Each file on a hard drive will take up approximately 42 bytes of memory for the pointer data, and each folder will take approximately 110 bytes. Startup 2.0 When you run BUP it will first display a title screen showing the version number and the obligatory statement that portions of it are copyright by OSS and CCD. This is necessary as it is written in OSS's Personal Pascal. Click in the OK button or press RETURN. BUP will immediately display the current date as set in the ST and ask if it is correct. It is important that the correct date be in the ST so the program can accurately advise you of when the last backup was performed. If the date is correct, click on Yes (or press RETURN). If No is selected another dialog box allowing you to set the correct date will appear. After setting the correct date BUP will again show the date in a dialog box and ask if it is correct. When the date has been set correctly the dialog boxes will disappear and the top menu will be active. The menu choices are Desk, Disk, Info, Options and Quit. Options will be covered first as this is where you tell BUP how you would like it to operate. Options menu 3.0 The Options menu selection will allow you to set how the BUP program will run. It is important that you carefully consider how you wish to set the options under 'Backup using...' as this affects how future backups are performed. Date on files 3.1 Date on files is concerned with what date and time is placed on files if BUP is used to restore a HD. This is a change from previous versions of BUP and is designed to save time when backing up a HD. There are two choices - current date/time and HD (hard drive) date/time. The initial default setting is HD date/time. If the current date/time option is selected then when restoring files the date and time will be the date and time normally placed on files during a copy. If HD is selected then the files copied to the HD during the restore will have the same date and time as they originally had. It does not matter what setting is used during backup, the backup files will show the date and time of backup, not the date and time of the HD files. You may change this setting immediately prior to doing a restore, it has no effect on backup procedures. By not changing the date and time on the backup disk files, a small amount of time is saved as it does away with an extra file access. Write verify on 3.2 The 'Write verify' item in the Options menu allows you to turn write verify on or off. The initial default setting is off. Leaving the write verify off will double the write speed (but not cut in half the actual time spent saving due to GEM overhead.) I have used the program exclusively with write verify off with no problems. Just be sure good quality disks are used. Leaving write verify off and using Quick Format formatted disks will greatly help in speeding up the backup and restore process. If write verify is on, the 'Write verify' menu item will have a check in front of it. Force backup (f) 3.3 BUP will only backup files that are new or have been modified since the last time BUP was run. It uses criteria determined by you (see 3.6- 3.8) to detect if a file has been modified. Since some programs alter files without using GEM and leave no indication of changes, a force backup option is available. If 'Force backup (f)' is selected from the Option menu, (the 'f' designates a forced backup by file) a dialog box will open allowing you to enter up to 10 strings that will cause a forced backup of any file that matches the string or has the string as part of its file name. BUP will look to see if any of the strings entered in the dialog box are contained in each file name, and if so, will backup that file. An important note is that this option does not support the use of the * or ? file match criteria often used by DOS's. Example: I have found that the FoReM ST BBS system directly alters its message base and password files. Because of this BUP will not back these files up during a normal backup and so I use the 'Force backup (f)' option to save the current files. The message files are named MESAGE1.DAT, MESAGE1.IDX and MESAGE1.ISM to MESAGE7.DAT, MESAGE7.IDX and MESAGE7.ISM, with the password files named PAS.DAT and PAS.IDX To force the backup of these files I enter on one line of the dialog box "MESAGE" and on another line "PAS." (Without the quotes.) BUP will backup all files that have either the string MESAGE or PAS. in them, causing all the files I desire to be backed up. For comparison, if the * and ? could be used then I would have entered "MESAGE?.*" and "PAS.*". (For comparison ONLY! They may not be used.) Lower case text may also be entered in these fields. BUP will convert it to upper case. When Forced backup (f) is active a check will be in front of the item in the Options menu. Force Backup (p) 3.4 You may also force backup of all the files within a folder by using the Force Backup (p) option. The (p) designates a path forced backup. The same criteria is used as in a file forced backup. Ie., a match of the entered string with any path will force that path to be backed up. You do not have to enter the whole path, and in fact you may not have sufficient space to enter the whole path. Example: I wish to force the backup of all the files in \PASCAL\BACKUP\ but not the files in \PASCAL\BACKBURN\. I could enter the whole path (\PASCAL\BACKUP\) or just enough to specify the path such as CAL\BACKU, or even \BACKU if there were no other paths named or starting with \BACKU on the HD. Lower case text may also be entered in these fields. BUP will convert it to upper case. When Forced backup (p) is active a check will be in front of the item in the Options menu. Set 'To-drive' 3.5 BUP will backup files to either drive A or B. The default is A, but you may change to B with this selection from the Options menu. 40 Folder check 3.6 TOS has a serious bug at the present time that can cause your hard drive and BUP to not function correctly. It is called the 40 folder limit, and means basically that you should have no more than 40 folders combined on ALL your connected hard drives. TOS has an array (not dynamically allocated) set aside to store the HD folder data. Whenever a new folder is accessed, a slot in this array is used. The slot is never 'freed up' unless you reboot the system. If all the slots fill up you will see errors occur and it will appear your hard drive is trashed. DO NOT reformat your hard drive, simply reboot your ST and check again. If it was a 40 folder problem your HD and ST will be functioning properly. The actual array count is higher than 40 (presumed to be somewhere between 60 and 70), but the total includes slots for floppy folders (these ARE freed when the floppy is changed) and also the root directories take up a slot. If you have slightly over 40 folders on your HD, you may be safe, or you may be eligible for the '40 folder' bug. Atari has officially taken the stand that you should not have more than 40 folders on all connected HD's. (Actual or logical.) If you have more than 40 you do so at your own risk. When BUP backs up or restores a HD it does not attempt to keep track of how many folders were accessed. (Mainly because it checks first to see how much free space is available on the HD, which accesses ALL folders on that HD.) If performing a search for a file (see 5.2) and if the 40 folder check option is turned on from the Options menu it will alert you when it has accessed more than 40 folders and ask if you desire to continue or abort the search. The initial default setting has the 40 folder check option turned on. If active, a check mark will be in front of the '40 folder check' menu item. (Backup using) Size 3.7 One of the criteria BUP may use to determine if a file needs backup is if the file size has changed since last backed up. This check should normally be left on. The initial default setting is on. If on a check mark will be in front of 'Size' in the Options menu. (Backup using) Date/time 3.8 Another backup selection criteria is the file's date and time. If the current HD file's date and time are not the same as the file's date and time when last backed up, then the file will be selected for backup. The initial default setting is on. When on, a check mark will be in front of 'Date/time/ in the Options menu. (Backup using) Archive bit 3.9 TOS includes a bit in the file's attributes that can be set when a backup is performed. If the file is then written to using TOS functions (not directly written to on a track or sector basis) the archive bit will be cleared. Even if the file's date/time and size have not changed, the archive bit will alert BUP that a backup is required. IMPORTANT NOTE: If the archive bit option is turned off when backing up a HD, it should NOT be turned on again for later backups. If off, the archive bit will not be set on the HD files. A later backup with the archive bit option on would then select all files for backup as the archive bit would be off. When restoring a HD if the archive bit option is ON, the HD files will have their archive bit set so later backups will perform correctly. The initial default setting has the archive bit check enabled. A check mark will be in front of 'Archive bit' in the Options menu if this function is on. NOTE: If all three 'Backup using' options are off, then only new and forced files will be saved. At least one of the above should be on when performing backups. List file options 3.10 File data may be listed to the screen or printer for any drive: - Alphabetically by folder (Initial default) - Alphabetically for HD - By size for HD - By age for HD - By backup disk The listing can be in increasing or decreasing format and the data can be from the backup data disk, from the HD, or a combined comparison of the backup data and the current HD status. See 5.1 for more details. The 'List file data' selection in the Options menu allows you to select how you want the data to be listed. A window shows the current settings and the mouse is used to make changes. Click the left mouse button on the desired settings. Click on the DONE box when finished. Disk Menu 4.0 The disk menu contains the selections for backing up a HD, restoring a HD and saving the default settings made using the Options menu. Back-up a hard disk 4.1 When the 'Back-up a hard disk' item is selected, BUP will first ask which drive you wish to backup. Select which HD to backup from the choices (C to P) shown. You may abort the backup by clicking in the Abort box. If the selected HD is a valid choice (connected to the system on boot-up) BUP will show a small window with 'Standby...' displayed. BUP is determining the HD size and free space. The Standby box will disappear and a dialog box will then ask which drive contains the Backup data files. When you first backup a HD using BUP it will create the data files containing the information it needs to perform subsequent backups properly. You may save these data files on drives A, B, C or D. I highly recommend taking a blank disk and labeling it BACKUP DATA DISK. If the data files are saved on a HD and the HD requires restoring, BUP will not be able to perform the restore function. A utility is planned to allow the creation of the data files in the event they are lost but is not available at this time. PROTECT THE DATA FILES. These are not the backup disks which contain the backup files. All your backup data files may reside on one disk as they are named for the drive they contain data for. The first time you are using BUP, click on the None box. If there are data disks (ie., if this is not the first time you are using BUP to backup a HD), make sure the data disk is in the selected drive before making your selection. If you select a drive and there are no data files present the program will alert you to that fact and abort the backup, allowing you to insert the correct data disk and reselect the backup item. If data files are present BUP will read in the old data from the last backup. If None was selected, or after reading in the data files if a drive was selected, BUP will display a window titled EXAMINING HARD DISK. The window will show the drive identifier, size allocated, free storage remaining on the drive, number of paths found, number of files checked, number of new files and the number of modified files found since last backup. While BUP is searching the HD, and at any time during the backup process if any key is pressed on the ST BUP will pause and display an alert box requesting whether you wish to continue or abort. When the search is completed, a new dialog box will appear showing how many files need to be saved and asking again if you wish to continue or abort the backup process. If you do not abort the process BUP checks its internal data from the data files to see if any files previously backed up have been deleted from the HD. If there are a lot of files on the HD and there have been a lot of deleted files this may take a few seconds. The screen will remain blank while BUP does this check. (No dialog or alert box or window explaining the delay.) If there are any deleted file that have been backed up previously, BUP will tell you how many and ask if you wish to save all the files, delete all the files or delete by query. If save is selected, none of the old files on the backup disks will be deleted. If delete all is selected, all the old files no longer on the HD will be deleted. If delete by query is chosen you will be shown the file name and folder the file is in and may select to delete the file, save the file or delete the remaining files. If delete the remaining files is chosen the file currently displayed and the remaining files that have not been displayed will be deleted, any previously shown files will either be saved or deleted depending on the selection made when the file was displayed. At this point BUP will 'do its thing' and start backing up the HD. A window will appear that will keep you advised of the backup progress. This window shows: - File name in a rounded edged box top center of the window. - File's date - File size - Date it was last backed up (blank if first time) - File status (New, Modified, Deleted, Forced) - Path of the file (folder) on up to two lines - Hard drive being backed up - Size of the hard drive - Free space on the hard drive - Total files on the hard drive - Number of files left to copy - Number of files copied - Backup disk number - Size of the backup disk - Free space on the backup disk - Number of files on the backup disk - Action being taken BUP will ring the ST bell and display a dialog box requesting a disk be inserted into the drive specified as the 'To drive' in the Options menu. If it is the first time BUP is being run it will ask for "new disk #x-1", where the x corresponds to the drive being backed up. Insert a previously formatted disk into the specified drive. BUP will place a hidden file on the disk that tells BUP what drive and disk number the disk is. From then on if BUP needs that disk to either erase a file or save a file it will ask for "old disk #x-1". Make sure you mark your disks properly, as it can get frustrating trying to find the correct disk with BUP telling you "wrong disk". If you insert a disk that was used to backup a different HD, BUP will tell you what disk number it is and for what HD, and ask if you really want to use it. When the proper disk is in place the backup will begin. You can watch as BUP keeps you informed of the progress in the window. To abort or pause the backup press any key. When the disk can hold no other files from the hard drive BUP will sound the bell again and ask for the next backup disk. You can turn the volume up on the monitor and not watch the display as the bell will alert you when action is necessary. When all files have been backed up, or if the program is aborted before it is finished, BUP will ask you to specify which drive to save the data files to. These are the IMPORTANT data files it initially asked you for and should be saved on a floppy although you may select from drives A to D to save them on. BUP will create three files containing the data fields necessary for it to properly backup the hard drive at a later date or for listing the file data using the Info menu. The files will be named DATA_x.FLS, DATA_x.PTH and DATA_x.DSK, where the x is replaced by the hard drive letter. If the backup is aborted the data files will allow you to continue the backup at a later time from where you left off. In this case the file status in the progress window may not be correct, but the files will be backed up properly and the data files after the backup is complete will be correct. If an error occurs during the backup process and the ST shows the standard alert box stating the data on the disk may be damaged then the program may bomb when the cancel button is selected. (See 8.2, changes in version 1.2 for additional info on this.) If another disk is inserted and the retry button is selected then the backup will continue but the data files will not be correct. Backup notes: BUP checks the disk when first inserted to determine the size and free space. During the backup process BUP estimates the free space in order to save time. When it tries to save a file that will bring the free space to 7K or less, it will check the actual disk free space before saving the file. BUP does not attempt to optimize the packing of files on the disks. It arranges the files alphabetically and the folders alphabetically and starting at the root directory saves all the files within that directory that will fit on the disk. When all the files in the current directory have been saved or skipped, it switches to the next directory (folder) and checks those files. It continues trying to find files that will fit in the remaining disk space until either all files have been checked, the disk has 0 remaining free space, or it only has 1K free and a new folder would have to be created to save a file. (Each folder takes 1K of disk space to create.) This works fairly well but may leave some disks with free space, especially when performing later backups where the files to choose from are fewer. Over time the disks will remain close to full. (From my experience.) Restore a hard disk 4.2 If the hard disk requires restoring for whatever reason, then BUP can perform the restoration also provided the backup data files and backup disks are available. You MUST have both the backup disks and the backup data files to use BUP to restore a hard disk. The prompts are similar to when backing up a hard disk and a status screen similar to the backup status screen that is displayed during backup is shown. The restore status screen shows the same file information but for the backup disk and hard drive displays: - Files on disk (total files on the backup disk) - Files to copy (left to copy from this backup disk) - Files copied (from this backup disk) - Size (of the hard disk) - Free (storage on the hard disk) - Total files (number of files copied to the hard disk) - Files to copy (total remaining on all backup disks to copy) - Files copied (total files copied from all backup disks) If the hard drive time option is set so the backup files have the same date and time as the hard drive files, then the restored hard drive files will have their old dates and times. When the restore is complete the window will erase and the menu will be active again. If the option is set so the backup files have the date and time of backup, then BUP will ask for the data disk when the restore is complete so it can save the new times of the hard drive files. BUP seems very sensitive to the 40 folder problem with TOS during restore operations. I have added an alert box that will appear if a problem associated with the 40-folder bug shows up. You may continue the restore or abort. If continue is selected the file that was being restored is skipped and BUP tries to save the next file. If the alert box appears again you should abort and check for evidence of the 40 folder bug. To do this look at the HD you were restoring. If it appears blank, then reboot the system. The files that have been restored should show up after rebooting. You may try BUP again to restore the HD, making sure you do not access any other drives or folders, and see if it will be able to complete the process, or copy the remaining files from the desktop manually. If you copy the files manually, use Create New Data Files to avoid having BUP think the files you copied manually (with new date and times) are modified versions of the old files. BUP shows the free remaining space on the HD being restored, but does not use the data to determine if a file can be saved on the HD. You must partition your HD large enough to accept the files during the restore process. The free space is estimated while copying files and checked for the actual free space whenever a new disk is inserted during the restore process. Save defaults 4.3 The settings made using the Options menu may be saved to disk so BUP can remember your preferences. BUP will save the settings in a file named BACKUP.DEF on the drive BUP was run from. If run from A or B, you will be prompted to insert your program disk before BUP saves the file. When BUP is run it first looks to see if there is a file named BACKUP.DEF on the drive it was run from. If the file is found it loads in your settings. If not it will set them to the default settings as described in the Options section. Create new data files 4.4 This menu item may be used if you have lost your backup data disk files or have used another backup program and would like to use BUP. When selected you will be asked which drive to create the data files for. Once selected the program will prompt you to "Insert old backup disk #x-1 into drive A", again where the x corresponds to the drive the files will be created for. If you are recreating the data files from data disks created by BUP then there should be no problem. If you are using backup disks created by another program or manually copied, then you MUST insure there is at least 1024 bytes free on the disk for BUP to save the hidden file containing the disk identity. If any disk has 0 bytes free, then transfer one file to another disk and delete the file on your original disk. Since BUP only saves the most recent version of all files on the HD, you should also insure the disks you will be using to create the new backup data files from have only one copy of each program. If using disks from a program that saves new versions of modified HD files on new disks (ie., retains the old files and your backup disk collection continues to grow over time), then delete the older copies of the duplicate files or perform a complete backup of the HD forcing the program to save all files on new disks and use these disks to create the backup data files for BUP. When BUP has searched all your disks for the selected drive tell it there are no more disks by clicking in the appropriate box. BUP will next ask if you wish to compare the data with the current hard drive files. This feature is used so BUP will know the correct date on the files on the HD (in case they are different from the file's date and time on the backup disk.) If your HD does not contain all the files that are in the backup disks BUP will not mark them as deleted during this operation. The compare with HD is ONLY to set the correct date/time and check for new files. When completed with checking the HD (if selected), BUP will save the new Backup data files on the drive you specify. The date of last backup for all the files will be set to the current date since BUP has no knowledge of when the files were saved. At this point you have several options depending on your backup disks and HD status. If your HD was backed up, then reformatted or erased or has files deleted that are on your backup disk, then you may restore the HD using PUB and the created backup data files. If your HD was backed up, then reformatted or erased and has NEW files on it you wish to save with your other backed up files, then make sure your List file options are set to NO compare and immediately go to List file data. Look at the file data to insure it is correct (you also should have selected Compare with HD when creating the new backup data files) and then close the list window. The program will ask you if you wish to backup your files. Answer Yes and follow the prompts. This must be done immediately after creating the data files. If BUP reads the data in from the backup data files and you do a backup of the HD, files missing from the HD will be erased from your backup disks. If your HD was backed up and new files have been added since the backup, then you may use the normal backup function of BUP to bring your backup disks up to date. If your HD was backed up and then BUP was used to create the backup data files, with all HD files on the backup disks, there should be no problems and the session is complete. Info 5.0 The Info menu allows you to view or print file information, or search the connected hard drives for a file. List file data 5.1 List file data will display or print file data as determined by the 'Set list options' settings. The choices are shown in section 3.9 above. If 'Alphabetically by folder' is the method, then the listing will start with the pathname and list all files under that path. If anything else is chosen the files are listed and a column with the path 'key' is displayed. If printing the data the path keys will be displayed at the end of the listing. If the listing is to the screen the top menu bar will change to show a menu choice of Paths. If the paths menu is selected a second window will open displaying the path 'keys' and associated names. The information shown in the printout or window is the same. The window will have a header labeling the columns, if printed the header will be at the top of each page. The data shown is: - File name - Path key (if not sorted by folder) - File size - File date - File time - Date of last backup - Which backup disk the file is on When displaying the data to screen the main file data window operates similarly to the normal GEM window. Clicking on the up or down arrows will move the file listing up or down by one line. Clicking in the grey area above or below the slider box will move the listing up or down one page. (A page is determined by the number of lines being displayed in the file data window and varies by the size of the window.) The slider may also be dragged up or down to rapidly move to a different area. The full box, size box, close box and top move bar all function as in normal GEM use. The mouse may perform slowly however (I'm not sure why this occurs) and you can either click several times or simply hold the mouse button down longer than usual in order for the requested action to take place. The path window functions slightly differently when it is active. The window does not have a slider and when the up or down arrows are selected the paths shown will move up or down by one page. The path window also includes the full box, close box, size box and move bar as in normal GEM applications. If 'Compare with current drive specs' is set to Yes (In the 'Set list options' menu) then BUP will compare the data from the data disk with the current files on the hard disk. A file that needs to be backed up will have an asterisk in the left column. If it is new the words No B/U will be in the column that displays the date of last backup. A file that has been deleted on the hard disk will have a D in the first column. If files need backup then when the window is closed (and the path window closed if it has been opened) then BUP will ask if you wish to backup the hard disk at this time. If you do a normal backup will proceed. If compare is set to No, only the data from the backup data disk will be displayed and there should be no asterisks or D's showing. (Unless a backup was aborted before completion. If compare is set to Yes and there are no data files then the listing will show the current files on the drive and all will have an asterisk in front of their names. Note: The printer output assumes 66 lines per page and continuous feed for the paper. The paper should be aligned and the printer online before selecting 'List file data' if the output has been selected to go to printer. Search for file(s) 5.2 This menu selection allows you to search one or all connected hard drives (C to P) for a file or group of files. If selected a dialog box will open asking you for the string to search for and whether to search one or all drives. The string search feature works the same as the forced backup methodology. You enter a file name or portion of a file name and the program will tell you of all files that have the search string within their name. If the '40 folder check' is enabled, then during the search BUP will alert you when it has accessed more than 40 folders and each time the number of folders accessed increases from then on. Be very careful of exceeding the 40 folder limit during one session. When BUP searches there are two windows displayed. The first is a very small window at the top center that displays which drive is currently being searched, and the larger main window is used to display the files that match the search parameter. After a file is found that matches, the number of the match (starting at 1), the file name and the file's path are displayed. Two buttons will also appear at the bottom of the display labeled Continue and Abort. If continue is selected the search continues and if another file name match is found the new file data will be displayed under the previous file data. Long path names may require two lines to be displayed but BUP will perform word wrap on the appropriate '\' sign. If the window fills up it will clear and start displaying new matches from the top again. You may also abort the search at any time by pressing any key on the ST keyboard. Quit menu 6.0 The last menu item is the quit menu. If selected an alert box will ask if you are sure you want to quit. If yes, the program will end. BUP will not automatically save your default settings. You must save them using the Save defaults menu item. Terminology 7.0 BUP - Backup Utility Program. Backup data disk - Backup data disk is not a disk containing the backed up files from the HD, but is the one disk containing the backup data files created by BUP and used by BUP to perform subsequent backups. This disk should be carefully protected as BUP requires it to perform a restore or to properly backup the HD again. Label this disk Backup Data disk. Backup disk - A disk containing copies of the files on the HD. There can/will be multiple backup disks. They should be labeled with the letter of the drive they contain files from and the disk # assigned by BUP. Example - Backup disk C-001. Hard disk, hard drive, HD - All mean the same thing, the high-speed fixed media device using the ST's DMA port. The terms refer to a unique drive identifier, as in drive D or drive E. A single physical HD may be partitioned into several logical HDs with separate identifiers. Distribution & Notes 8.0 Permission is granted to distribute the program as long as the documentation file accompanies the program. The program is copyright by me and is distributed as a Shareware program. This does not mean and I do not expect you to send me money before you can use it. I feel you should decide if the program is worth anything to you by using it before feeling obliged to send money. If you use the program but find it too slow or you find a better program, then don't send anything. If you do use it and like it, then I hope you will recognize the work and time spent writing BUP and contribute a small amount to supplement my current unemployed pay of zero. No contribution is too small and any contribution would be appreciated. I have only contributed once for a shareware program, and that was for ARC as I use it all the time. The reason I have not contributed to other shareware programs is I don't use them or only rarely use them. If you can not afford to contribute then use BUP anyway, a backup of hard disk data is important to maintain. If you find a bug in the program then please advise me of it and I will try to get it corrected as soon as possible. The program has been compiled without the full debug feature (saves 25K) so if the program crashes please include as much information about the option settings and what part of BUP was being used when the crash occurred as you can. Bug reports and any other comments about BUP may be sent to: D.CHIQUELIN (GEnie) 71336,1443 (CIS) DCHIQUELIN (Delphi) Sysop (Atari-O! BBS 402-592-4435 300/1200/2400) Contributions, bug reports or recommendations may be mailed to: David B. Chiquelin 501 Woodbine Circle Omaha, NE 68128-6040 After April '87 it would be best to send them to my permanent address of: 16042 Shenandoah Ave. Baton Rouge, LA 70817 as I currently am looking for employment and may not remain in the Omaha area. Changes for version 1.1 8.1 The Create new data files feature was added for version 1.1 and a couple of bugs fixed. One bug could potentially have crashed the program during backup. A minor bug that was corrected had resulted in the Examining HD window to have the characters write over each other under certain circumstances, creating black blocks eventually where the characters should have been. With the Create new data files feature in BUP, no separate utility will be required. Changes for version 1.2 8.2 More bugs were fixed, including a bug created in ver 1.1 that would not allow the restore function to perform correctly. More error checking has been added in 1.2 as well. The Force Backup by path feature is new for version 1.2, and now when List file data (with Compare off) is selected you may choose any drive, not just drives connected to the ST. This allows you to view or print the file data from another ST or if the HD is turned off. The added error checking during Disk I/O may or may not function properly, depending on your individual setup. It has been found that certain desk accessories and 'load and stay resident' programs may cause the program to crash if a disk error occurs. If you have a problem with the program crashing after seeing the System generated alert about "Data in drive 'x' may be damaged...", then try running BUP without desk accessories or other programs active. One accessory that has been shown to cause the problem is CONTROL.ACC Final Notes: BUP works best when used frequently. If there are a bunch of files that need backup then it may be better to use another backup program that performs an image backup. If used frequently the time spent on the backups will be short and you will have the peace of mind of knowing your hard disk files are protected. Remember also that BUP only saves the latest revision of modified files, and optionally deletes files from the backup disks that have been deleted from the HD. This keeps the number of disks required for BUP fairly constant, but requires YOU to save previous versions of files separately if required. The GEM interface makes using BUP easy, without having to remember what commands you need to enter. This documentation file is probably larger than required since you are lead each step of the way by BUP. If you have only received the documentation for BUP, then I urge you to obtain the program itself and try it.