TART(1)                                                                TART(1)



NAME
       tart - filter tar files to remove unwanted members

SYNOPSIS
       tart [-1bnrv] [-O caught] [patterns]
       tart -h
       tart -V


DESCRIPTION
       The  tar program has no good way to delete member files from the aggre-
       gate archive.  Tart inspects each member file  in  an  input  tar  file
       (from stdin) coping any unrecognized members to stdout.

       All  recognized  members  are  output to the file caught in tar format.
       The two resulting files (together) contain  the  same  members  as  the
       original input file.

       The  glob  patterns  used  in the program are extended sh patterns.  In
       addition to the standard meta characters (*, ?, []) the sequence ''**''
       will match any number of any characters including a slash (/).


OPTIONS
       If the program is called as tart then no options are forced.

       -1
              Remove  each  pattern  from  the list after it matches the first
              file.

       -b
              Do not pad output files to an even multiple of 20 blocks.   This
              makes a broken tar(1) file in some cases.

       -h
              Print only a brief help message.

       -n
              Do  not  execute commands, trace only.  This is only useful with
              -v.

       -O caught
              By default the caught members are output  to  /dev/null.   These
              members  may  be  captured  in another file, caught, if they are
              useful.

       -r
              Reverse the output streams -- matches to stdout, non matches  to
              caught.

       -v
              Be  verbose,  show the index of members, their size and disposi-
              tion..

       -V
              Show version information.

EXAMPLES
       tart -O keep.tar "*.c" "*.h" "Makefile" <all.tar >bin.tar
              From all.tar divert the source files (C files  and  the  make(1)
              recipe)  to  keep.tar  leaving  any  binary  or  other  files in
              bin.tar.


       tart "**/.owners" ".owners" <mtp.tar >send.tar
              Delete any installus .owners  control  files  from  the  mtp.tar
              aggregate, put the remainnder in send.tar.


       tart -1 Makefile Makefile <src.tar | tar xf -
              Remove  up  to 2 copies of a top level Makefile from the src.tar
              file.  Any remaining copies of Makefile and all other files will
              be unpacked.


       tar cf - . | tart -r "**,v" >rcs.tar
              Create a tar file of only all the rcs(1) delta files in the cur-
              rent directory.


BUGS
       None confirmed, only some reports of breaking GNU tar files.


AUTHOR
       KS Braunsdorf, NonPlayer Character Guild
       tart swirl span-not.ksb.npcguild.org

SEE ALSO
       sh(1), tar(1), make(1), installus(8l)



                                     LOCAL                             TART(1)