2014-06-17 23:24:08 +04:00
<?xml version='1.0'?> <!-- * - nxml - * -->
< !DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
<!--
Copyright 2014 Anne LoVerso <anne.loverso @ s t u d e n t s . o l i n . e d u >
2018-01-30 22:26:26 +03:00
SPDX-License-Identifier: LGPL-2.0+
2014-06-17 23:24:08 +04:00
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public
2021-12-07 04:20:55 +03:00
License along with this library. If not, see <https: / / w w w . g n u . o r g / l i c e n s e s /> .
2014-06-17 23:24:08 +04:00
-->
<refentry id= "ostree" >
<refentryinfo >
<title > ostree admin switch</title>
<productname > OSTree</productname>
<authorgroup >
<author >
<contrib > Developer</contrib>
<firstname > Colin</firstname>
<surname > Walters</surname>
<email > walters@verbum.org</email>
</author>
</authorgroup>
</refentryinfo>
<refmeta >
<refentrytitle > ostree admin switch</refentrytitle>
<manvolnum > 1</manvolnum>
</refmeta>
<refnamediv >
<refname > ostree-admin-switch</refname>
<refpurpose > Construct new tree from current origin and deploy it, if it changed</refpurpose>
</refnamediv>
<refsynopsisdiv >
<cmdsynopsis >
2014-11-29 20:15:21 +03:00
<command > ostree admin switch</command> <arg choice= "req" > REF</arg>
2014-06-17 23:24:08 +04:00
</cmdsynopsis>
</refsynopsisdiv>
<refsect1 >
<title > Description</title>
<para >
2022-02-12 20:48:35 +03:00
Choose a different REF from the current remote to track. This is the ref that will be "tracked" and upgraded with <command > ostree admin upgrade</command> . Like an upgrade, the operating system state will be preserved.
2014-06-17 23:24:08 +04:00
</para>
</refsect1>
<refsect1 >
<title > Options</title>
<variablelist >
<varlistentry >
2017-04-14 17:34:38 +03:00
<term > <option > --os</option> ="STATEROOT"</term>
2014-06-17 23:24:08 +04:00
<listitem > <para >
2014-11-11 05:28:43 +03:00
Use a different operating system root than the current one.
2014-06-17 23:24:08 +04:00
</para> </listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 >
<title > Example</title>
<para > <command > $ ostree admin switch fedostree/20/workstation/gnome/core</command> </para>
</refsect1>
</refentry>