'\" t
.\"     Title: ostree show
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 07/02/2026
.\"    Manual: ostree show
.\"    Source: OSTree
.\"  Language: English
.\"
.TH "OSTREE SHOW" "1" "" "OSTree" "ostree show"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ostree-show \- Output a metadata object
.SH "SYNOPSIS"
.HP \w'\fBostree\ show\fR\ 'u
\fBostree show\fR [OPTIONS...] {OBJECT}
.SH "DESCRIPTION"
.PP
Given an object, shows the metadata for that object\&. For a particular revision, it will show the data for the most recent commit to that revision\&.
.SH "OPTIONS"
.PP
\fB\-\-print\-related\fR
.RS 4
Show the "related" commits\&.
.RE
.PP
\fB\-\-print\-variant\-type\fR="TYPE"
.RS 4
Memory map
\fIOBJECT\fR
(in this case a filename) to the GVariant type string\&.
.RE
.PP
\fB\-\-list\-metadata\-keys\fR
.RS 4
List the available metadata keys\&.
.RE
.PP
\fB\-\-print\-metadata\-key\fR="KEY"
.RS 4
Print string value of metadata key\&.
.RE
.PP
\fB\-\-list\-detached\-metadata\-keys\fR
.RS 4
List the available detached metadata keys\&.
.RE
.PP
\fB\-\-print\-detached\-metadata\-key\fR="KEY"
.RS 4
Print string value of detached metadata key\&.
.RE
.PP
\fB\-\-print\-sizes\fR
.RS 4
Show the commit size metadata\&. This in only supported for commits that contain
\fIostree\&.sizes\fR
metadata\&. This can be included when creating commits with
\fBostree commit \-\-generate\-sizes\fR\&.
.RE
.PP
\fB\-\-raw\fR
.RS 4
Show raw variant data\&.
.RE
.PP
\fB\-\-gpg\-homedir\fR="HOMEDIR"
.RS 4
GPG home directory to use when looking for keyrings (if have GPGME \- GNU Privacy Guard Made Easy)\&.
.RE
.SH "EXAMPLE"
.PP
\fB$ ostree show my\-branch\fR
.sp
.if n \{\
.RS 4
.\}
.nf
        commit 67e382b11d213a402a5313e61cbc69dfd5ab93cb07
        Date:  2014\-06\-12 13:42:54 +0000
.fi
.if n \{\
.RE
.\}
