home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / BACKO1.ZIP / BU.DOC next >
Text File  |  1991-07-07  |  17KB  |  386 lines
  1.                        ████████████████████
  2.                        ██                ██
  3.                        ██    Backup/2    ██
  4.                        ██                ██
  5.                        ██  Version 1.01  ██
  6.                        ██                ██
  7.                        ████████████████████
  8.  
  9. ┌───────────────────────────────────────────────────────────────┐
  10. │ GENERAL                                                       │
  11. └───────────────────────────────────────────────────────────────┘
  12.  
  13.     Backup/2 makes fast, intelligent file backups for machines 
  14. running the OS/2 operating system.  It copies up only files which 
  15. don't exist on the target drive, or whose date-time stamps are 
  16. later than those of existing target files.  (A date-time stamp 
  17. tells when a file was created or last changed; it appears in 
  18. directory listings.)  Backup/2 does not use or change file 
  19. archive bits (unless you use the /A option). 
  20.  
  21.     Regular, frequent backups are your insurance policy.  They 
  22. protect the integrity of your data, especially if you have a hard 
  23. disk.  Backups protect against the inevitable disk crash, and 
  24. against malicious software that tries to destroy your files 
  25. (e.g., computer viruses and so called "Trojan horses").   A 
  26. single computer virus, for example, could bankrupt a business by 
  27. destroying vital customer or financial records.  Even in a home 
  28. environment, you might have to spend hours or days reloading 
  29. software and data files after a virus attack or a hard disk 
  30. crash.  Backup/2 can help protect against these disasters.  To 
  31. run program, enter: 
  32.  
  33.  
  34.      BU source[...] [target] [/A] [/G[C]] [/Vdrive:label...]
  35.  
  36.  
  37.     Brackets ([]) indicate optional items.  Ellipses (...) 
  38. indicate items you can repeat.  Arguments can be upper or lower 
  39. case.  Separate arguments with tabs or spaces. 
  40.  
  41. ■ 'Source' specifies the files to back up.  You can use standard 
  42.   wild card characters (? and *), & you can give multiple sources 
  43.   if desired. 
  44.     
  45. ■ 'Target' is destination for the backed up files.  If given, it 
  46.   must be a drive or directory (no wild card characters).  The 
  47.   default is the current directory on the default drive.  If you 
  48.   give more than one source file specification, you MUST list a 
  49.   target, so Backup/2 can distinguish between source & 
  50.   destination files. 
  51.     
  52. ■ /A clears the archive flag on backed up files.   OS/2 sets the 
  53.   archive flag whenever a file changes. 
  54.  
  55. ■ /G (stands for "globally") performs the same backup operation 
  56.   in every directory on the default drive.  To back up only in 
  57.   the current & subordinate directories, use /GC.  Don't use /G 
  58.   when the default drive is the target, or you may copy files 
  59.   into every directory on the default drive (unless, of course, 
  60.   that's what you want). 
  61.  
  62. ■ /V makes Backup/2 check disk volume labels before copying.  A 
  63.   volume label is the disk name that appears when you give a DIR 
  64.   or VOL command.  OS/2 can put a volume label on a disk when you 
  65.   format it, or when you give the LABEL command.  Follow the /V 
  66.   with a drive letter & colon, then the volume label itself.  If 
  67.   the volume label contains spaces or tabs, enclose the entire 
  68.   label & /V in double quotes. 
  69.  
  70.  
  71.     If you enter BU with no arguments, the program shows 
  72. instructions on the correct usage syntax. 
  73.  
  74.     Backup/2 squeezes the maximum possible number of files onto 
  75. the target disk.  If there isn't enough room on the target, some 
  76. files may not be copied, but Backup/2 will continue, trying to 
  77. find smaller files that WILL fit.  
  78.  
  79.     As Backup/2 runs, it shows the files it's processing & 
  80. whether or not it backed them up.  To abort the program while 
  81. it's running, press ^C or ^Break (hold down Ctrl & press C or 
  82. Break). 
  83.  
  84. ┌───────────────────────────────────────────────────────────────┐ 
  85. │ EXAMPLES                                                      │ 
  86. └───────────────────────────────────────────────────────────────┘ 
  87.  
  88. Example 1
  89.  
  90.             BU  *.C  D:  /G
  91.  
  92. This command backs up all files in the current directory with an 
  93. extension of 'C' to drive D: 
  94.  
  95. ________________________________________________________________
  96.  
  97. Example 2
  98.  
  99.             BU  *.C  B:  /GC  /VB:UTILS
  100.  
  101. backs up all files in the current & subordinate directories with 
  102. an extension of 'C' to drive B:.  Backup/2 checks to see that the 
  103. disk in drive B: has a volume label of 'UTILS.' 
  104.  
  105.  
  106. ________________________________________________________________
  107.  
  108. Example 3
  109.  
  110.             BU  A:*.C  A:*.H  . "/VA:DEMO PROG"
  111.  
  112. backs up files from the current directory on drive A: with 
  113. extensions of 'C' or 'H', or a root name of 'SAMPLE.'  Backup/2 
  114. checks to see that the disk in drive A: has a volume label of 
  115. 'DEMO PROG.'  It puts the copied files into the current directory 
  116. on the default drive. 
  117.  
  118. ┌───────────────────────────────────────────────────────────────┐
  119. │ SYSTEM REQUIREMENTS                                           │
  120. └───────────────────────────────────────────────────────────────┘
  121.  
  122.     This program requires the OS/2 operating system, version 1.2 
  123. or later.  It does not require the OS/2 Presentation Manager 
  124. (PM), though you can run it in a PM window. 
  125.  
  126. ┌───────────────────────────────────────────────────────────────┐
  127. │ EXIT CODES                                                    │
  128. └───────────────────────────────────────────────────────────────┘
  129.  
  130.     Backup/2 reports the following exit codes.  You can query 
  131. these with the ERRORLEVEL function in OS/2 batch files. 
  132.  
  133.     0  Operator aborted
  134.     1  No files were backed up (either there were none to do or 
  135.        an error occurred) 
  136.     2  Some, but not all, files were backed up
  137.     3  All files were backed up successfully
  138.  
  139. ┌───────────────────────────────────────────────────────────────┐
  140. │ REVISION HISTORY                                              │
  141. └───────────────────────────────────────────────────────────────┘
  142.  
  143. 1.00   Original version
  144.  
  145. 1.01   Optimized code to make program file smaller
  146.        Fixed bug that caused program to not back up multiple
  147.          filespecs correctly
  148.  
  149. ┌───────────────────────────────────────────────────────────────┐
  150. │ MESSAGES                                                      │
  151. └───────────────────────────────────────────────────────────────┘
  152.  
  153.    In the following messages, "source" is the file you're copying 
  154. FROM, & target is the file (or drive) you're copying TO. 
  155.  
  156.  
  157. Aborted as requested.  You pressed ^C or ^Break, so Backup/2 
  158. stopped.  Some, none, or all of the specified files may have been 
  159. copied to the target drive. 
  160.  
  161. Copied to XXXX.  File was successfully backed up. 
  162.  
  163. Copy failed - reason unknown.  For some reason, OS/2 refused to 
  164. copy the file.  Perhaps another program is using it at present.
  165.  
  166. Couldn't open source.  Another program is probably using the file 
  167. at this time.  Try again later. 
  168.  
  169. Couldn't open target.  Either the target disk has too many files 
  170. on it, another program is using the file at this time, or 
  171. something's wrong with the disk.  Try again later. 
  172.  
  173. Couldn't read source.  Another program is using the file at this 
  174. time, or something's wrong with your disk.  Try again later. 
  175.  
  176. Couldn't write target.  Another program is using the file at this 
  177. time, or something's wrong with your disk.   Try again later. 
  178.  
  179. No files found.  Backup/2 found no files meeting your 
  180. specifications.
  181.  
  182. No more search directories.  Other programs are current using all 
  183. of OS/2's file search resources.  Try terminating some of the 
  184. other programs or wait until they finish. 
  185.  
  186. Not enough room.  There's still space on the target drive, but 
  187. not enough for the file in question.  The program will continue 
  188. in case there are smaller files that will fit in the available 
  189. space. 
  190.  
  191. Put disk with volume label XXXX in drive X.  Put the requested 
  192. disk in the drive.  If you get this message even with the correct 
  193. disk, abort with ^C & check to see that you used the correct 
  194. volume label with /V.  Make sure you typed it exactly as it 
  195. appears on the disk, including embedded spaces. 
  196.  
  197. Target full.  You can't back up anything else until you delete 
  198. some files from the target drive (or use a different target 
  199. disk). 
  200.  
  201. Target is read only.  If you have my ATTRIBUTION program, use it 
  202. to clear the target file's flags so Backup/2 can update it.   
  203. Otherwise, see your local computer expert for a utility program 
  204. that will do this. 
  205.  
  206. Target still current.  The target file's date-time stamp is the 
  207. same as or later than the source file's, so Backup/2 didn't need 
  208. to copy it. 
  209.  
  210. This program cannot be run in DOS mode.  Either you're using the 
  211. MS-DOS or PC-DOS operating system, or you're in OS/2's DOS 
  212. compatibility box.  You must run Backup/2 under OS/2 & you may 
  213. not be in the DOS compatibility box. 
  214.  
  215. Volume label incomplete.  You used /V, but omitted the drive 
  216. letter and/or colon. 
  217.  
  218. ┌───────────────────────────────────────────────────────────────┐ 
  219. │ CREDITS                                                       │
  220. └───────────────────────────────────────────────────────────────┘
  221.  
  222.     Backup/2 was written in C by Richard W. Adams.  It was 
  223. developed with PC-Write, version 3.02, & the Microsoft C 
  224. Optimizing Compiler, version 5.1. 
  225.  
  226.     The author is a member of the Association of Shareware 
  227. Professionals (ASP).  You may reach him at the address given in 
  228. REGISTER.DOC.  Should that address no longer be valid, try 
  229. contacting him through the ASP (545 Grover Road, Muskegon, MI 
  230. 49442).  He is also sometimes available on CompuServe 
  231. (76430,1071). 
  232.  
  233. ┌───────────────────────────────────────────────────────────────┐ 
  234. │ REGISTRATION                                                  │
  235. └───────────────────────────────────────────────────────────────┘
  236.  
  237.     Backup/2 is copyright 1991 by Richard W. Adams, all rights 
  238. reserved.  The program is "shareware."  If you use Backup/2 for 
  239. more than 30 days, you must register.  To do so, complete the 
  240. registration form in REGISTER.DOC & send it with a check for the 
  241. indicated amount to the author at the address on the form. 
  242.  
  243. When you register, you receive:
  244.  
  245.     o The right to use your copy of Except on a single computer
  246.  
  247.     o FREE technical support by mail for three months
  248.  
  249.     o Eligibility for FREE copies of future versions if you're 
  250.       the first to suggest improvements or report bugs that are 
  251.       fixed/incorporated in future versions
  252.  
  253.     o A DISCOUNT if you subscribe to Shareware Magazine
  254.  
  255.    Not only is registration a legal & ethical requirement, but 
  256. registration fees give shareware authors the incentive to develop 
  257. new software & improve old ones. 
  258.  
  259.     Tax exempt Christian religious organizations & churches are 
  260. eligible for free registration of Backup/2 for official business.  
  261. Send a written request to the author, & you'll receive 
  262. registration forms.  The registration takes effect when you 
  263. complete & return the forms.  This is a charitable donation. 
  264.  
  265.     Companies, government agencies & other organizations may 
  266. obtain site licenses for Backup/2, at greatly reduced unit costs.  
  267. Contact the author for details & a price list. 
  268.  
  269. ┌───────────────────────────────────────────────────────────────┐ 
  270. │ SHAREWARE                                                     │ 
  271. └───────────────────────────────────────────────────────────────┘ 
  272.  
  273.     Shareware distribution gives users a chance to try software 
  274. before buying it. If you try a Shareware program and continue 
  275. using it, you are expected to register.  Individual programs 
  276. differ on details--some request registration, others require it, 
  277. and some specify a maximum trial period.  With registration, you 
  278. get anything from the simple right to continue using the software 
  279. to an updated program with printed manual. 
  280.  
  281.     Copyright laws apply to both Shareware and commercial 
  282. software, and the copyright holder retains all rights, with a few 
  283. specific exceptions as stated below.  Shareware authors are 
  284. accomplished programmers, just like commercial authors, and the 
  285. programs are of comparable quality. (In both cases, there are 
  286. good programs and bad ones!)  The main difference is in the 
  287. method of distribution.  The author specifically grants the right 
  288. to copy and distribute the software, either to all and sundry or 
  289. to a specific group.  For example, some authors require written 
  290. permission before a commercial disk vendor may copy their 
  291. Shareware. 
  292.  
  293.     Shareware is a distribution method, not a type of software. 
  294. You should find software that suits your needs and pocketbook, 
  295. whether it's commercial or Shareware. The Shareware system makes 
  296. fitting your needs easier, because you can try before you buy. 
  297. And because the overhead is low, prices are low also. Shareware 
  298. has the ultimate money-back guarantee--if you don't use the 
  299. product, you don't pay for it. 
  300.  
  301. DISCLAIMER - AGREEMENT 
  302.  
  303.     Users of Backup/2 must accept this disclaimer of warranty: 
  304. "Backup/2 is supplied as is.  The author disclaims all 
  305. warranties, expressed or implied, including, without limitation, 
  306. the warranties of merchantability and of fitness for any purpose. 
  307. The author assumes no liability for damages, direct or 
  308. consequential, which may result from the use of Backup/2." 
  309.  
  310.     Backup/2 is a Shareware program and is provided at no charge 
  311. for your evaluation.  Feel free to share it with your friends, 
  312. but please don't give it away altered or as part of another 
  313. system.  The essence of "user-supported" software is to provide 
  314. personal computer users with quality software without high 
  315. prices, and yet to provide incentive for programmers to continue 
  316. to develop new products.  If you find Backup/2 useful and 
  317. continue to use it after a reasonable trial period, you must make 
  318. a registration payment to the author.  The registration fee 
  319. licenses one copy for use on any one computer at any one time.  
  320. You must treat this software just like a book.  An example is 
  321. that any number of people may use this software and may freely 
  322. move it from one computer location to another, so long as there 
  323. is no possibility of it being used at one location while it's 
  324. being used at another.  Just as two different people can't read a 
  325. book at the same time. 
  326.  
  327.     Commercial users of Backup/2 must register and pay for their 
  328. copies of Backup/2 within 30 days of first use or their license 
  329. is withdrawn.  Site-License arrangements may be made by 
  330. contacting the author. 
  331.  
  332.     Anyone distributing Backup/2 for any kind of remuneration 
  333. must first contact the author for authorization. This 
  334. authorization will be automatically granted to distributors 
  335. recognized by the (ASP) as adhering to its guidelines for 
  336. shareware distributors, and such distributors may begin offering 
  337. Backup/2 immediately. (However, you must still advise the author 
  338. so the distributor can be kept up-to-date with the latest version 
  339. of Backup/2.) 
  340.  
  341.     You are encouraged to pass a copy of Backup/2 to your friends 
  342. for evaluation.  Please encourage them to register their copy if 
  343. they find that they can use it. 
  344.  
  345. ┌───────────────────────────────────────────────────────────────┐ 
  346. │ COPYING                                                       │ 
  347. └───────────────────────────────────────────────────────────────┘ 
  348.  
  349. You may copy & distribute Backup/2 freely, as long as you: 
  350.  
  351.     o Include all constituent files.
  352.  
  353.     o Don't change the software or documentation.
  354.  
  355.     o Don't distribute the program for commercial purposes 
  356.       without written permission from the author. 
  357.  
  358.     o Don't rent or lease it.
  359.  
  360.     o Charge no fee other than a nominal one to cover distribution 
  361.       costs.
  362.  
  363. ┌───────────────────────────────────────────────────────────────┐ 
  364. │ OMBUDSMAN                                                     │ 
  365. └───────────────────────────────────────────────────────────────┘ 
  366.  
  367.     The author is a member of the Association of Shareware 
  368. Professionals (ASP).  ASP wants to make sure that the shareware 
  369. principle works for you. If you can't resolve a shareware related 
  370. problem with an ASP member by contacting the member directly, ASP 
  371. may be able to help.  The ASP Ombudsman can help you resolve a 
  372. dispute or problem with an ASP member, but does not provide 
  373. technical support for members' products.  Please write to the ASP 
  374. Ombudsman at 545 Grover Road, Muskegon, MI 49442 or send a 
  375. CompuServe mail message to the ASP Ombudsman (70007,3536). 
  376.  
  377.                        _______
  378.                   ____|__     |                (R)
  379.                --|       |    |-------------------
  380.                  |   ____|__  |  Association of
  381.                  |  |       |_|  Shareware
  382.                  |__|   o   |    Professionals
  383.                -----|   |   |---------------------
  384.                     |___|___|    MEMBER
  385.  
  386.