home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 137.lha / Backer / backer.doc < prev    next >
Text File  |  1986-11-20  |  8KB  |  204 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                                 The Backer Version 1.7D
  13.  
  14.                              A Hard Disk Backup Utility
  15.                                        for the
  16.                                    Commodore Amiga
  17.  
  18.  
  19.                                    June, 1988
  20.  
  21.  
  22.  
  23. Copyright (C) Dexter (Chip) Orange, 1988.
  24.  
  25.  
  26.  
  27.      The Backer is a program for backing up your Amiga hard disk as quickly and as
  28. easily as possible.  There are other good public domain back up programs (such as
  29. MrBackup) which you could use, but I've never come across any that have what I consider to be a critical
  30. feature of a good backup program: the use of the AmigaDOS Archive bit
  31. of the file protection bits.  This bit is supposed to be used to indicate whether a file has been backed up yet or not,
  32. but no PD backup program I've seen makes any use of it.  The idea is very simple:
  33. when ever AmigaDOS creates/modifies a file it clears the Archive bit.  Periodicly you can backup the files
  34. which have cleared Archive bits and after each is backed up, you set its Archive bit.
  35. This makes doing incremental backups very easy.
  36. Backer also comes with a utility (ArchStatus) which allows you to view/set/clear the Archive bits
  37. for a drive/directory/file manually. (documented separately).
  38.  
  39.  
  40.  
  41.      Using The Backer:
  42.  
  43.  
  44. The syntax of the Backer command is:
  45.  
  46. Backer [<source>] [NEW|ALL] [SET|NOSET] [PREFIX <prefix-string>] [FORMAT <drive>]
  47.        [ERRORS <file>] [LISTING <file>]
  48.  
  49.  
  50. Where:
  51.  
  52. <source> is the drive/directory/file to be backed up,
  53. NEW/ALL indicates whether to backup only the new (Archive bit not set) or all files,
  54. SET/NOSET indicates whether the Archive bit should be set after copying the file,
  55. PREFIX <prefix-string> allows you to specify what the backup disks will be named.
  56. FORMAT <drive> tells Backer to prompt you for a new disk in the specified
  57.     drive each time one is needed, and for it to do the formatting.
  58. ERRORS <file> is a file/device where an error report should be written
  59. LISTING <file> is a file/device where a backup listing should be written
  60.      (Note that if you don't want a error/backup listing, you will have to do:
  61.      ERRORS NIL: LISTING NIL:)
  62.  
  63.  
  64. Defaults:     <current drive> NEW SET PREFIX <todays date> ERRORS <prefix>.ERRORS LISTING <prefix>.LIST
  65.  
  66.  
  67. Backer will begin to copy the files you have specified with <source> which
  68. meet the condition you specified with the NEW/ALL parameter to floppies
  69. (note that it preserves the file creation/modification date).
  70. (Also note that even though floppies are constantly refered to here as the
  71. backup media, you can actually use any device which is capable
  72. of being accessed like a disk drive.)
  73. The floppies will have names of the form <prefix-string>.n
  74. where n is a sequence number beginning with 1.
  75. The copying process is much faster than the standard DOS copy, but this is at
  76. the expense of memory.  Backer attempts to use all the memory available, so
  77. if you want to do something while backer is working, start that something up
  78. first so it can allocate the memory it needs before Backer pigs it all up.
  79.      You will be prompted to put volume "<prefix-string>.1:" into any drive,
  80. so you should either have enough pre-formatted disks labeled as <prefix-string>.1 ... <prefix-string>.n
  81. on hand, or run backer in its own CLI window so you can format disk N+1 as Backer is copying to disk N,
  82. or use the FORMAT <drive> option to have Backer do the formatting for you.
  83. You can use another utility supplied with Backer called Estimator (documented separately)
  84. to calculate how many disks you will need ahead of time.
  85.      In order to make the most efficient use of floppies, Backer uses a
  86. "best-fit" algorithm for the storage of files on floppies.  This basically goes like this:
  87.  
  88. If you have a file about to be backed up and find it won't fit on the floppy, instead of
  89. just asking for another floppy (the current one will likely have plenty of room still left on it),
  90. save this one til later and find another file that will fit.  The consequences
  91. of this is that, Backer (with a usual mix of large and small files) will
  92. fill most disks to at least 98 % of their capacity.  The downside is that this
  93. can scatter files which are in the same directory to many different backup disks, making
  94. the retrieval of a single specific file a little time consuming without a listing.
  95.  
  96.           Examples:
  97.  
  98. To do a full backup:
  99.  
  100. (use The Estimator to determine how many disks you will need)
  101. 1>ESTIMATOR DH0:
  102. (if you have a two drive system you can be formatting disks 2 through
  103. n from a second CLI while Backer is using the previous disk)
  104. (now begin running backer in the background so you can be doing something useful
  105. in the mean time)
  106. 1> RUN BACKER DH0: ALL
  107.  
  108. (Note that the prefix defaults to todays date such as
  109. 19-Mar-88)
  110.  
  111.  
  112. (To perform an incremental backup (I do one at least once a week),
  113. modify the above slightly by specifying the "NEW" parameter on the ESTIMATOR
  114. command, and by replacing the "ALL" parameter on the BACKER command with "NEW")
  115.  
  116.  
  117.  
  118.  
  119.      Restoring:
  120.  
  121. Backer creates its backup files with the same AmigaDOS directory structure that they had, so restoring is a breeze.
  122. You can either simply
  123. insert the backup volume you wish to restore from and then copy it in its entirity to your hard disk:
  124.  
  125. Copy <prefix-string>.1: DH0: all
  126.  
  127. will put all the files back just as they were.  Since everything is in AmigaDOS file format,
  128. you can easily search the backup disks to find a particular file and then copy it to your hard disk.
  129. Alternatively, you can use another program supplied with Backer called The
  130. Restorer.  It has several advantages over
  131. DOS copying such as preserving the file date, setting
  132. the archive bit for the restored file, and unless
  133. specificly directed to do so, it will not copy over any file with a date
  134. greater than that of the backup file (The Restorer is documented separately).
  135.  
  136.  
  137.           Future Features:
  138.  
  139. if you have any suggestions or bug reports you can reach me at:
  140.  
  141. Home: (904) 877-0061
  142. Work: (904) 487-2680
  143. CompuServe: 71450,1162
  144. U.S. snail:
  145.      3227 Rain Valley Ct.
  146.       Tallahassee, FL. 32308
  147.  
  148.  
  149.  
  150. Here are some of the things I plan to add:
  151.  
  152. O     An index to files backed up so that the disk
  153.      containing a particular file can be identified immediately.
  154. O     Amiga style wild cards for file specifications
  155.      (currently you can only specify a drive/directory/file as the <source>)
  156. O     Date ranges for file specifications
  157. O     The ability to specify a list of files which are to be excluded
  158.      from the backup.
  159.      (currently the only way to exclude certain files is to use the ArchStatus
  160.      utility to set their archive bits, and then do an incremental backup).
  161. O     The ability to backup a file which won't fit on a
  162.      single disk.
  163. O     The ability to use both drives concurrently on a
  164.      system with two floppies.
  165. O     A slick intuition interface with pull-down menus and all that.
  166.      (any Modula-2 programmers out there want to vaulenteer for that?)
  167.  
  168.  
  169.  
  170.  
  171.  
  172.      If you want any of these worked on first, or any of your own ideas,
  173. please get in touch with me and let me know.
  174. Also, a contribution of $10 would be greatly appreciated, and would assure
  175. you of notification of future releases.
  176.  
  177.        Chip Orange
  178.  
  179. The Backer, like The Restorer, ArchStatus and The Estimator, is freely
  180. distributable for non-commercial purposes.  It may be distributed with
  181. commercial hard drives as long as no extra charge is made for it.
  182.  
  183.  
  184.      Version History:
  185.  
  186.  
  187. 1.7D -- Fixed illusive bug that would sometimes cause an error when creating
  188.         a directory on a floppy.
  189. 1.7C -- added more explicit error messages
  190. 1.7B -- recompiled with TDI version 3.02A, mysterious gurus gone!
  191. 1.7A -- Added buffering of listing file for more speed
  192. 1.7  -- Added ERRORS and LISTING parameters
  193. 1.6B -- Fixed minor bugs, now runs a little faster.
  194. 1.6  -- Added "best-fit algorithm" for file storage on floppies
  195. 1.5L -- Tinkered with the code so it uses a little less memory and runs a little faster
  196. 1.5K -- Properly detects and handles errors occuring during a format
  197. 1.5J -- Reduced stack size requirements
  198. 1.5I -- Thanks to the arp.library, parameter handling is now
  199.         a little better, and the prefix-string now defaults to todays date.
  200. 1.5F -- Removed some unnecessary code; runs a little faster now
  201. 1.5E -- allowed complete file names to be as long as 255 chars
  202. 1.5D -- minor bug fixes
  203. 1.5B -- first release
  204.