1OSTREE REFS(1) ostree refs OSTREE REFS(1)
2
3
4
6 ostree-refs - List refs
7
9 ostree refs [OPTIONS...] [PREFIX]
10
11 ostree refs {EXISTING} {--create=NEWREF}
12
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
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 --revision, -r
36 When listing refs, also print their revisions. The revisions will
37 be separated by a tab character.
38
39 --alias, -A
40 If used with --create, create an alias. Otherwise just list
41 aliases.
42
43 --collections, -c
44 Enable interactions with refs using the combination of their
45 collection IDs and ref names. When listing refs, this changes the
46 output format to include collection IDs, and enables listing remote
47 mirrored refs.
48
49 When creating refs, the refspec value passed to the --create option
50 is treated as COLLECTION-ID:REF-NAME and a mirrored ref is created.
51 (This is an abuse of the refspec syntax.)
52
53 When deleting refs, all refs whose collection ID equals PREFIX are
54 deleted.
55
56 --force
57 When creating NEWREF with --create, allow an existing ref to be
58 updated instead of erroring.
59
61 $ ostree refs
62
63 my-branch
64 gnome-ostree/buildmain/x86_64-runtime
65
66
67
68OSTree OSTREE REFS(1)