'\" t
.\"     Title: ostree admin status
.\"    Author: Colin Walters <walters@verbum.org>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 03/16/2024
.\"    Manual: ostree admin status
.\"    Source: OSTree
.\"  Language: English
.\"
.TH "OSTREE ADMIN STATUS" "1" "" "OSTree" "ostree admin status"
.\" -----------------------------------------------------------------
.\" * 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-admin-status \- List deployments
.SH "SYNOPSIS"
.HP \w'\fBostree\ admin\ status\fR\ 'u
\fBostree admin status\fR
.SH "DESCRIPTION"
.PP
Lists the deployments available to be booted into\&. Includes osname, the checksum followed by the deploy serial, and the refspec\&. An asterisk indicates the current booted deployment\&.
.SH "OPTIONS"
.PP
\fB\-\-sysroot\fR="PATH"
.RS 4
Create a new OSTree sysroot at PATH
.RE
.PP
\fB\-V, \-\-verify\fR
.RS 4
Print the commit verification status
.RE
.PP
\fB\-S, \-\-skip\-signatures\fR
.RS 4
Skip signatures in output
.RE
.PP
\fB\-D, \-\-is\-default\fR
.RS 4
Output the string
default
if the default deployment is the booted one,
not\-default
if we are booted in a non\-default deployment (e\&.g\&. the user interactively chose a different entry in the bootloader menu, or the bootloader rolled back automatically, etc\&.)\&. If we are not in a booted OSTree system, an error is returned\&.
.RE
.PP
\fB\-v, \-\-verbose\fR
.RS 4
Print debug information during command processing
.RE
.PP
\fB\-\-version\fR
.RS 4
Print version information and exit
.RE
.SH "EXAMPLE"
.PP
\fB$ ostree admin status\fR
.sp
.if n \{\
.RS 4
.\}
.nf
        * gnome\-ostree 67e382b11d213a402a5313e61cbc69dfd5ab93cb07\&.0
            origin refspec: gnome\-ostree/buildmain/x86_64\-runtime
          gnome\-ostree ce19c41036cc45e49b0cecf6b157523c2105c4de1c\&.0
            origin refspec: gnome\-ostree/buildmain/x86_64\-runtime
.fi
.if n \{\
.RE
.\}