sqsh-stat.1.in

.TH sqsh-stat 1 "March 17, 2023" "Version @VERSION@" "User Commands"

.SH NAME
sqsh-stat \- display metainformation about files, directories and the 
filesystem itself in a squashfs archive.

.SH SYNOPSIS
.B sqsh-stat
[\fB-o\fR \fIOFFSET\fR]
\fIFILESYSTEM\fR
[\fIPATH ...\fR]
.br
.B sqsh-stat
[\fB-v\fR]

.SH DESCRIPTION
.B sqsh-stat
is a tool that displays metainformation about files, directories and 
the filesystem itself in a squashfs archive. 

If no \fIPATH\fR is specified, it displays information about the 
filesystem itself, including the superblock information, number of 
inodes, file size, compression type, and creation time.

If one or more \fIPATH\fR arguments are given, it displays 
metainformation about each of the specified paths, including the path's 
inode number, mode, ownership, size, creation time, and compression 
type.

.SH OPTIONS
.TP
.BR \-o " " \fIOFFSET\fR ", " \-\-offset " " \fIOFFSET\fR
skip OFFSET bytes at start of FILESYSTEM.

.TP
.BR \-v ", " \-\-version
Print the version of \fBsqsh-stat\fR and exit.

.SH ARGUMENTS
.TP
.BR FILESYSTEM
The path to the squashfs archive to display metainformation from.

.TP
.BR PATH
Optional. One or more paths within the archive to display 
metainformation about.

.SH EXIT STATUS
The \fBsqsh-stat\fR command exits with 0 on success, and non-zero on 
failure.

.SH EXAMPLES
To display information about the squashfs archive itself:

.BR sqsh-stat " " /path/to/filesystem.sqsh

To display information about a specific path within the squashfs 
archive:

.BR sqsh-stat " " /path/to/filesystem.sqsh " " /path/to/file

To display information about multiple paths within the squashfs archive:

.BR sqsh-stat " " /path/to/filesystem.sqsh " " /path/to/file1 " "/path/to/dir/

To print the version of \fBsqsh-stat\fR:

.BR sqsh-stat " " -v

.SH SEE ALSO
.BR sqsh-cat (1),
.BR sqsh-ls (1),
.BR sqsh-mount (1),
.BR sqsh-unpack (1),
.BR sqsh-xattr (1),
.BR squashfs (5)

.SH AUTHOR
Written by Enno Boland.

.SH COPYRIGHT
Copyright (C) 2023 Enno Boland. This is free software; see the source 
for copying conditions. There is NO warranty; not even for 
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.