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

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.