Return to tar.1 CVS log

Up to [Research Unix] / researchv10dc / man / adm / man1

Annotation of researchv10dc/man/adm/man1/tar.1, revision 1.1.1.1

1.1       root        1: .TH TAR 1
                      2: .CT 1 comm_dev
                      3: .SH NAME
                      4: tar \- tape archiver
                      5: .SH SYNOPSIS
                      6: .B tar
                      7: .I key
                      8: [
                      9: .I file ...
                     10: ]
                     11: .SH DESCRIPTION
                     12: .PP
                     13: .I Tar
                     14: saves and restores files, normally on magnetic
                     15: on tape.
                     16: The
                     17: .I key
                     18: is a string that contains
                     19: at most one function letter plus optional modifiers.
                     20: Other arguments to the command are names of
                     21: files or directories to be dumped or restored.
                     22: A directory name implies all the contained
                     23: files and subdirectories (recursively).
                     24: .PP
                     25: The function is one of the following letters:
                     26: .TP
                     27: .B  r
                     28: The named files
                     29: are written
                     30: on the end of the tape.
                     31: .TP
                     32: .B  x
                     33: Extract the named files from the tape.
                     34: If a file is a directory, the directory is extracted recursively.
                     35: Owners and modes are restored if possible.
                     36: If no file argument is given, extract the entire tape.
                     37: If the tape contains multiple entries for a file,
                     38: the latest one wins.
                     39: .TP
                     40: .B  t
                     41: List all occurrences of each 
                     42: .I file
                     43: on tape, or of all files if there are no
                     44: .I file
                     45: arguments.
                     46: .TP
                     47: .B  u
                     48: Add the named files if they
                     49: are not on the tape or are newer than the tape version.
                     50: .TP
                     51: .B  c
                     52: Create a new tape; writing begins at the beginning
                     53: of the tape instead of after the last file.
                     54: .TP
                     55: .B  o
                     56: Omit owner and modes
                     57: of directories, for compatibility with
                     58: old versions of
                     59: .I tar.
                     60: .TP
                     61: .B  p
                     62: Restore files to their original modes,
                     63: ignoring the present
                     64: .IR umask (2).
                     65: Setuid and sticky information
                     66: will be restored when
                     67: .IR tar
                     68: is executed by the super-user.
                     69: .PP
                     70: The modifiers are:
                     71: .TP
                     72: .BR  0 ,..., 7
                     73: Select a tape drive.
                     74: The default is
                     75: .BR 1 .
                     76: Incompatible with modifier
                     77: .BR f .
                     78: .TP
                     79: .B  v
                     80: (verbose)
                     81: Print the name of each file treated
                     82: preceded by the function letter.
                     83: With 
                     84: .BR t ,
                     85: give more details about the
                     86: tape entries.
                     87: .TP
                     88: .B  w
                     89: Print the action to be taken followed by file name, then
                     90: wait for user confirmation.
                     91: If the answer begins with
                     92: .LR y ,
                     93: the action is performed.
                     94: Any other input means
                     95: don't do it.
                     96: .TP
                     97: .B f
                     98: Use the next argument as the name of the archive instead of
                     99: the default
                    100: .F /dev/rmt1 .
                    101: If the name of the file is 
                    102: .LR - ,
                    103: tar writes to
                    104: standard output or reads from standard input, whichever is
                    105: appropriate.
                    106: .I Tar
                    107: can be used to move hierarchies thus:
                    108: .IP
                    109: .L
                    110:        (cd fromdir; tar cf - .) | (cd todir; tar xf -)
                    111: .TP
                    112: .BI b 
                    113: Write output in
                    114: .IR n \(mu512-byte
                    115: blocks, where
                    116: .I n
                    117: is the next argument,
                    118: default 20, maximum 40.
                    119: Useful for raw magnetic tape archives (see
                    120: .B f
                    121: above); destructive for disk archives.
                    122: .TP
                    123: .B l
                    124: Complain if links cannot be resolved.
                    125: If
                    126: .B l
                    127: is not specified, no
                    128: error messages are printed.
                    129: .TP
                    130: .B L
                    131: Write information needed to re-create symbolic links
                    132: on the tape instead of following the links.
                    133: Tapes thus written cannot be read on older versions of
                    134: .I tar .
                    135: .SH FILES
                    136: .F /dev/rmt?
                    137: .br
                    138: .F /tmp/tar*
                    139: .SH SEE ALSO
                    140: .IR cpio (1),
                    141: .IR bundle (1),
                    142: .IR mt (4)
                    143: .SH BUGS
                    144: There is no way to ask for any but the last
                    145: occurrence of a file.
                    146: .br
                    147: Tape errors are handled ungracefully.
                    148: .br
                    149: The
                    150: .B u
                    151: option can be slow, and works only with archives on disk files.
                    152: .br
                    153: File names are limited to
                    154: 100 characters.

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