ostreeOSTreeDeveloperColinWalterswalters@verbum.orgostree1ostreeManage multiple bootable versioned filesystem treesostree COMMANDOPTIONSDescription
OSTree is a tool for managing multiple bootable
versioned filesystem trees, or just "tree" for
short. In the OSTree model, operating systems no
longer live in the physical "/" root directory.
Instead, they parallel install to the new toplevel
/ostree directory.
Unlike rpm or
dpkg, OSTree is only aware of
complete filesystem trees. It has no built-in
knowledge of what components went into creating the
filesystem tree.
It must be emphasized that OSTree only supports
read-only trees. To change to
a different tree (upgrade, downgrade, install
software), a new tree is checked out, and a 3-way
merge of configuration is performed. The currently
running tree is not ever modified; the new tree will
become active on a system reboot.
OptionsThe following options are understood:For most commands,
when run as non-root, repository is
required. If
ostree is run as
root, it is assumed operations will be
performed on the
/sysroot/ostree/repo
repository.
The following commands are understood:checkoutExtract a given branch into the filesystem.checksumCompute the OSTree checksum of the given files.diffConcisely list differences between the given branch revisions,
without checking them out into the filesystem.initInitialize a repository.commitGiven one or more
trees (from the local filesystem, a
tarball, or a specified revision for
example), create a new commit using those contents.
composeA specialized type of
commit, intended for merging together
many separate filesystem trees such as
build artifacts.local-cloneEfficiently copy
objects and references from one local
repository into another.
logShow revision log.lsList the contents of a given commit.fsckCheck a repository for consistency.remoteManipulate remote archive configuration.rev-parseShow the SHA256 corresponding to a given rev.run-triggersRegenerate cache files in the given operating system tree.showGiven an OSTree SHA256 checksum, display its contents.Exit statusOn success 0 is returned, a non-zero failure
code otherwise.Environment$PAGERostree respects the traditional pager envrionment variable.See Alsoostbuild1