home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / utils / assort.zip / FBR161.DOC < prev    next >
Text File  |  1987-08-04  |  18KB  |  721 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.                          FBR - File Backup / Restore
  28.                                  Version  1.61
  29.                                   Aug 4,1987
  30.  
  31.                      (c) Copyright Vernon D. Buerg 1986,1987
  32.                                 ALL RIGHTS RESERVED
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62. FBR - File Backup / Restore
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.                                 Notice
  73.                                 ------
  74.  
  75.         This is a development test release of FBR. Use these
  76.         programs at your own risk.  Although they have  been
  77.         extensively tested,  I take no responsiblity for any
  78.         losses.
  79.  
  80.  
  81.  
  82.                              NOT PUBLIC DOMAIN
  83.                              -----------------
  84.  
  85.         This document and the FBR programs are the personal property
  86.         of:
  87.  
  88.                         Vernon D. Buerg
  89.                         456 Lakeshire Drive
  90.                         Daly City, CA 94015
  91.  
  92.                         VOR BBS: 415-994-2944
  93.                         Compuserve: 70007,1212
  94.  
  95.         FBR is distributed by me for your personal use. You may not
  96.         charge for distributing FBR. Commercial use of FBR is
  97.         prohibited.  Corporations and institutions may not use FBR
  98.         without first obtaining written permission. Sorry about that,
  99.         but if anyone is going to make a buck from this, it should be me.
  100.  
  101.  
  102.         Please let me know of any problems, criticisms, or suggestions.
  103.         Thank you.
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122. FBR - File Backup/Restore                                            Contents
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.                                 Table of Contents
  131.                                 -----------------
  132.  
  133.                 Introduction ............................... 1
  134.  
  135.                 FB - File backup ........................... 2
  136.  
  137.                   Backup examples .......................... 3
  138.  
  139.                 FR - File restore .......................... 4
  140.  
  141.                   Restore examples ......................... 5
  142.  
  143.                 FS - File status ........................... 6
  144.  
  145.                 Operational notes .......................... 7
  146.  
  147.                 Version history ............................ 8
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183. FBR - File Backup / Restore                                             Page 1
  184.  
  185.  
  186.  
  187.  
  188.                             Introduction
  189.                             ------------
  190.  
  191.         FBR is a system of three small programs which perform the
  192.         backing up and restoring of files.  They are similar to the
  193.         DOS BACKUP/RESTORE utilities except that FBR can currently
  194.         only process one directory at a time.  It does, however, back
  195.         up all files in a directory, filling as many backup disks as
  196.         necessary.  The FBR backup and restore programs can select
  197.         files based upon 30 file specifications.
  198.  
  199.  
  200.  
  201.                              Programs
  202.                              --------
  203.  
  204.         The FBR system consists of these files:
  205.  
  206.             FB.COM   -  used to back up files
  207.             FR.COM   -  used to restore FBR files
  208.             FS.COM   -  to report on contents of FBR files
  209.             FBR.DOC  -  this document
  210.  
  211.         It is recommended that the FR.COM program be copied to the
  212.         first diskette of each backup. This will insure that the
  213.         restore program is the correct one for restoring the files.
  214.         The file name may include a version number, e.g. FB158.COM
  215.         instead of FB.COM for the backup program.
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243. FBR - File Backup / Restore                                             Page 2
  244.  
  245.  
  246.                         Backup - FB Command
  247.                         -------------------
  248.  
  249.         To back up files in a directory, use the FB.COM program.
  250.  
  251.  
  252.     FB  [d:][\path][filespec] [filespec...] [/D] [/M] [/2] [/C] [/V] [t:]
  253.  
  254.  
  255.         If no command line parameters are supplied, FB backs up all the
  256.         files in the current directory to the disk in drive A.
  257.  
  258.         If the first d:  (drive) operand is supplied, it specifies the
  259.         drive, and/or path, and/or a file specification for the files to
  260.         be backed up.  Only files matching the 'filespec' are processed.
  261.  
  262.         More than one 'filespec' may be supplied.  Separate each file
  263.         specification by a blank or a comma.
  264.  
  265.         The IBMDOS.COM, IBMBIO.COM, MSDOS.SYS, and IO.SYS files are
  266.         ignored.
  267.  
  268.         The last 't:' operand specifies the target drive, and it must be
  269.         the LAST operand.
  270.  
  271.         The /D operand specifies that all files on the target disk be
  272.         deleted before files are backed up to it.
  273.  
  274.         The /M operand specifies that only modified files are to be
  275.         backed up, i.e.  archive bit not set.
  276.  
  277.         The /2 operand specifies that the target drive is to alternate
  278.         from either B to A, or from A to B.  This allows backups to
  279.         continue while changing floppy diskettes.
  280.  
  281.         The /C operand specifies that the archive bit for each file
  282.         copied should be reset.
  283.  
  284.         The /V operand specifies that the DOS verify function should be
  285.         used.  This results in slower I/O but perhaps more peace of
  286.         mind.
  287.  
  288.         As each file is processed, a message is displayed telling you
  289.         the name of the file that has been copied.  You may abort the
  290.         back-up by pressing ESCape or control-C.
  291.  
  292.         When a backup drive fills, you are asked to ready another
  293.         diskette and to press any key.  To cancel the backup at this
  294.         point, press the ESCape key.  The state of the copied files is
  295.         unpredictable if you cancel the back up.
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302. FBR - File Backup / Restore                                             Page 3
  303.  
  304.  
  305.  
  306.         Backup Examples:
  307.         ---------------
  308.  
  309.         o  If the current drive is C: and the current directory
  310.            is \ME, then to backup all of the C:\ME files
  311.            onto two alternating drives, issue the following:
  312.  
  313.                 FB /2    -or-  FB C:\ME\*.* /2  B:
  314.  
  315.         o  To backup only files with an extension of COM or EXE:
  316.  
  317.                 FB *.COM *.EXE
  318.  
  319.         o  Backup two files from a directory on drive D, and delete
  320.            any files already on the backup diskette:
  321.  
  322.                 FB d:\subdir\file1.ext file2.ext b: /D
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362. FBR - File Backup / Restore                                             Page 4
  363.  
  364.  
  365.                             Restore - FR Command
  366.                             --------------------
  367.  
  368.         To restore files backed up by FB, use the FR.COM program.
  369.  
  370.     FR  [d:][\path]  [filespec...]  [/2] [/R] [/U] [/V] [/Q]
  371.  
  372.         The 'd:' operand specifies the drive which contains the FBR
  373.         files from FB.  If omitted, drive A is used.
  374.  
  375.         The \path operand identifies the FBR file to use for the
  376.         restore.  If omitted, the first FBR file found is used.
  377.  
  378.         Up to 30 "filespec" parameters may be supplied.  Only those
  379.         files which match one of the "filespecs" are restored.
  380.  
  381.         The '/2' operand specifies that two drives are to be used for
  382.         restoring files.  The request for readying drives alternates
  383.         from B to A, or from A to B.
  384.  
  385.         The '/V' option specifies that the system verify option is to be
  386.         set on.  Otherwise, verify is set off to improve speed.
  387.  
  388.         The '/R' option specifies that any existing copies of the files
  389.         be over-written.  If omitted, you will be asked whether or not
  390.         an existing file may be replaced.  This is the fastest method
  391.         of restoring files.
  392.  
  393.         The '/U' option specifies that only new files from the backup
  394.         set be restored.  A new file is one that does not already exist
  395.         in the target directory, or one that has a later file date and
  396.         time.
  397.  
  398.         Use the /Q switch to disbale beeps and bells.
  399.  
  400. |       If you mount the wrong FBR disk, the program asks again for the
  401. |       same disk number. Press ESCape or ctrl-C to abort.
  402.  
  403.         As each file is restored, a message is displayed telling you the
  404.         name of the file.  As a backup disk becomes completely read, you
  405.         are asked to ready another.  You may press the ESCape or
  406.         control-C at any time to cancel the restore operation.  All
  407.         files except the last one are valid.
  408.  
  409.         If the target disk runs out of space, the restore stops and the
  410.         last file may be unusable.
  411.  
  412.         Each restored file has the same or later date, and the same file
  413.         attribute as the original (backup copy) of the file.  Existing
  414.         files are over-written if the /R option is used, or if the
  415.         backup copy of the file is newer and the /U option is used.
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422. FBR - File Backup / Restore                                             Page 5
  423.  
  424.  
  425.         FR Examples:
  426.         -----------
  427.  
  428.         o  To restore the files from an FBR disk(s) in
  429.            drive B, use the following:
  430.  
  431.                 FR B:
  432.  
  433.  
  434.         o  Restore the subdirectory TEST which has an FBR file
  435.            name of @TEST@@@.#01
  436.  
  437.                 FR a:\test
  438.  
  439.  
  440.         o  To restore only files with an extension of COM or EXE:
  441. |          that are newer:
  442.  
  443. |               FR *.COM *.EXE /U
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482. FBR - File Backup / Restore                                             Page 6
  483.  
  484.                             Status - FS Command
  485.                             -------------------
  486.  
  487.         To determine the names of files backed up into FBR file(s), and
  488.         on which diskette they reside, use the FS.COM program.
  489.  
  490.                 FS  [d:][pathname] [filespec]  [/N]
  491.  
  492.         The single operand 'd:' specifies the drive which contains the
  493.         FBR file(s).  If omitted, drive A is assumed.
  494.  
  495.         If no 'pathname' is supplied, the directories for all FBR files
  496.         on the disk are displayed.  Otherwise, only those FBR files
  497.         which match the pathname are shown.
  498.  
  499. |       Up to 30 file specifications may be supplied. If omitted, all
  500. |       FBR file entries are displayed. If supplied, only those entries
  501. |       that match one of the filespecs is displayed.
  502.  
  503.         It is not necessary to use the first disk of FBR files for FS to
  504.         display file status information.  The LAST diskette contains the
  505.         most accurate data regarding which diskettes that files are on.
  506. |       If the 'Disk Pos' is given as '?', the diskette numbers are
  507.         estimates.
  508.  
  509.         For each file backed up by FB, one line of information is
  510.         displayed.  This includes the file name, create date, file size,
  511.         file attributes, and the diskette number.  The files are
  512.         displayed in alphabetical order unless the /N option is used,
  513.         then the files are listed in the physical order in which they
  514.         were backed up.
  515.  
  516.         If a file starts on one disk and ends on another, two volume
  517.         numbers are displayed, e.g.  01 02.
  518.  
  519.         When the screen fills, the message "more..." is displayed.  You
  520.         may enter ESCape or control-C, or the letter N to abort and
  521.         return to DOS.
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542. FBR - File Backup / Restore                                             Page 7
  543.  
  544.                               Operational Notes
  545.                               -----------------
  546.  
  547.         The FB backup program creates one file on each disk that it
  548.         uses.
  549.  
  550.         The filename is of the form '@ppppppp.#nn',
  551.  
  552.              where 'nn' is a sequential volume number beginning with 01;
  553.              and 'ppppppp' is the name of the origin directory. For root
  554.              directories, the name also contains the drive letter.
  555.              For example, '@ROOTC@@.#01' is the first backup file for
  556.              the root directory of the disk from drive C.
  557.  
  558.         FB may not scratch the target disk.  It will use whatever space
  559.         is available for making its backup copies and ask for another
  560.         disk as needed.  Because the FBR filenames are taken from the
  561.         the origin directory name, more than directory may be backed up
  562.         onto one diskette.
  563.  
  564.         FB requires about 64K of memory but will use all available
  565.         memory if it needs to for storing directory information.
  566.  
  567.         FR restores files to the current drive and subdirectory.  This
  568.         is intentional as it yields more flexibility.
  569.  
  570.         I've noticed that FBR is about twice as fast as BACKUP, and that
  571.         the /2 option for using two drives is very helpful.  The amount
  572.         of disk space is about the same.
  573.  
  574.         The FBR files may reside on any type of disk supported by the
  575.         operating system.  That is, a floppy diskette may be backed up
  576.         to a fixed disk, if so desired.
  577.  
  578.         Since the FBR files are unique on any disk (or subdirectory)
  579.         there is no reason why they can not be sQueezed or ARCed for
  580.         transporting to other systems.  For example, an entire floppy
  581.         disk of files will most likely produce one FBR file that can be
  582.         compressed and then transmitted.
  583.  
  584.  
  585.                              More?
  586.                              -----
  587.  
  588.         FBR was written to satisfy my personal method of backup.  I'm
  589.         sure there are much better methods and programs, but FBR is
  590.         cheap (free), and it's easy for me to use.  I don't use it for
  591.         all my backup procedures, but it has saved me more than once.
  592.  
  593.         Future enhancements will allow processing all subdirectories in
  594.         the current directory, formatting of the target disks, and the
  595.         ability to add files to an existing FBR file.
  596.  
  597.         If you like FBR, let me know.  Otherwise I'll get bored with it
  598.         and forget all about it.
  599.  
  600.  
  601.  
  602. FBR - File Backup / Restore                                             Page 8
  603.  
  604.                              Version History
  605.                              ---------------
  606.  
  607.         1.0 - October 28, 1985
  608.         1.1 - October 30, 1985
  609.                 - added /C and /V options to FB
  610.                 - subdirectory and IBMxxx.COM entries are excluded
  611.                   from the FBR files to save some space
  612.                 - fixed the ESCape (or ctrl-C) response to abort FB
  613.                 - changed FS to show two disk numbers for files which
  614.                   span volumes
  615.         1.2 - October 31, 1985
  616.         1.3 - November 12, 1985
  617.                 - the table at the beginning of each FBR file now contains
  618.                   the actual diskette number for each file, this makes
  619.                   this version incompatibile with previous versions, so
  620.                   it's a good idea to place FR.COM on each FBR disk.
  621.                 - FS now lists the file alphabetically, and if the last
  622.                   disk is used, the diskette numbers are accurate; otherwise
  623.                   the diskette number is calculated and may not be correct.
  624.                 - the FBR file name was changed to allow multiple directories
  625.                   to be backed up onto one disk; this also provides more
  626.                   information about what the FBR file contains.
  627.                 - the ESCape key can be used at any time during FB to abort
  628.                   the backup.
  629.         1.4 - December 7, 1985
  630.                 - FB may selectively back up files
  631.                 - FR may selectively restore files
  632.                 - FS processes all FBR files on the specified drive
  633.                 - the ESCape and control-C keys may be used at any
  634.                   time to abort an FBR program; control-break is not
  635.                   accepted
  636.         1.45 - January 25, 1986
  637.                 - correct path syntax for FR
  638.  
  639.         1.47 - February 2, 1986
  640.                 - corrections to FR for multiple volumes
  641.  
  642.         1.49 - February 16, 1986
  643.                 - corrections to FR for large files spanning two disks
  644.                 - add path operand to FS
  645.                 - remove BIOS specific display routines from FS
  646.  
  647.         1.50 - March 13, 1986
  648.                 - corrections to FR for selective file restore
  649.                 - add display options to FS
  650.  
  651.         1.53 - May 21, 1986
  652.                 - add /D option to FB to delete files on target disks
  653.                 - exclude MSDOS.SYS and IO.SYS
  654.                 - change FB to process files in ascending size order
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662. FBR - File Backup / Restore                                             Page 9
  663.  
  664.  
  665.                              Version History (cont'd)
  666.                              ---------------
  667.  
  668.  
  669.         1.54 - June 14, 1986
  670.                 - add /V, /R and /U options to FR
  671.                 - display file names 5-up in FR
  672.                 - make FB smaller
  673.  
  674.         1.55 - April 7, 1987
  675.                 - correct problem with cross-linked clusters using /D
  676.                 - correct problems supplying filespecs to FB
  677.  
  678.         1.58 - July 30, 1987
  679.                 - FB: improve performance writing to target drive
  680.  
  681.         1.60 - Aug 1, 1987
  682.                 - FB: add display of file count, total bytes, and
  683.                       count of disks required
  684.                 - FB: improve file selection routines
  685.  
  686.         1.61 - Aug 4, 1987
  687.                 - FS: add filespec command line option
  688.                 - FR: replace file selection routines
  689.                 - FR: correct abort if wrong disk mounted
  690.                 - FR: correct restore of file after replying Y to
  691.                       "already exitts" message
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.