.\" generated with Ronn-NG/v0.10.1
.\" http://github.com/apjanke/ronn-ng/tree/0.10.1
.TH "DWARFSCK" "1" "April 2024" ""
.SH "NAME"
\fBdwarfsck\fR \- check DwarFS image
.SH "SYNOPSIS"
\fBdwarfsck\fR [\fB\-i\fR] \fIimage\fR [\fIoptions\fR\|\.\|\.\|\.]
.SH "DESCRIPTION"
\fBdwarfsck\fR will perform a check of a DwarFS filesystem image\.
.P
If successful, it will show details about the filesystem depending on the detail level specified\. If an error is found, it will exit with a non\-zero exit code\.
.SH "OPTIONS"
.TP
\fB\-i\fR, \fB\-\-input=\fR\fIfile\fR
Path to the filesystem image\.
.TP
\fB\-d\fR, \fB\-\-detail=\fR\fIvalue\fR
Level of filesystem information detail\. The default is 2\. Higher values mean more output\. Values larger than 6 will currently not provide any further detail\.
.TP
\fB\-q\fR, \fB\-\-quiet\fR
Don't produce any output unless there is an error\.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
Produce verbose output, where applicable\.
.TP
\fB\-O\fR, \fB\-\-image\-offset=\fR\fIvalue\fR|\fBauto\fR
Specify the byte offset at which the filesystem is located in the image\. Use \fBauto\fR to detect the offset automatically\. This is also the default\. This is only useful for images that have some header located before the actual filesystem data\.
.TP
\fB\-H\fR, \fB\-\-print\-header\fR
Print the header located before the filesystem image to stdout\. If no header is present, the program will exit with exit code 2 and emit a warning\.
.TP
\fB\-l\fR, \fB\-\-list\fR
List all entries in the file system image\. Uses output similar to \fBtar \-t\fR\. With \fB\-\-verbose\fR, also print details about each entry\.
.TP
\fB\-\-checksum=\fR\fIname\fR
Produce a checksum using the specified algorithm for each regular file in the file system image\. This can be used to easily verify the file system image against local files, e\.g\.:
.IP "" 4
.nf
dwarfsck \-\-checksum=sha512 /tmp/fs\.dwarfs | sha512sum \-\-check
.fi
.IP "" 0
.TP
\fB\-n\fR, \fB\-\-num\-workers=\fR\fIvalue\fR
Number of worker threads used for integrity checking\.
.TP
\fB\-\-check\-integrity\fR
Instead of performing a fast checksum check, perform a (much slower) integrity check using the embedded SHA\-512/256 hashes\.
.TP
\fB\-\-no\-check\fR
Don't even perform a fast checksum check on the file system blocks\. The metadata will still be checked to make sure it can safely be read\. Use this if you want to quickly query file system information rather than performing an actual file system check\.
.TP
\fB\-j\fR, \fB\-\-json\fR
Print a simple JSON representation of the filesystem metadata\. Please note that the format is \fInot\fR stable\. The level of detail also depends on the \fB\-\-detail\fR switch\. This can be useful in conjunction with the \fBjq\fR tool to extract file system information, for example generate a list of all categories in a file system image:
.IP "" 4
.nf
$ dwarfsck image\.dwarfs \-\-no\-check \-j | jq \-r '\.categories | keys \.[]'
<default>
incompressible
pcmaudio/metadata
pcmaudio/waveform
.fi
.IP "" 0
.TP
\fB\-\-export\-metadata=\fR\fIfile\fR
Export all filesystem metadata in JSON format\.
.TP
\fB\-\-log\-level=\fR\fIname\fR
Specify a logging level\.
.TP
\fB\-\-log\-with\-context\fR
Enable logging context regardless of level\. By default, context is enabled if the level is \fBverbose\fR, \fBdebug\fR or \fBtrace\fR\.
.TP
\fB\-h\fR, \fB\-\-help\fR
Show program help, including option defaults\.
.TP
\fB\-\-man\fR
If the project was built with support for built\-in manual pages, this option will show the manual page\. If supported by the terminal and a suitable pager (e\.g\. \fBless\fR) is found, the manual page is displayed in the pager\.
.SH "AUTHOR"
Written by Marcus Holland\-Moritz\.
.SH "COPYRIGHT"
Copyright (C) Marcus Holland\-Moritz\.
.SH "SEE ALSO"
mkdwarfs(1), dwarfs(1), dwarfsextract(1), dwarfs\-format(5)