NAME

tttar − (de)archive files and ToolTalk objects

SYNOPSIS

tttar c|t|x [ EfhpSv ] [ tarfile ] pathname1 pathname2 ...

tttar c|t|x fL [ EhpRSv ] tttarfile [[ -rename oldname newname ] ... ] pathname1 pathname2 ...

tttar -v

tttar -h[elp]

DESCRIPTION

tttar 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. 

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 ALSO

tar(1), ttcp(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. 

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. 

SunOS 5.2  —  Last change: 21 May 1991