Return to restor CVS log

Up to [MW Coherent from dump] / coherent / a / usr / man / COHERENT

Annotation of coherent/a/usr/man/COHERENT/restor, revision 1.1

1.1     ! root        1: 
        !             2: 
        !             3: restor                       Command                       restor
        !             4: 
        !             5: 
        !             6: 
        !             7: 
        !             8: Restore file system
        !             9: 
        !            10: rreessttoorr _c_o_m_m_a_n_d [_d_u_m_p__d_e_v_i_c_e][_f_i_l_e_s_y_s_t_e_m][_f_i_l_e ...]
        !            11: 
        !            12: restor copies  to the hard disk  one or more files  from tapes or
        !            13: floppy disks written by the command dump.
        !            14: 
        !            15: command is a character from the set rRtxX, optionally modified by
        !            16: v, f, or both.  The v  (verbose) modifier tells restor to print a
        !            17: step-by-step trace  of its actions when  restoring an entire file
        !            18: system.  This is for discovering  what went wrong when a mass re-
        !            19: store runs into trouble.  The f modifier tells restor to take the
        !            20: next argument as the path name of the dump device (tape or floppy
        !            21: disk  drive).  If  the f  modifier is  not specified,  the device
        !            22: /dev/dump is used.
        !            23: 
        !            24: The t command tells restor to read the header from the dump tape,
        !            25: and display  the date  the dump tape  was written and  the ``dump
        !            26: since'' date that produced the dump.
        !            27: 
        !            28: The x and X commands extract individual files from the dump tape.
        !            29: Each argument is a file to  be extracted.  All file names are ab-
        !            30: solute  path names  starting at  the root of  the dump  tape (the
        !            31: first directory dumped, which is always the root directory of the
        !            32: file system).  A numeric file name  is taken to be an i-number on
        !            33: the dumped file system, permitting restore by i-number.
        !            34: 
        !            35: restor  looks up  each argument  file in  the directories  of the
        !            36: dumped file system and prints out each name and associated i-num-
        !            37: ber.  If  the command  is x, restor  extracts the files  from the
        !            38: dump tape into files  in the current directory with names derived
        !            39: from the  dumped file's i-number.  The X  command is similar, ex-
        !            40: cept that before  it begins it asks the user  for the reel number
        !            41: of the  dump tape, and continues asking for  dump reels until all
        !            42: files have been extracted or the user types EOT.
        !            43: 
        !            44: The r and R commands allow  mass restoration of both full and in-
        !            45: cremental  dump tapes  into the argument  file system.   The file
        !            46: system must have enough data blocks and inodes to hold the dump.
        !            47: 
        !            48: The  mass restore  is performed  in three  phases.  In  the first
        !            49: phase, restor  clears all i-nodes that were  either clear at dump
        !            50: time  or are  going  to be  restored.  Any  allocated blocks  are
        !            51: released.  Next,  it restores all files on  the tape.  The i-num-
        !            52: bering is  preserved; however, data  blocks are allocated  in the
        !            53: standard fashion.   Finally a pass  is made over  the i-nodes and
        !            54: the list of free i-nodes in the superblock is updated.
        !            55: 
        !            56: The R  command is to  r as X is  to x: the r  command begins res-
        !            57: toring immediately,  while the R  command pauses to  ask for reel
        !            58: numbers.
        !            59: 
        !            60: 
        !            61: 
        !            62: 
        !            63: 
        !            64: COHERENT Lexicon                                           Page 1
        !            65: 
        !            66: 
        !            67: 
        !            68: 
        !            69: restor                       Command                       restor
        !            70: 
        !            71: 
        !            72: 
        !            73: ***** Files *****
        !            74: 
        !            75: /ddeevv/dduummpp -- Dump device
        !            76: /eettcc/ddddaattee -- Dump date file
        !            77: 
        !            78: ***** See Also *****
        !            79: 
        !            80: commands, dump, dumpdir
        !            81: 
        !            82: ***** Diagnostics *****
        !            83: 
        !            84: Most of the  diagnostics produced by restor are self explanatory,
        !            85: and are  caused by internal table overflows or  I/O errors on the
        !            86: dump tape or file system.
        !            87: 
        !            88: If the dump spans multiple reels of tape, restor asks the user to
        !            89: mount the  next reel  at the  appropriate time.  The  user should
        !            90: type a  newline when the reel has  been mounted.  restor verifies
        !            91: that this  is the correct reel and gives  the user another chance
        !            92: if the reel number in the dump tape header is incorrect.
        !            93: 
        !            94: ***** Notes *****
        !            95: 
        !            96: You cannot  perform a  mass restore  onto a live  root partition.
        !            97: Instead, boot a  stand-alone version of COHERENT on a floppy-disk
        !            98: drive,  or  boot  from an  alternative  COHERENT  file system  on
        !            99: another hard-disk partition before  you attempt to do a mass res-
        !           100: toration.
        !           101: 
        !           102: The handling  of tapes  with multiple  dumps on them  (created by
        !           103: dumping  to the  no rewind  special files)  is not  very general.
        !           104: Basically, restor  assumes that tapes holding  multiple dumps and
        !           105: tapes  holding dumps  that span multiple  reels are  mutually ex-
        !           106: clusive.  One can restore from  any file on a reel by positioning
        !           107: the tape  and then restoring with  the x or r  commands, which do
        !           108: not reposition the tape.  It  is (almost) impossible to use the X
        !           109: or R commands, as the position of the dump tape will be lost when
        !           110: restor closes it.
        !           111: 
        !           112: 
        !           113: 
        !           114: 
        !           115: 
        !           116: 
        !           117: 
        !           118: 
        !           119: 
        !           120: 
        !           121: 
        !           122: 
        !           123: 
        !           124: 
        !           125: 
        !           126: 
        !           127: 
        !           128: 
        !           129: 
        !           130: COHERENT Lexicon                                           Page 2
        !           131: 
        !           132: 

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.