tttar(1)

NAME
     tttar - (de)archive files and ToolTalk objects

SYNOPSIS
     tttar {c|t|x} [ fhpv ] [ tarfile ] pathname ...

     tttar {c|t|x} fL [ hpRv ] tttarfile [[ -rename oldname newname ] ...  ]
     pathname ...

     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), 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.

     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.