logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

ostree-refs - List refs

Description

       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.

Example

$ostreerefs

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

OSTree                                                                                            OSTREEREFS(1)

Name

       ostree-refs - List refs

Options

--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 ostreeprune or ostreeadmincleanup.

       --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.

Synopsis

ostreerefs [OPTIONS...] [PREFIX]

       ostreerefs {EXISTING} {--create=NEWREF}

See Also