From ceb86b571c1cabf2a0890603b140a1af99912fd9 Mon Sep 17 00:00:00 2001 From: David Oberhollenzer Date: Wed, 27 May 2020 14:57:48 +0200 Subject: Cleanup: move man pages to the respective program source directories Signed-off-by: David Oberhollenzer --- bin/gensquashfs/gensquashfs.1 | 201 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 201 insertions(+) create mode 100644 bin/gensquashfs/gensquashfs.1 (limited to 'bin/gensquashfs') diff --git a/bin/gensquashfs/gensquashfs.1 b/bin/gensquashfs/gensquashfs.1 new file mode 100644 index 0000000..9ef4ee8 --- /dev/null +++ b/bin/gensquashfs/gensquashfs.1 @@ -0,0 +1,201 @@ +.TH GENSQUASHFS "1" "June 2019" "generate squashfs images" "User Commands" +.SH NAME +gensquashfs \- generate squashfs images +.SH SYNOPSIS +.B gensquashfs +[\fI\,OPTIONS\/\fR] \/\fR +.SH DESCRIPTION +Generate a SquashFS image. +.SH OPTIONS +.TP +\fB\-\-pack\-file\fR, \fB\-F\fR +Use a \fBgen_init_cpio\fR style description file. The file format is specified +below. If \fB\-\-pack\-dir\fR is used, input file paths are relative to the +pack directory, otherwise they are relative to the directory the pack file +is in. +.TP +\fB\-\-pack\-dir\fR, \fB\-D\fR +If \fB\-\-pack\-file\fR is used, this is the root path relative to which to +read files. If no pack file is specified, pack the contents of the given +directory into a SquashFS image. The directory becomes the root of the file +system. +.TP +\fB\-\-compressor\fR, \fB\-c\fR +Select the compressor to use. +Run \fBgensquashfs \-\-help\fR to get a list of all available compressors +and the default selection. +.TP +\fB\-\-comp\-extra\fR, \fB\-X\fR +A comma separated list of extra options for the selected compressor. Specify +\fBhelp\fR to get a list of available options. +.TP +\fB\-\-num\-jobs\fR, \fB\-j\fR +If libsquashfs was compiled with a built in thread pool based, parallel data +compressor, this option can be used to set the number of compressor +threads. If not set, the default is the number of available CPU cores. +.TP +\fB\-\-queue\-backlog\fR, \fB\-Q\fR +Maximum number of data blocks in the thread worker queue before the packer +starts waiting for the block processors to catch up. Higher values result +in higher memory consumption. Defaults to 10 times the number of workers. +.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\-\-keep\-time\fR, \fB\-k\fR +When using \fB\-\-pack\-dir\fR only, use the timestamps from the input files +instead of setting defaults on all input paths. The root inode and the +modification time on the SquashFS image itself will still be set to defaults. +.TP +\fB\-\-one\-file\-system\fR, \fB\-o\fR +When using \fB\-\-pack\-dir\fR only, stay in the local filesystem and do not +cross mount points. +.TP +\fB\-\-defaults\fR, \fB\-d\fR +A comma separated 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=;\fB$SOURCE\_DATE\_EPOCH\fR if set, 0 otherwise +.TE +.TP +.TP +\fB\-\-set\-uid\fR, \fB\-u\fR +Force the owners user ID for ALL inodes to this value, no matter what the pack +file or directory entries actually specify. +.TP +\fB\-\-set\-gid\fR, \fB\-g\fR +Force the owners group ID for ALL inodes to this value, no matter what the pack +file or directory entries actually specify. +.TP +\fB\-\-all\-root\fR +A short hand for `\-\-set\-uid 0 \-\-set\-gid 0`. +.TP +\fB\-\-selinux\fR, \fB\-s\fR +If built with SELinux support, use the given SELinux label file to add context +labels to the elements packed into the SquashFS image. +.TP +\fB\-\-exportable\fR, \fB\-e\fR +Generate an export table for NFS support. +.TP +\fB\-\-no\-tail\-packing\fR, \fB\-T\fR +Do not perform tail end packing on files that are larger than the specified +block size. +.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 +link +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. +;T{ +Absolute path of the entry in the image. Can be put in quotes +if some components contain spaces. +T} +;T{ +Optional location of the input file. Can be specified relative to either the +description file or the pack directory. If omitted, the image path is used +as a relative path. +T} +;Symlink or hardlink 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 pack dir or listing path +file /sbin/init 0755 0 0 ../init/sbin/init + +# Read from ./bin/bash relative to pack dir or listing path +# /bin is created implicitly with default attributes. +file /bin/bash 0755 0 0 + +# file name with a space in it and a "special" name +file "/opt/my app/\\"special\\"/data" 0600 0 0 +.fi +.in +.SH ENVIRONMENT +If the command line switch \fB\-\-defaults\fR is not used or no default mtime +is specified, the value of the environment variable \fBSOURCE\_DATE\_EPOCH\fR +is used for all file and filesystem timestamps. + +If \fBSOURCE\_DATE\_EPOCH\fR is not set, not a parsable number or it is out of +range, the timestamps default to 0. + +Environment variables are only used if no explicit command line switches +are set. Explicit command line switches are always preferred over the +environment variables. +.SH SEE ALSO +rdsquashfs(1), tar2sqfs(1) +.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