.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH MMTARFILTER "1" "March 2023" "mmtarfilter 1.3.3" "User Commands"
.SH NAME
mmtarfilter \- filter a tarball like dpkg does
.SH DESCRIPTION
usage: mmtarfilter [\-h] [\-\-path\-exclude pattern] [\-\-path\-include pattern]
.IP
[\-\-pax\-exclude pattern] [\-\-pax\-include pattern]
[\-\-transform EXPRESSION] [\-\-strip\-components NUMBER]
[\-\-idshift NUM]
.PP
Filters a tarball on standard input by the same rules as the dpkg \fB\-\-path\-exclude\fR
and \fB\-\-path\-include\fR 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 \fI\,/path\/\fP and not as
\&./path even though they might be stored as such in the tarball.
.PP
Secondly, filter out unwanted pax extended headers. 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.*.
.PP
Both types of options use Unix shell\-style wildcards:
.IP
* matches everything
? matches any single character
.IP
[seq] matches any character in seq
.IP
[!seq] matches any character not in seq
.PP
Thirdly, transform the path of tar members using a sed expression just as with
GNU tar \fB\-\-transform\fR.
.PP
Fourthly, strip leading directory components off of tar members. Just as with
GNU tar \fB\-\-strip\-components\fR, tar members that have less or equal components in
their path are not passed through.
.PP
Lastly, shift user id and group id of each entry by the value given by the
\fB\-\-idshift\fR argument. The resulting uid or gid must not be negative.
.SS "options:"
.TP
\fB\-h\fR, \fB\-\-help\fR
show this help message and exit
.TP
\fB\-\-path\-exclude\fR pattern
Exclude path matching the given shell pattern. This
option can be specified multiple times.
.TP
\fB\-\-path\-include\fR pattern
Re\-include a pattern after a previous exclusion. This
option can be specified multiple times.
.TP
\fB\-\-pax\-exclude\fR pattern
Exclude pax header matching the given globbing
pattern. This option can be specified multiple times.
.TP
\fB\-\-pax\-include\fR pattern
Re\-include a pax header after a previous exclusion.
This option can be specified multiple times.
.TP
\fB\-\-transform\fR EXPRESSION, \fB\-\-xform\fR EXPRESSION
Use sed replace EXPRESSION to transform file names.
This option can be specified multiple times.
.TP
\fB\-\-strip\-components\fR NUMBER
Strip NUMBER leading components from file names
.TP
\fB\-\-idshift\fR NUM
Integer value by which to shift the uid and gid of
each entry