ostree-refs - Man Page

ostree refs [Options...] [PREFIX]

ostree refs {EXISTING} {--create=NEWREF}

Lists all refs available on the host​. If specified, PREFIX assigns the refspec prefix; default prefix is null, which lists all refs​. This command can also be used to create or delete refs​.

--list

For historical reasons, refs without this option will strip the specified prefix from the output​. Normally, one wants to see the full ref, so providing this option ensures the refs are printed in full, rather than truncated​.

--create=NEWREF

Create a ref pointing to the commit EXISTING​. NEWREF must not already exist, and EXISTING must be an existing commit​. More than one ref can point to the same commit​.

--delete

Delete refs which match PREFIX, rather than listing them​. If you are trying to reclaim space, you will then need to ostree prune or ostree admin cleanup​.

--revision,  -r

When listing refs, also print their revisions​. The revisions will be separated by a tab character​.

--alias,  -A

If used with --create, create an alias​. Otherwise just list aliases​.

--collections,  -c

Enable interactions with refs using the combination of their collection IDs and ref names​. When listing refs, this changes the output format to include collection IDs, and enables listing remote mirrored refs​.

When creating refs, the refspec value passed to the --create option is treated as COLLECTION-ID:REF-NAME and a mirrored ref is created​. (This is an abuse of the refspec syntax​.)

When deleting refs, all refs whose collection ID equals PREFIX are deleted​.

--force

When creating NEWREF with --create, allow an existing ref to be updated instead of erroring​.

$ ostree refs

        my-branch
        gnome-ostree/buildmain/x86_64-runtime

ostree(1).