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     ! 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.