13 saves and restores file trees.
14 It is most often used to transport a tree of files from one
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).
25 The function is one of the following letters:
28 Create a new archive with the given files as contents.
32 are appended to the archive.
35 List all occurrences of each
37 in the archive, or of all files if there are no
42 Extract the named files from the archive.
43 If a file is a directory, the directory is extracted recursively.
44 Modes are restored if possible.
45 If no file argument is given, extract the entire archive.
46 If the archive contains multiple entries for a file,
52 Use the next argument as the name of the archive instead of
53 the default standard input (for keys
57 or standard output (for keys
63 Use the next (numeric) argument as the group id for files in
68 Modifies the behavior of
70 not to extract files which already exist.
73 Do not set the modification time on extracted files.
74 This is the default behavior; the flag exists only for compatibility with other tars.
77 Create archive in POSIX ustar format,
78 which raises the maximum pathname length from 100 to 256 bytes.
79 Ustar archives are recognised automatically by
81 when reading archives.
82 This is the default behavior; the flag exists only for backwards compatibility
83 with older versions of tar.
86 Do not generate the POSIX ustar format.
89 When extracting, ignore leading slash on file names,
90 i.e., extract all files relative to the current directory.
93 Modifies the behavior of
95 to set the modified time
96 of each file to that specified in the archive.
99 Use the next (numeric) argument as the user id for files in
100 the output archive. This is only useful when moving files to
105 Print the name of each file treated
106 preceded by the function letter.
109 give more details about the
113 Operate on compressed tar archives.
114 The type of compression is inferred from the file name extension:
135 If no extension matches,
140 flag is unnecessary (but allowed) when using the
144 verbs on archives with recognized extensions.
147 can be used to copy hierarchies thus:
150 @{cd fromdir && tar cp .} | @{cd todir && tar xT}
160 There is no way to ask for any but the last
161 occurrence of a file.
163 File path names are limited to
165 (256 when using ustar format).
167 The tar format allows specification of links and symbolic links,
168 concepts foreign to Plan 9: they are ignored.