NAME

       mmtarfilter - filter a tarball like dpkg does

DESCRIPTION

       usage: mmtarfilter [-h] [--path-exclude pattern] [--path-include pattern]

              [--pax-exclude  pattern] [--pax-include pattern] [--type-exclude type] [--transform
              EXPRESSION] [--strip-components NUMBER] [--idshift NUM]

       Filters a tarball on standard input by the same  rules  as  the  dpkg  --path-exclude  and
       --path-include  options  and  writes resulting tarball to standard output. See dpkg(1) for
       information on how these two options work in detail. To reuse the exact same semantics  as
       used  by  dpkg,  paths  must be given as /path and not as ./path even though they might be
       stored as such in the tarball.

       Secondly, filter out unwanted pax extended headers using --pax-exclude and  --pax-include.
       This  is  useful  in  cases  where a tool only accepts certain xattr prefixes. For example
       tar2sqfs     only     supports     SCHILY.xattr.user.*,     SCHILY.xattr.trusted.*     and
       SCHILY.xattr.security.* but not SCHILY.xattr.system.posix_acl_default.*.

       Both types of options use Unix shell-style wildcards:

              * matches everything ? matches any single character

              [seq] matches any character in seq

              [!seq] matches any character not in seq

       Thirdly,   filter   out   files   matching  a  specific  tar  archive  member  type  using
       --type-exclude. Valid type names are REGTYPE (regular file), LNKTYPE  (hardlink),  SYMTYPE
       (symlink),  CHRTYPE  (character  special),  BLKTYPE  (block special), DIRTYPE (directory),
       FIFOTYPE (fifo) or their tar format flag value (0-6, respectively).

       Fourthly, transform the path of tar members using a sed expression just as  with  GNU  tar
       --transform.

       Fifthly,  strip  leading  directory  components  off  of tar members. Just as with GNU tar
       --strip-components, tar members that have less or equal components in their path  are  not
       passed through.

       Lastly,  shift  user  id  and  group  id of each entry by the value given by the --idshift
       argument. The resulting uid or gid must not be negative.

   options:
       -h, --help
              show this help message and exit

       --path-exclude pattern
              Exclude path matching the  given  shell  pattern.  This  option  can  be  specified
              multiple times.

       --path-include pattern
              Re-include  a  pattern  after  a  previous  exclusion. This option can be specified
              multiple times.

       --pax-exclude pattern
              Exclude pax header  matching  the  given  globbing  pattern.  This  option  can  be
              specified multiple times.

       --pax-include pattern
              Re-include  a  pax header after a previous exclusion.  This option can be specified
              multiple times.

       --type-exclude type
              Exclude certain member types by their type.  Choose  types  either  by  their  name
              (REGTYPE,  LNKTYPE,  SYMTYPE,  CHRTYPE, BLKTYPE, DIRTYPE, FIFOTYPE) or by their tar
              format flag values (0-6, respectively).  This  option  can  be  specified  multiple
              times.

       --transform EXPRESSION, --xform EXPRESSION
              Use  sed  replace EXPRESSION to transform file names.  This option can be specified
              multiple times.

       --strip-components NUMBER
              Strip NUMBER leading components from file names

       --idshift NUM
              Integer value by which to shift the uid and gid of each entry