tttar(1)tttar(1)NAMEtttar - (de)archive files and ToolTalk objects
SYNOPSIStttar {c|t|x} [ fhpv ] [ tarfile ] pathname ...
tttar {c|t|x} fL [ hpRv ] tttarfile [[ -rename oldname newname ] ... ]
pathname ...
tttar-v
tttar -h[elp]
DESCRIPTIONtttar has two fundamentally different modes. Without the L function
modifier, tttar acts as a ToolTalk-aware wrapper for tar(1), archiving
(or extracting) multiple files and their TT objects onto (or from) a
single archive, called a tarfile. With the L function modifier, tttar
does not invoke tar to archive actual files, but instead archives (or
extracts) only TT objects onto (or from) a single archive, called a
tttarfile. Since without the L function modifier tttar acts like an TT-
aware tar(1), the discussion below will be phrased as if the L function
modifier is in effect. That is, we will refer to tttarfiles instead of
tarfiles, and we will discuss (de)archiving only "the TT objects of the
named files" rather than (de)archiving both "the named files and their TT
objects".
tttar's actions are controlled by the first argument, the key, a string
of characters containing exactly one function letter from the set ctx,
and one or more of the optional function modifiers listed below. Other
arguments to tttar are file or directory names that specify which files
to archive or extract TT objects for. By default, the appearance of a
directory name refers recursively to the files and subdirectories of that
directory.
FUNCTION LETTERS
c Create a new tttarfile and write the TT objects of the named files
onto it.
t List the table of contents of the tttarfile.
x Extract the TT objects of the named files from the tttarfile. If a
named file matches a directory with contents written onto the tape,
this directory is (recursively) extracted. The owner and
modification time of the TT objects are restored (if possible). If
no filename arguments are given, the TT objects of all files named
in the archive are extracted.
FUNCTION MODIFIERS
f Use the next argument as the name of the tttarfile. If tttarfile is
given as `-', tttar writes to the standard output or reads from the
standard input, whichever is appropriate.
Page 1
tttar(1)tttar(1)
h Follow symbolic links as if they were normal files or directories.
Normally, tttar does not follow symbolic links.
p Preserve. Restore the named files to their original modes, ignoring
the present umask(2). SetUID and sticky information are also
extracted if you are the super-user. This option is only useful
with the x function letter, and has no meaning if the L function
letter is given.
L Do not invoke tar(1). Must be used with the f function modifier,
since reading and writing an tttar archive directly to or from
magnetic tape is unimplemented.
R Do not recurse into directories. Valid only with the L function
modifier.
v Verbose. Normally tttar does its work silently; this option
displays the name of each file tttar treats, preceded by the
function letter.
OPTIONS-rename
Takes the next two arguments as an oldname and a newname,
respectively, and renames any entry archived as oldname to newname.
If oldname is a directory, then its entries are recursively renamed,
as well. If more than one -rename option applies to an entry
(because of 1 or more parent directories being renamed), the most
specific -rename option applies. The -rename option is only allowed
with the L function modifier.
-h Print usage information for tttar.
-v Print the version of tttar.
FILES
/mountpoint/TT_DB This directory is used as a database for the
ToolTalk objects of files in the filesystem
mounted at /mountpoint.
SEE ALSOtar(1), ttcopy(1), ttsession(1), ttdbck(8)BUGS
When extracting from a tar archive that is given to tttar either on
magnetic tape or on the standard input, the current working directory
must be writable, so that the tttarfile can be placed there temporarily.
Writing and reading tttarfiles (i.e., archives produced with the L
function modifier) directly to and from magnetic tape is unimplemented.
Page 2
tttar(1)tttar(1)
The r and u function letters of tar(1), for incrementally updating an
archive, are not supported.
The X and F function modifiers and the -I option of tar(1), for including
or excluding files from being archived based on SCCS status or being
listed in a special file, are not supported.
The w function modifier and the -C option of tar(1), for pausing or
changing directories between the files listed on the command line, are
not supported.
A file does not have to exist for an TT object to be associated with its
pathname. When tttar descends into a directory, it does not attempt to
archive the objects associated with any files that do not exist in the
directory.
Page 3