From 46b30ac7559ca26f5446b05d852eaaefe432a290 Mon Sep 17 00:00:00 2001 From: David Oberhollenzer Date: Thu, 13 Jun 2019 15:45:10 +0200 Subject: Add man page for sqfs2tar Signed-off-by: David Oberhollenzer --- doc/Makemodule.am | 2 +- doc/sqfs2tar.1 | 50 ++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 51 insertions(+), 1 deletion(-) create mode 100644 doc/sqfs2tar.1 (limited to 'doc') diff --git a/doc/Makemodule.am b/doc/Makemodule.am index 6b31eec..5141be5 100644 --- a/doc/Makemodule.am +++ b/doc/Makemodule.am @@ -1 +1 @@ -dist_man1_MANS += doc/gensquashfs.1 doc/rdsquashfs.1 +dist_man1_MANS += doc/gensquashfs.1 doc/rdsquashfs.1 doc/sqfs2tar.1 diff --git a/doc/sqfs2tar.1 b/doc/sqfs2tar.1 new file mode 100644 index 0000000..a999dff --- /dev/null +++ b/doc/sqfs2tar.1 @@ -0,0 +1,50 @@ +.TH SQFS2TAR "1" "June 2019" "sqfs2tar" "User Commands" +.SH NAME +sqfs2tar \- turn a squashfs image into a tar archive +.SH SYNOPSIS +.B sqfs2tar +[\fI\,OPTIONS\/\fR...] \fI\,\/\fR +.SH DESCRIPTION +Read a squashfs archive and turn it into a tar archive, written to stdout. + +The idea is to quickly and painlessly turn a squashfs filesystem image into +a tar archive that can then be examined and processed by any tool that can +work on tar archives. +.PP +Possible options: +.TP +\fB\-\-help\fR, \fB\-h\fR +Print help text and exit. +.TP +\fB\-\-version\fR, \fB\-V\fR +Print version information and exit. +.SH LIMITATIONS +To be compatible with as many tools as possible, the output format is POSIX tar +using pax extensions if necessary, so the tools you intend to use should +support the pax format. + +It is not possible to store socket files in a tar or pax archive. Also, in the +current implementation, all extended attribuates are lost. + +If any file or directory is encountered that cannot be converted, it is +skipped and a warning is written to stderr. +.SH EXAMPLES +Turn a squashfs image into a tar archive: +.IP +sqfs2tar rootfs.sqfs > rootfs.tar +.TP +Turn a squashfs image into a gzip'ed tar archive: +.IP +sqfs2tar rootfs.sqfs | gzip > rootfs.tar.gz +.TP +Turn a squashfs image into an LZMA2 compressed tar archive: +.IP +sqfs2tar rootfs.sqfs | xz > rootfs.tar.xz +.SH AUTHOR +Written by David Oberhollenzer. +.SH COPYRIGHT +Copyright \(co 2019 David Oberhollenzer +License GPLv3+: GNU GPL version 3 or later . +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. -- cgit v1.2.3