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