home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR13 / FBR183.ZIP / FBR.DOC < prev    next >
Text File  |  1992-07-07  |  20KB  |  549 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.8
  29.                                    July 1992
  30.  
  31.                      (c) Copyright Vernon D. Buerg 1985-92
  32.                               ALL RIGHTS RESERVED
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.        FBR is a copyrighted work and may not be distributed without
  53.        permission.
  54.  
  55. FBR - File Backup / Restore
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.                                 Notice
  66.                                 ------
  67.  
  68.         This is a development test release of FBR. Use these
  69.         programs at your own risk.  Although they have  been
  70.         extensively tested,  I take no responsiblity for any
  71.         losses.
  72.  
  73.  
  74.  
  75.                              NOT PUBLIC DOMAIN
  76.                              -----------------
  77.  
  78.         This document and the FBR programs are the personal property
  79.         of:
  80.  
  81.                         Vernon D. Buerg
  82.                         139 White Oak Circle
  83.                         Petaluma, CA  94952
  84.  
  85.                         BBS: (707) 778-8944
  86.                              (707) 778-8841
  87.                              (415) 994-2944
  88.  
  89.                         FAX: (707) 769-5479
  90.  
  91.                         Compuserve: 70007,1212 (Go IBMHW)
  92.  
  93.  
  94.         FBR is distributed by me for your personal use.  You may not
  95.         charge for distributing FBR.  Commercial use of FBR requires a
  96.         Commercial Distribution License from me.  Corporations and
  97.         institutions may not use FBR without first obtaining a site
  98.         license.
  99.  
  100.  
  101.  
  102.         Please let me know of any problems, criticisms, or suggestions.
  103.         Thank you.
  104.  
  105.  
  106. FBR - File Backup/Restore                                            Contents
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.                                 Table of Contents
  115.                                 -----------------
  116.  
  117.                 Introduction ............................... 1
  118.  
  119.                 FB - File backup ........................... 2
  120.  
  121.                   Backup examples .......................... 3
  122.  
  123.                 FR - File restore .......................... 4
  124.  
  125.                   Restore examples ......................... 5
  126.  
  127.                 FS - File status ........................... 6
  128.  
  129.                 FLH - FBR's Little Helper .................. 7
  130.  
  131.                 Operational notes .......................... 8
  132.  
  133.                 Version history ............................ 9
  134.  
  135.  
  136. FBR - File Backup / Restore                                             Page 1
  137.  
  138.  
  139.  
  140.                             Introduction
  141.                             ------------
  142.  
  143.         FBR is a system of four small programs which perform the backing
  144.         up and restoring of files.  They are similar to the DOS
  145.         BACKUP/RESTORE utilities except that FBR can currently only
  146.         process one directory at a time, or all directories on one
  147.         drive.  It does, however, back up all files in a directory,
  148.         filling as many backup disks as necessary.  The FBR backup and
  149.         restore programs can select files based upon 30 file
  150.         specifications.
  151.  
  152.  
  153.  
  154.                              Programs
  155.                              --------
  156.  
  157.         The FBR system consists of these files:
  158.  
  159.             FB.COM   -  used to back up files
  160.             FR.COM   -  used to restore FBR files
  161.             FS.COM   -  to report on contents of FBR files
  162.             FLH.COM  -  FBR's Little Helper for multiple directories
  163.             FBR.DOC  -  this document
  164.  
  165.         It is recommended that the FR.COM program be copied to the
  166.         first diskette of each backup. This will insure that the
  167.         restore program is the correct one for restoring the files.
  168.         The file name may include a version number, e.g. FB177.COM
  169.         instead of FB.COM for the backup program.
  170.  
  171. FBR - File Backup / Restore                                             Page 2
  172.  
  173.                         Backup - FB Command
  174.                         -------------------
  175.  
  176.         To back up files in a directory, use the FB.COM program.
  177.  
  178.  
  179.     FB  [d:][\path][filespec] [filespec...] [/D] [/M] [/2] [/C] [/V] [/Z] [t:]
  180.  
  181.  
  182.         At least one command line operand must be supplied. The /Z option
  183.         tells FB to compress the files, resulting in fewer backup disks
  184.         depending on the kind of data in the files. You can expect compression
  185.         of 15 to 20% for text files, and no compression of binary or
  186.         program files.
  187.  
  188.         If the first d:  (drive) operand is supplied, it specifies the
  189.         drive, and/or path, and/or a file specification for the files to
  190.         be backed up.  Only files matching the 'filespec' are processed.
  191.  
  192.         More than one 'filespec' may be supplied.  Separate each file
  193.         specification by a blank or a comma.
  194.  
  195.         The IBMDOS.COM, IBMBIO.COM, MSDOS.SYS, and IO.SYS files are
  196.         ignored.
  197.  
  198.         The 't:' operand specifies the target drive.
  199.  
  200.         The /D operand specifies that all files on the target disk be
  201.         deleted before files are backed up to it.
  202.  
  203.         The /M operand specifies that only modified files are to be
  204.         backed up, i.e.  archive bit not set.
  205.  
  206.         The /2 operand specifies that the target drive is to alternate
  207.         from either B to A, or from A to B.  This allows backups to
  208.         continue while changing floppy diskettes.
  209.  
  210.         The /C operand specifies that the archive bit for each file
  211.         copied should be reset.
  212.  
  213.         The /V operand specifies that the DOS verify function should be
  214.         used.  This results in slower I/O but perhaps more peace of
  215.         mind.
  216.  
  217.         As each file is processed, a message is displayed telling you
  218.         the name of the file that has been copied.  You may abort the
  219.         back-up by pressing ESCape or control-C.
  220.  
  221.         When a backup drive fills, you are asked to ready another
  222.         diskette and to press any key.  To cancel the backup at this
  223.         point, press the ESCape key.  The state of the copied files is
  224.         unpredictable if you cancel the back up.
  225. FBR - File Backup / Restore                                             Page 3
  226.  
  227.  
  228.         Backup Examples:
  229.         ---------------
  230.  
  231.         o  If the current drive is C: and the current directory
  232.            is \ME, then to backup all of the C:\ME files
  233.            onto two alternating drives, issue the following:
  234.  
  235.                 FB /2    -or-  FB C:\ME\*.* /2  B:
  236.  
  237.         o  To backup only files with an extension of COM or EXE:
  238.  
  239.                 FB *.COM *.EXE
  240.  
  241.         o  Backup two files from a directory on drive D, and delete
  242.            any files already on the backup diskette:
  243.  
  244.                 FB d:\subdir\file1.ext file2.ext b: /D
  245.  
  246. FBR - File Backup / Restore                                             Page 4
  247.  
  248.                             Restore - FR Command
  249.                             --------------------
  250.  
  251.         To restore files backed up by FB, use the FR.COM program.
  252.  
  253.     FR  [d:][\path]  [filespec...]  [/2] [/R] [/U] [/N] [/V] [/Q] [/Td:\path]
  254.  
  255.  
  256.         The 'd:' operand specifies the drive which contains the FBR
  257.         files from FB.  If omitted, drive A is used.
  258.  
  259.         The \path operand identifies the FBR file to use for the
  260.         restore.  If omitted, the first FBR file found is used.
  261.  
  262.         Up to 30 "filespec" parameters may be supplied.  Only those
  263.         files which match one of the "filespecs" are restored.
  264.  
  265.         The '/2' operand specifies that two drives are to be used for
  266.         restoring files.  The request for readying drives alternates
  267.         from B to A, or from A to B.
  268.  
  269.         The '/V' option specifies that the system verify option is to be
  270.         set on.  Otherwise, verify is set off to improve speed.
  271.  
  272.         The '/R' option specifies that any existing copies of the files
  273.         be over-written.  If omitted, you will be asked whether or not
  274.         an existing file may be replaced.  This is the fastest method
  275.         of restoring files.
  276.  
  277.         The '/U' option specifies that only new files from the backup
  278.         set be restored.  A new file is one that does not already exist
  279.         in the target directory, or one that has a later file date and
  280.         time.
  281.  
  282.         The '/N' option specifies that the prompt to ready the first
  283.         input disk be skipped.
  284.  
  285.         If you ready the wrong FBR disk, the program asks again for the
  286.         same disk number again. Press ESCape or ctrl-C to abort.
  287.  
  288.         Use the /Q switch to disbale beeps and bells.
  289.  
  290.         The '/Td:\path' parameter specifies the destination drive
  291.         and directory for the restored files. If omitted, the
  292.         the current drive and directory are used.
  293.  
  294.         As each file is restored, a message is displayed telling you the
  295.         name of the file.  As a backup disk becomes completely read, you
  296.         are asked to ready another.  You may press the ESCape or
  297.         control-C at any time to cancel the restore operation.  All
  298.         files except the last one are valid.
  299.  
  300.         If the target disk runs out of space, the restore stops and the
  301.         last file may be unusable.
  302. FBR - File Backup / Restore                                             Page 5
  303.  
  304.  
  305.         Each restored file has the same or later date, and the same file
  306.         attribute as the original (backup copy) of the file.  Existing
  307.         files are over-written if the /R option is used, or if the
  308.         backup copy of the file is newer and the /U option is used.
  309.  
  310.  
  311.         FR Examples:
  312.         -----------
  313.  
  314.         o  To restore the files from an FBR disk(s) in
  315.            drive B, use the following:
  316.  
  317.                 FR B:
  318.  
  319.  
  320.         o  Restore the subdirectory TEST which has an FBR file
  321.            name of @TEST@@@.#01
  322.  
  323.                 FR a:\test
  324.  
  325.  
  326.         o  To restore only files with an extension of COM or EXE:
  327.            that are newer:
  328.  
  329.                 FR *.COM *.EXE /U
  330.  
  331.         o  To restore the files to drive D in the directory WORK:
  332.  
  333.                 FR /Td:\work
  334. FBR - File Backup / Restore                                             Page 6
  335.  
  336.                             Status - FS Command
  337.                             -------------------
  338.  
  339.         To determine the names of files backed up into FBR file(s), and
  340.         on which diskette they reside, use the FS.COM program.
  341.  
  342.                 FS  [d:][pathname] [filespec]  [/N]
  343.  
  344.         The single operand 'd:' specifies the drive which contains the
  345.         FBR file(s).  If omitted, drive A is assumed.
  346.  
  347.         If no 'pathname' is supplied, the directories for all FBR files
  348.         on the disk are displayed.  Otherwise, only those FBR files
  349.         which match the pathname are shown.
  350.  
  351.         Up to 30 file specifications may be supplied. If omitted, all
  352.         FBR file entries are displayed. If supplied, only those entries
  353.         that match one of the filespecs is displayed.
  354.  
  355.         It is not necessary to use the first disk of FBR files for FS to
  356.         display file status information.  The LAST diskette contains the
  357.         most accurate data regarding which diskettes that files are on.
  358.         If the 'Disk Pos' is given as '?', the diskette numbers are
  359.         estimates.
  360.  
  361.         For each file backed up by FB, one line of information is
  362.         displayed.  This includes the file name, create date, file size,
  363.         file attributes, and the diskette number.  The files are
  364.         displayed in alphabetical order unless the /N option is used,
  365.         then the files are listed in the physical order in which they
  366.         were backed up.
  367.  
  368.         If a file starts on one disk and ends on another, two volume
  369.         numbers are displayed, e.g.  01 02.
  370.  
  371.         When the screen fills, the message "more..." is displayed.  You
  372.         may enter ESCape or control-C, or the letter N to abort and
  373.         return to DOS.
  374. FBR - File Backup / Restore                                             Page 7
  375.  
  376.                            FBR's Little Helper - FLH
  377.                            -------------------------
  378.  
  379.         The FB backup program normally processes only one directory at
  380.         a time.  To allow backing up all directories on one drive, the
  381.         FLH program must be used. It has the same syntax as the FB
  382.         command.  FLH runs the FB program for each directory on the
  383.         specified drive.
  384.  
  385.  
  386.                FLH  s:[\path]  [t:]  [options]
  387.  
  388.        The options supplied on the command line are passed to the FB
  389.        program.
  390.  
  391. FBR - File Backup / Restore                                             Page 8
  392.  
  393.                               Operational Notes
  394.                               -----------------
  395.  
  396.         The FB backup program creates one file in the root directory
  397.         of each disk that it uses.
  398.  
  399.         The filename is of the form '@ppppppp.#nn',
  400.  
  401.              where 'nn' is a sequential volume number beginning with 01;
  402.              and 'ppppppp' is the name of the origin directory. For root
  403.              directories, the name also contains the drive letter.
  404.              For example, '@ROOTC@@.#01' is the first backup file for
  405.              the root directory of the disk from drive C.
  406.  
  407.         FB may not scratch the target disk.  It will use whatever space
  408.         is available for making its backup copies and ask for another
  409.         disk as needed.  Because the FBR filenames are taken from the
  410.         the origin directory name, more than directory may be backed up
  411.         onto one diskette.
  412.  
  413.         FB requires about 64K of memory but will use all available
  414.         memory if it needs to for storing directory information.
  415.  
  416.         FR restores files to the current drive and subdirectory.  This
  417.         is intentional as it yields more flexibility.
  418.  
  419.         I've noticed that FBR is about twice as fast as BACKUP, and that
  420.         the /2 option for using two drives is very helpful.  The amount
  421.         of disk space is about the same.
  422.  
  423.         The FBR files may reside on any type of disk supported by the
  424.         operating system.  That is, a floppy diskette may be backed up
  425.         to a fixed disk, if so desired.
  426.  
  427.         Since the FBR files are unique on any disk (or subdirectory)
  428.         there is no reason why they can not be sQueezed or ARCed for
  429.         transporting to other systems.  For example, an entire floppy
  430.         disk of files will most likely produce one FBR file that can be
  431.         compressed and then transmitted.
  432.  
  433.                              More?
  434.                              -----
  435.  
  436.         FBR was written to satisfy my personal method of backup.  I'm
  437.         sure there are much better methods and programs, but FBR is
  438.         cheap (free for personal use), and it's easy for me to use.  I
  439.         don't use it for all my backup procedures, but it has saved me
  440.         more than once.
  441.  
  442.         Future enhancements will allow processing all subdirectories in
  443.         the current directory, formatting of the target disks, and the
  444.         ability to add files to an existing FBR file.
  445.  
  446. FBR - File Backup / Restore                                            Page 9
  447.  
  448.                              Version History
  449.                              ---------------
  450.  
  451.         1.0 - October 28, 1985
  452.         1.1 - October 30, 1985
  453.                 - added /C and /V options to FB
  454.                 - subdirectory and IBMxxx.COM entries are excluded
  455.                   from the FBR files to save some space
  456.                 - fixed the ESCape (or ctrl-C) response to abort FB
  457.                 - changed FS to show two disk numbers for files which
  458.                   span volumes
  459.         1.2 - October 31, 1985
  460.         1.3 - November 12, 1985
  461.                 - the table at the beginning of each FBR file now contains
  462.                   the actual diskette number for each file, this makes
  463.                   this version incompatibile with previous versions, so
  464.                   it's a good idea to place FR.COM on each FBR disk.
  465.                 - FS now lists the file alphabetically, and if the last
  466.                   disk is used, the diskette numbers are accurate; otherwise
  467.                   the diskette number is calculated and may not be correct.
  468.                 - the FBR file name was changed to allow multiple directories
  469.                   to be backed up onto one disk; this also provides more
  470.                   information about what the FBR file contains.
  471.                 - the ESCape key can be used at any time during FB to abort
  472.                   the backup.
  473.         1.4 - December 7, 1985
  474.                 - FB may selectively back up files
  475.                 - FR may selectively restore files
  476.                 - FS processes all FBR files on the specified drive
  477.                 - the ESCape and control-C keys may be used at any
  478.                   time to abort an FBR program; control-break is not
  479.                   accepted
  480.         1.45 - January 25, 1986
  481.                 - correct path syntax for FR
  482.  
  483.         1.47 - February 2, 1986
  484.                 - corrections to FR for multiple volumes
  485.  
  486.         1.49 - February 16, 1986
  487.                 - corrections to FR for large files spanning two disks
  488.                 - add path operand to FS
  489.                 - remove BIOS specific display routines from FS
  490.  
  491.         1.50 - March 13, 1986
  492.                 - corrections to FR for selective file restore
  493.                 - add display options to FS
  494.  
  495.         1.53 - May 21, 1986
  496.                 - add /D option to FB to delete files on target disks
  497.                 - exclude MSDOS.SYS and IO.SYS
  498.                 - change FB to process files in ascending size order
  499.  
  500. FBR - File Backup / Restore                                           Page 10
  501.  
  502.                              Version History (cont'd)
  503.                              ---------------
  504.  
  505.         1.54 - June 14, 1986
  506.                 - add /V, /R and /U options to FR
  507.                 - display file names 5-up in FR
  508.                 - make FB smaller
  509.  
  510.         1.55 - April 7, 1987
  511.                 - correct problem with cross-linked clusters using /D
  512.                 - correct problems supplying filespecs to FB
  513.  
  514.         1.58 - July 30, 1987
  515.                 - FB: improve performance writing to target drive
  516.  
  517.         1.60 - Aug 1, 1987
  518.                 - FB: add display of file count, total bytes, and
  519.                       count of disks required
  520.                 - FB: improve file selection routines
  521.  
  522.         1.61 - Aug 4, 1987
  523.                 - FS: add filespec command line option
  524.                 - FR: replace file selection routines
  525.                 - FR: correct abort if wrong disk mounted
  526.                 - FR: correct restore of file after replying Y to
  527.                       "already exitts" message
  528.  
  529.         1.62 - Nov 11, 1987
  530.                 - FR: correct drive letter in mount message
  531.                 - FR: correct problem using 'd:\path' in command not
  532.                       using correct fbr filename
  533.  
  534.         1.63 - Mar 20, 1988
  535.                 - FR: correct problem restoring from multiple disks
  536.  
  537.         1.73 - Mar 31, 1989
  538.                 - FB: added /Z option to compress files
  539. ****            - version 1.7 is not compatible with earlier versions   *******
  540.         1.74 - Apr 7, 1989
  541.                 - FB: added SHARE capabilty which allows you to back up
  542.                   open files that are SHARED
  543.         1.76 - Oct 10, 1989 - corrections to compression routines
  544.         1.80 - Jul 9, 1991
  545.                 - FR: add /N and /T options
  546.                 - FB: improve compress algorithm
  547.         1.81 - Jun 1, 1992 - FR: correct selective restore
  548.         1.82 - Jul 7, 1992 - FB: correct file position for multi volumes
  549.