diff options
author | David Oberhollenzer <david.oberhollenzer@sigma-star.at> | 2019-06-30 23:05:48 +0200 |
---|---|---|
committer | David Oberhollenzer <david.oberhollenzer@sigma-star.at> | 2019-06-30 23:05:48 +0200 |
commit | 5a63f1d60442fc116d87e2a4d8183a681746f96b (patch) | |
tree | 2b20dffeb3782216af9a1229c2d217eac600868a /doc | |
parent | cebdcd35f09527548635c6f80a7c0ed8c7a79cf1 (diff) |
Update documentation
Signed-off-by: David Oberhollenzer <david.oberhollenzer@sigma-star.at>
Diffstat (limited to 'doc')
-rw-r--r-- | doc/tar2sqfs.1 | 23 |
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: |