1OSTREE REFS(1)                    ostree refs                   OSTREE REFS(1)
2
3
4

NAME

6       ostree-refs - List refs
7

SYNOPSIS

9       ostree refs [OPTIONS...] [PREFIX]
10
11       ostree refs {EXISTING} {--create=NEWREF}
12

DESCRIPTION

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

OPTIONS

19       --list
20           For historical reasons, refs without this option will strip the
21           specified prefix from the output. Normally, one wants to see the
22           full ref, so providing this option ensures the refs are printed in
23           full, rather than truncated.
24
25       --create=NEWREF
26           Create a ref pointing to the commit EXISTING. NEWREF must not
27           already exist, and EXISTING must be an existing commit. More than
28           one ref can point to the same commit.
29
30       --delete
31           Delete refs which match PREFIX, rather than listing them. If you
32           are trying to reclaim space, you will then need to ostree prune or
33           ostree admin cleanup.
34
35       --alias, -A
36           If used with --create, create an alias. Otherwise just list
37           aliases.
38
39       --collections, -c
40           Enable interactions with refs using the combination of their
41           collection IDs and ref names. When listing refs, this changes the
42           output format to include collection IDs, and enables listing remote
43           mirrored refs.
44
45           When creating refs, the refspec value passed to the --create option
46           is treated as COLLECTION-ID:REF-NAME and a mirrored ref is created.
47           (This is an abuse of the refspec syntax.)
48
49           When deleting refs, all refs whose collection ID equals PREFIX are
50           deleted.
51
52       --force
53           When creating NEWREF with --create, allow an existing ref to be
54           updated instead of erroring.
55

EXAMPLE

57       $ ostree refs
58
59                   my-branch
60                   gnome-ostree/buildmain/x86_64-runtime
61
62
63
64OSTree                                                          OSTREE REFS(1)
Impressum