tar - Tar file creation, extraction & manipulation
Note: Starting with version 0.8 the tar reader commands (contents, stats, get, untar) support the GNU LongName extension (header type 'L') for large paths.
For all commands, when using -chan ...
It is assumed that the channel was opened for reading, and configured for binary input.
It is assumed that the channel position is at the beginning of a legal tar file.
The commands will modify the channel position as they perform their task.
The commands will not close the channel.
In other words, the commands leave the channel in a state very likely unsuitable for use by further tar commands. Still doing so will very likely results in errors, bad data, etc. pp.
It is the responsibility of the user to seek the channel back to a suitable position.
When using a channel transformation which is not generally seekable, for example gunzip, then it is the responsibility of the user to (a) unstack the transformation before seeking the channel back to a suitable position, and (b) for restacking it after.
Returns a list of the files contained in tarball. The order is not sorted and depends on the order files were stored in the archive.
If the option -chan is present tarball is interpreted as an open channel. It is assumed that the channel was opened for reading, and configured for binary input. The command will not close the channel.
Returns a nested dict containing information on the named ?file? in tarball, or all files if none is specified. The top level are pairs of filename and info. The info is a dict with the keys "mode uid gid size mtime type linkname uname gname devmajor devminor"
% ::tar::stat tarball.tar
foo.jpg {mode 0644 uid 1000 gid 0 size 7580 mtime 811903867 type file linkname {} uname user gname wheel devmajor 0 devminor 0}
If the option -chan is present tarball is interpreted as an open channel. It is assumed that the channel was opened for reading, and configured for binary input. The command will not close the channel.
Extracts tarball. -file and -glob limit the extraction to files which exactly match or pattern match the given argument. No error is thrown if no files match. Returns a list of filenames extracted and the file size. The size will be null for non regular files. Leading path seperators are stripped so paths will always be relative.
% foreach {file size} [::tar::untar tarball.tar -glob *.jpg] {
puts "Extracted $file ($size bytes)"
}
Returns the contents of fileName from the tarball.
% set readme [::tar::get tarball.tar doc/README] {
% puts $readme
}
If the option -chan is present tarball is interpreted as an open channel. It is assumed that the channel was opened for reading, and configured for binary input. The command will not close the channel.
An error is thrown when fileName is not found in the tar archive.
Creates a new tar file containing the files. files must be specified as a single argument which is a proper list of filenames.
% ::tar::create new.tar [glob -nocomplain file*] % ::tar::contents new.tar file1 file2 file3
Appends files to the end of the existing tarball. files must be specified as a single argument which is a proper list of filenames.
Removes files from the tarball. No error will result if the file does not exist in the tarball. Directory write permission and free disk space equivalent to at least the size of the tarball will be needed.
% ::tar::remove new.tar {file2 file3}
% ::tar::contents new.tar
file3
This document, and the package it describes, will undoubtedly contain bugs and other problems. Please report such in the category tar of the Tcllib Trackers. Please also report any ideas for enhancements you may have for either package and/or documentation.
When proposing code changes, please provide unified diffs, i.e the output of diff -u.
Note further that attachments are strongly preferred over inlined patches. Attachments can be made by going to the Edit form of the ticket immediately after its creation, and then using the left-most button in the secondary navigation bar.
File formats