summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorDavid Oberhollenzer <david.oberhollenzer@sigma-star.at>2019-07-04 13:26:27 +0200
committerDavid Oberhollenzer <david.oberhollenzer@sigma-star.at>2019-07-04 13:42:06 +0200
commit2ed6658bbce90e89f0a4e3aba41704944f10b1f1 (patch)
treee8b60a37ab1e310a6c65c2e84b30cfc15eb8a1c5 /doc
parent6623b1fe4df1e2fceb27eff286a86cf36809b2bc (diff)
tar2sqfs: repack extended attributes into squashfs filesystem
Signed-off-by: David Oberhollenzer <david.oberhollenzer@sigma-star.at>
Diffstat (limited to 'doc')
-rw-r--r--doc/tar2sqfs.114
1 files changed, 11 insertions, 3 deletions
diff --git a/doc/tar2sqfs.1 b/doc/tar2sqfs.1
index c1cb619..3279794 100644
--- a/doc/tar2sqfs.1
+++ b/doc/tar2sqfs.1
@@ -51,6 +51,10 @@ mtime=<value>;0
.TE
.TP
.TP
+\fB\-\-no\-xattr\fR, \fB\-s\fR
+Do not copy extended attributes from archive. Default behaviour is to copy all
+extended attributes and skip the ones that cannot be encoded in SquashFS.
+.TP
\fB\-\-no\-skip\fR, \fB\-s\fR
Abort if a tar record cannot be read instead of skipping it.
.TP
@@ -76,9 +80,13 @@ older, legacy headers are not supported) and extensions like sparse files.
Hard links are currently not supported and silently converted to symlinks.
Furthermore, none of the various xattr extensions are currently implemented.
-If any unsupported section is encountered in an archive a warning message is
-written to stderr. If the \fB\-\-no\-skip\fR option is set, processing aborts.
-By default, the unknown section is simply skipped after issuing a warning.
+Extended attributes are supported through the SCHILY.xattr PAX extension
+(favoured by GNU tar and star) or through the LIBARCHIVE.xattr PAX extension.
+
+If any unsupported section or extended attribute key is encountered in an
+archive a warning message is written to stderr. If the \fB\-\-no\-skip\fR
+option is set, processing aborts. By default, unknown sections and unsupported
+extended attributes are simply skipped after issuing a warning.
.SH EXAMPLES
.TP
Turn an uncompressed tar archive into a squashfs image: