summaryrefslogtreecommitdiff
path: root/doc/tar2sqfs.1
diff options
context:
space:
mode:
authorDavid Oberhollenzer <david.oberhollenzer@sigma-star.at>2019-06-30 23:05:48 +0200
committerDavid Oberhollenzer <david.oberhollenzer@sigma-star.at>2019-06-30 23:05:48 +0200
commit5a63f1d60442fc116d87e2a4d8183a681746f96b (patch)
tree2b20dffeb3782216af9a1229c2d217eac600868a /doc/tar2sqfs.1
parentcebdcd35f09527548635c6f80a7c0ed8c7a79cf1 (diff)
Update documentation
Signed-off-by: David Oberhollenzer <david.oberhollenzer@sigma-star.at>
Diffstat (limited to 'doc/tar2sqfs.1')
-rw-r--r--doc/tar2sqfs.123
1 files changed, 12 insertions, 11 deletions
diff --git a/doc/tar2sqfs.1 b/doc/tar2sqfs.1
index 61c6b47..c43e412 100644
--- a/doc/tar2sqfs.1
+++ b/doc/tar2sqfs.1
@@ -62,18 +62,19 @@ Print help text and exit.
.TP
\fB\-\-version\fR, \fB\-V\fR
Print version information and exit.
-.SH LIMITATIONS
-Currently the tool can only process POSIX tar archives with pax extensions, so
-you need to tell your tool that generates the tar ball to not use any other
-extensions.
+.SH COMPATIBILITY
+The tool is designed to support a broad variety of commonly used tar archives.
+Currently the tool can process v7 format, pre-POSIX ustar, POSIX tar and GNU
+tar archives. PAX extension headers are supported.
-For GNU tar, this can be done with the flag \fB\-\-posix\fR:
-.IP
-tar cf file.tar \-\-posix bin/ lib/ etc/ usr/
-.TP
-Furthermore, hard links and sparse files are currently not supported. If any
-unsupported section is encountered in a tar archive, the section is skipped and
-a warning message is written to stderr.
+The support for GNU tar is limited to commonly used header formats (i.e. some
+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, the section is skipped
+and a warning message is written to stderr.
.SH EXAMPLES
.TP
Turn an uncompressed tar archive into a squashfs image: