From c7f38d808144e8f82805a6b84bfe48740af31b14 Mon Sep 17 00:00:00 2001 From: David Oberhollenzer Date: Sun, 5 May 2019 01:56:25 +0200 Subject: Add man pages Signed-off-by: David Oberhollenzer --- doc/gensquashfs.1 | 126 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ doc/rdsquashfs.1 | 76 ++++++++++++++++++++++++++++++++ 2 files changed, 202 insertions(+) create mode 100644 doc/gensquashfs.1 create mode 100644 doc/rdsquashfs.1 (limited to 'doc') diff --git a/doc/gensquashfs.1 b/doc/gensquashfs.1 new file mode 100644 index 0000000..3d95314 --- /dev/null +++ b/doc/gensquashfs.1 @@ -0,0 +1,126 @@ +.TH GENSQUASHFS "1" "May 2019" "generate squashfs images" "User Commands" +.SH NAME +gensquashfs \- generate squashfs images +.SH SYNOPSIS +.B gensquashfs +[\fI\,OPTIONS\/\fR] \fI\, \/\fR +.SH DESCRIPTION +The first argument is a file containing a listing of all entries to include +in the squashfs image. +.PP +The second argument is the file name of the SquashFS image to generate. +.SH OPTIONS +.TP +\fB\-\-compressor\fR, \fB\-c\fR +Select the compressor to use (defaults to 'xz'). +Run \fBgensquashfs \-\-help\fR to get a list of all available compressors. +.TP +\fB\-\-block\-size\fR, \fB\-b\fR +Block size to use for Squashfs image. +Defaults to 131072. +.TP +\fB\-\-dev\-block\-size\fR, \fB\-B\fR +Device block size to padd the image to. +Defaults to 4096. +.TP +\fB\-\-defaults\fR, \fB\-d\fR +A comma seperated list of default values for +implicitly created directories. +The following values can be set: +.TS +tab(;) allbox; +l l +l l +l l +l l +l l +rd. +\fBOption\fR;\fBDefault\fR +uid=;0 +gid=;0 +mode=;0755 +mtime=;0 +.TE +.TP +.TP +\fB\-\-force\fR, \fB\-f\fR +Overwrite the output file if it exists. +.TP +\fB\-\-quiet\fR, \fB\-q\fR +Do not print out progress reports. +.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 INPUT FILE FORMAT +The input file contains a simple, newline separated list that describe the +files to be included in the squashfs image: +.PP +.in +4n +.nf +# a comment +file [] +dir +nod +slink +pipe +sock +.fi +.in + +.TS +tab(;) allbox; +l l +l l +l l +l l +l l +l l +l l +l l +l l +rd. +;Absolute path of the entry in the image. +;T{ +Optional location of the input file. Can be specified +relative to the description file. If omitted, the +image path is used, relative to the description file. +T} +;Symlink target. +;Mode/permissions of the entry. +;Numeric user id. +;Numeric group id. +;Device type (b=block, c=character). +;Major number of a device special file. +;Minor number of a device special file. +.TE + +.PP +Example: +.PP +.in +4n +.nf +# A simple squashfs image +dir /dev 0755 0 0 +nod /dev/console 0600 0 0 c 5 1 +dir /root 0700 0 0 +dir /sbin 0755 0 0 + +# Add a file. Input is relative to this listing. +file /sbin/init 0755 0 0 ../init/sbin/init + +# Read from ./bin/bash. +# /bin is created implicitly with default attributes. +file /bin/bash 0755 0 0 +.fi +.in +.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. diff --git a/doc/rdsquashfs.1 b/doc/rdsquashfs.1 new file mode 100644 index 0000000..a4b758a --- /dev/null +++ b/doc/rdsquashfs.1 @@ -0,0 +1,76 @@ +.TH RDSQUASHFS "1" "May 2019" "inspect SquashFS filesystems" "User Commands" +.SH NAME +rdsquashfs \- tool to examine or uncompress SquashFS filesystems +.SH SYNOPSIS +.B rdsquashfs +[\fI\,OPTIONS\/\fR] \fI\,\/\fR +.SH DESCRIPTION +View or extract the contents of a squashfs image. +.PP +The following options can be used to specify what operation to perform. One +of those has to be present: +.TP +\fB\-\-list\fR, \fB\-l\fR +Produce a directory listing similar to \fBls \-l\fR for a given path in +the SquashFS image. +.TP +\fB\-\-cat\fR, \fB\-c\fR +If the specified path is a regular file in the image, extract it and dump +its contents to stdout. +.TP +\fB\-\-unpack\-path\fR, \fB\-u\fR +Unpack the specified sub directory from the image. To unpack everything, +simply specify /. +.TP +\fB\-\-describe\fR, \fB\-d\fR +Produce a file listing from the image. +.PP +The following options can be used to control the behaviour of the specified +operation: +.TP +\fB\-\-unpack\-root\fR, \fB\-p\fR +If used with \fB\-\-unpack\-path\fR, this is where the +data is unpacked to. If used with \fB\-\-describe\fR, this +is used as a prefix for the input path of +regular files. +.TP +\fB\-\-no\-dev\fR, \fB\-D\fR +Do not unpack device special files. +.TP +\fB\-\-no\-sock\fR, \fB\-S\fR +Do not unpack socket files. +.TP +\fB\-\-no\-fifo\fR, \fB\-F\fR +Do not unpack named pipes. +.TP +\fB\-\-no\-slink\fR, \fB\-L\fR +Do not unpack symbolic links. +.TP +\fB\-\-no\-empty\-dir\fR, \fB\-E\fR +Do not unpack directories that would end up +empty after applying the above rules. +.TP +\fB\-\-chmod\fR, \fB\-C\fR +Change permission flags of unpacked files to +those store in the SquashFS image. +.TP +\fB\-\-chown\fR, \fB\-O\fR +Change ownership of unpacked files to the +UID/GID set in the SquashFS image. +.TP +\fB\-\-quiet\fR, \fB\-q\fR +Do not print out progress while unpacking. +.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 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