.nh
.TH composefs-info(1) composefs | User Commands

.SH NAME
.PP
composefs-info - print information about a composefs image


.SH SYNOPSIS
.PP
\fBcomposefs-info\fP [ls|objects|missing-objects|dump] \fIIMAGE\fP [\fIIMAGE2\fP \fIIMAGE3\fP ...]


.SH DESCRIPTION
.PP
The composefs-info command lets you inspect a composefs image. It has
several sub-commands:

.TP
\fBls\fP
Prints a simple list of the files and directorie in the images as
well as their backing file or symlink target.

.TP
\fBobjects\fP
Prints a list of all the backing files referenced by the images,
in sorted order.

.TP
\fBmissing-objects\fP
Prints a list of all the missing backing files referenced by the
images, in sorted order, given a backing file store passed in
using the --basedir option.

.TP
\fBdump\fP
Prints a full dump of the images in a line based textual format.
See \fBcomposefs-dump(5)\fP for more details. This format is also
accepted as input to mkcomposefs if the --from-file
option is used.

.TP
\fBmeasure-file\fP
Interpret the provided paths as generic files, and print their fsverity digest.


.SH OPTIONS
.PP
The provided \fIIMAGE\fP argument must be a composefs file. Multiple images
can be specified.

.PP
\fBcompoosefs-info\fP accepts the following options:

.TP
\fB--basedir\fP=\fIPATH\fP
This should point to a directory of backing files, and will be used
by the \fBmissing-objects\fP command to know what files are available.


.SH SEE ALSO
.PP
\fBcomposefs-info(1)\fP, \fBcomposefs-dump(5)\fP

.PP
composefs upstream
\[la]https://github.com/containers/composefs\[ra]