3 cfa37a7b 2004-04-10 devnull tar \- archiver
4 cfa37a7b 2004-04-10 devnull .SH SYNOPSIS
8 cfa37a7b 2004-04-10 devnull .I file ...
10 cfa37a7b 2004-04-10 devnull .SH DESCRIPTION
13 cfa37a7b 2004-04-10 devnull saves and restores file trees.
14 cfa37a7b 2004-04-10 devnull It is most often used to transport a tree of files from one
15 cfa37a7b 2004-04-10 devnull system to another.
18 cfa37a7b 2004-04-10 devnull is a string that contains
19 cfa37a7b 2004-04-10 devnull at most one function letter plus optional modifiers.
20 cfa37a7b 2004-04-10 devnull Other arguments to the command are names of
21 cfa37a7b 2004-04-10 devnull files or directories to be dumped or restored.
22 cfa37a7b 2004-04-10 devnull A directory name implies all the contained
23 cfa37a7b 2004-04-10 devnull files and subdirectories (recursively).
25 cfa37a7b 2004-04-10 devnull The function is one of the following letters:
28 cfa37a7b 2004-04-10 devnull Create a new archive with the given files as contents.
31 cfa37a7b 2004-04-10 devnull Extract the named files from the archive.
32 cfa37a7b 2004-04-10 devnull If a file is a directory, the directory is extracted recursively.
33 cfa37a7b 2004-04-10 devnull Modes are restored if possible.
34 cfa37a7b 2004-04-10 devnull If no file argument is given, extract the entire archive.
35 cfa37a7b 2004-04-10 devnull If the archive contains multiple entries for a file,
36 cfa37a7b 2004-04-10 devnull the latest one wins.
39 cfa37a7b 2004-04-10 devnull List all occurrences of each
41 cfa37a7b 2004-04-10 devnull in the archive, or of all files if there are no
43 cfa37a7b 2004-04-10 devnull arguments.
46 cfa37a7b 2004-04-10 devnull The named files
47 cfa37a7b 2004-04-10 devnull are appended to the archive.
49 cfa37a7b 2004-04-10 devnull The modifiers are:
52 cfa37a7b 2004-04-10 devnull (verbose)
53 cfa37a7b 2004-04-10 devnull Print the name of each file treated
54 cfa37a7b 2004-04-10 devnull preceded by the function letter.
57 cfa37a7b 2004-04-10 devnull give more details about the
58 cfa37a7b 2004-04-10 devnull archive entries.
61 cfa37a7b 2004-04-10 devnull Use the next argument as the name of the archive instead of
62 cfa37a7b 2004-04-10 devnull the default standard input (for keys
66 cfa37a7b 2004-04-10 devnull or standard output (for keys
72 cfa37a7b 2004-04-10 devnull Use the next (numeric) argument as the user id for files in
73 cfa37a7b 2004-04-10 devnull the output archive. This is only useful when moving files to
74 cfa37a7b 2004-04-10 devnull a non-Plan 9 system.
77 cfa37a7b 2004-04-10 devnull Use the next (numeric) argument as the group id for files in
78 cfa37a7b 2004-04-10 devnull the output archive.
81 cfa37a7b 2004-04-10 devnull Create archive in POSIX ustar format,
82 cfa37a7b 2004-04-10 devnull which raises the maximum pathname length from 100 to 256 bytes.
83 cfa37a7b 2004-04-10 devnull Ustar archives are recognised automatically by
85 cfa37a7b 2004-04-10 devnull when reading archives.
88 cfa37a7b 2004-04-10 devnull When extracting, ignore leading slash on file names,
89 cfa37a7b 2004-04-10 devnull i.e., extract all files relative to the current directory.
92 cfa37a7b 2004-04-10 devnull Modifies the behavior of
94 cfa37a7b 2004-04-10 devnull to set the mode and modified time
95 cfa37a7b 2004-04-10 devnull of each file to that specified in the archive.
96 cfa37a7b 2004-04-10 devnull .SH EXAMPLES
98 cfa37a7b 2004-04-10 devnull can be used to copy hierarchies thus:
101 cfa37a7b 2004-04-10 devnull @{cd fromdir && tar cp .} | @{cd todir && tar xT}
103 cfa37a7b 2004-04-10 devnull .SH SOURCE
104 b5fdffee 2004-04-19 devnull .B /usr/local/plan9/src/cmd/tar.c
105 cfa37a7b 2004-04-10 devnull .SH SEE ALSO
106 cfa37a7b 2004-04-10 devnull .IR ar (1),
107 cfa37a7b 2004-04-10 devnull .IR bundle (1),
108 cfa37a7b 2004-04-10 devnull .IR tapefs (1)
109 cfa37a7b 2004-04-10 devnull .SH BUGS
110 cfa37a7b 2004-04-10 devnull There is no way to ask for any but the last
111 cfa37a7b 2004-04-10 devnull occurrence of a file.
113 cfa37a7b 2004-04-10 devnull File path names are limited to
114 cfa37a7b 2004-04-10 devnull 100 characters
115 cfa37a7b 2004-04-10 devnull (256 when using ustar format).
117 cfa37a7b 2004-04-10 devnull The tar format allows specification of links and symbolic links,
118 cfa37a7b 2004-04-10 devnull concepts foreign to Plan 9: they are ignored.