Return to tar CVS log

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

Annotation of coherent/a/usr/man/COHERENT/tar, revision 1.1.1.1

1.1       root        1: 
                      2: 
                      3: tar                          Command                          tar
                      4: 
                      5: 
                      6: 
                      7: 
                      8: Tape archive manager
                      9: 
                     10: ttaarr [ccrrttuuxx[00-77bbffllmmvvwwUU] [_b_l_o_c_k_s] [_a_r_c_h_i_v_e] _f_i_l_e ...
                     11: 
                     12: tar  manipulates archives  in a  machine-independent  format con-
                     13: venient for  tape.  The  first argument  consists of at  most one
                     14: directive character, followed  by zero or more option characters.
                     15: file is  generally a file to  be placed on or  extracted from the
                     16: tape.   If a  file  is a  directory, tar  processes its  contents
                     17: recursively.  For  directives that input  from the tape,  no file
                     18: specification tells  tar to process every file  on the tape.  For
                     19: directives that  output to the tape,  no file specification tells
                     20: tar to process every file in the current directory.
                     21: 
                     22: The directives are as follows:
                     23: 
                     24: cc  Create a new tape, overwriting any old contents.
                     25: 
                     26: rr  Replace (append) the named files on the tape.
                     27: 
                     28: tt  Write a table of contents of the tape to the standard output.
                     29: 
                     30: uu  Update  the tape by replacing the named  files which are newer
                     31:    (mtime larger) than any version on the tape.
                     32: 
                     33: xx  Extract  the named files  from the tape,  overwriting existing
                     34:    files with the same  names.  tar extracts each version of each
                     35:    file, leaving the latest version at the end.
                     36: 
                     37: The options are as follows:
                     38: 
                     39: 00-77
                     40:    A single octal digit specifies  the unit on which the tape may
                     41:    be  found.  tar  concatenates this digit  to the  default tape
                     42:    name /dev/mt to form the path name accessed.
                     43: 
                     44: bb  The  next argument is a number between  one and 20, specifying
                     45:    how many  bblloocckkss are to  be written in each  tape record.  tar
                     46:    determines the  blocking factor automatically  on input.  When
                     47:    the  blocking  factor  is not  1,  the  default  tape name  is
                     48:    /dev/rmt (the raw device is used).
                     49: 
                     50: ff  The next  argument is the name of the  tape aarrcchhiivvee.  An argu-
                     51:    ment of '-' means  the standard input for input directives and
                     52:    the standard output for output directives.
                     53: 
                     54: ll  tar preserves links within the structure it writes to tape but
                     55:    breaks any  links across the boundary  of the structure.  This
                     56:    option requests that tar report all such broken links.
                     57: 
                     58: mm  Restore the mtime for each extracted file.
                     59: 
                     60: vv  Verbose flag.  If directive is t, the output for each file in-
                     61:    cludes its mode, group id,  user id, size, and mtime, in addi-
                     62: 
                     63: 
                     64: COHERENT Lexicon                                           Page 1
                     65: 
                     66: 
                     67: 
                     68: 
                     69: tar                          Command                          tar
                     70: 
                     71: 
                     72: 
                     73:    tion to  its path name.   Otherwise, tar writes  the directive
                     74:    and the path name  to the standard output for input directives
                     75:    or the  standard error for  output directives as  each file is
                     76:    processed.
                     77: 
                     78: ww  For  each file to  be processed, tar writes  the directive and
                     79:    path name to the terminal  device, then reads a line from that
                     80:    device and acts on it as follows:
                     81: 
                     82:    nn       Skip the file.
                     83:    yy       Process the file.
                     84:    xx       Exit immediately.
                     85: 
                     86:    An empty response is treated as  n, and end of file is treated
                     87:    as  x.   If  a directory  is  skipped,  all  its contents  are
                     88:    skipped.   If included,  all its  contents are  processed with
                     89:    this option.
                     90: 
                     91: UU   Non-COHERENT  systems  have  another implementation  of  this
                     92:    utility with  the following bug:  when the blocking  factor is
                     93:    not one, the last few blocks of the last record written may be
                     94:    garbage.  This  bug is described elsewhere  by other symptoms.
                     95:    This  option  says that  the  tape was  created  by the  buggy
                     96:    program, so the trailing garbage should be ignored.
                     97: 
                     98: ***** Files *****
                     99: 
                    100: /ddeevv/mmtt* -- Default tape
                    101: /ddeevv/rrmmtt* -- Default tape for blocking factor greater than one
                    102: 
                    103: ***** See Also *****
                    104: 
                    105: commands, dump, link(), restor, stat(), ustar
                    106: 
                    107: ***** Notes *****
                    108: 
                    109: Path names  must be less than 100 characters.   The m option does
                    110: not affect directories.  The  only way to extract the Nth version
                    111: of a file is with the w option.
                    112: 
                    113: If the  m option  is used  to restore the  mtime of  an extracted
                    114: file, an  incremental dump may  not dump the file.   touch can be
                    115: used to force the dump.
                    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.