Return to tar CVS log

Up to [Plan 9 NeXT] / lucent / sys / man / 1

Annotation of lucent/sys/man/1/tar, revision 1.1

1.1     ! root        1: .TH TAR 1
        !             2: .SH NAME
        !             3: tar \- archiver
        !             4: .SH SYNOPSIS
        !             5: .B tar
        !             6: .I key
        !             7: [
        !             8: .I file ...
        !             9: ]
        !            10: .SH DESCRIPTION
        !            11: .PP
        !            12: .I Tar
        !            13: saves and restores file trees.
        !            14: It is most often used to transport a tree of files from one
        !            15: system to another.
        !            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  c
        !            28: Create a new archive with the given files as contents.
        !            29: .TP
        !            30: .B  x
        !            31: Extract the named files from the archive.
        !            32: If a file is a directory, the directory is extracted recursively.
        !            33: Modes are restored if possible.
        !            34: If no file argument is given, extract the entire archive.
        !            35: If the archive contains multiple entries for a file,
        !            36: the latest one wins.
        !            37: .TP
        !            38: .B  t
        !            39: List all occurrences of each 
        !            40: .I file
        !            41: in the archive, or of all files if there are no
        !            42: .I file
        !            43: arguments.
        !            44: .TP
        !            45: .B  r
        !            46: The named files
        !            47: are appended to the archive.
        !            48: .PP
        !            49: The modifiers are:
        !            50: .TP
        !            51: .B  v
        !            52: (verbose)
        !            53: Print the name of each file treated
        !            54: preceded by the function letter.
        !            55: With 
        !            56: .BR t ,
        !            57: give more details about the
        !            58: archive entries.
        !            59: .TP
        !            60: .B f
        !            61: Use the next argument as the name of the archive instead of
        !            62: the default standard input (for keys
        !            63: .B x
        !            64: and
        !            65: .BR t )
        !            66: or standard output (for keys
        !            67: .B c
        !            68: and
        !            69: .BR r ).
        !            70: .TP
        !            71: .B u
        !            72: Use the next (numeric) argument as the user id for files in
        !            73: the output archive.  This is only useful when moving files to
        !            74: a non-Plan 9 system.
        !            75: .TP
        !            76: .B g
        !            77: Use the next (numeric) argument as the group id for files in
        !            78: the output archive.
        !            79: .SH EXAMPLES
        !            80: .I Tar
        !            81: can be used to copy hierarchies thus:
        !            82: .IP
        !            83: .EX
        !            84: {cd fromdir; tar c .} | {cd todir; tar x}
        !            85: .EE
        !            86: .SH SOURCE
        !            87: .B /sys/src/cmd/tar.c
        !            88: .SH SEE ALSO
        !            89: .IR ar (1),
        !            90: .IR bundle (1),
        !            91: .IR tapefs (1)
        !            92: .SH BUGS
        !            93: There is no way to ask for any but the last
        !            94: occurrence of a file.
        !            95: .br
        !            96: File path names are limited to
        !            97: 100 characters.
        !            98: .br
        !            99: The tar format allows specification of links and symbolic links,
        !           100: concepts foreign to Plan 9: they are ignored.

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