1OSTREE FIND-REMOTES(1) ostree find-remotes OSTREE FIND-REMOTES(1)
2
3
4
6 ostree-find-remotes - Find remotes to serve the given refs
7
9 ostree find-remotes [OPTIONS...] {COLLECTION-ID} {REF}
10 [COLLECTION-ID REF...]
11
13 OSTree has the ability to pull not just from the configured remote
14 servers but also from peer computers on the LAN and from mounted
15 filesystems such as USB drives. This functionality requires the use of
16 collection IDs and GPG verification.
17
18 The find-remotes command searches for remotes which claim to provide
19 one or more of the given COLLECTION-ID REF pairs and prints information
20 about them, with remotes sorted by latency (Mounts > LAN > Internet).
21 By default, OSTree searches for remotes in configuration files, on
22 mounted filesystems (in a well-known location), and on the LAN using
23 Avahi. Searching for LAN remotes requires OSTree to have been compiled
24 with Avahi support, and it requires an Avahi daemon to be running. You
25 can override the default set of finders (sources for remotes) using the
26 --finders option documented below.
27
28 The create-usb command is the recommended way to put refs on a USB such
29 that find-remotes will discover them. See ostree-create-usb(1).
30
32 --disable-fsync
33 Do not invoke fsync().
34
35 --finders=FINDERS
36 Use the specified comma separated list of finders rather than the
37 default set. Possible values: config, lan, and mount (or any
38 combination thereof).
39
40 --pull
41 Pull the most recent commit found for each ref.
42
43 --mirror
44 Do a mirror pull (see the documentation for ostree pull --mirror).
45 This option can only be used in combination with --pull.
46
48 $ ostree find-remotes --finders=mount,lan com.exampleos.Os
49 exampleos/x86_64/standard
50
51 Result 0: http://10.0.64.202:43381/0
52 - Finder: OstreeRepoFinderAvahi
53 - Keyring: exampleos.trustedkeys.gpg
54 - Priority: 60
55 - Summary last modified: 2018-01-12T19:00:28Z
56 - Refs:
57 - (com.exampleos.Os, exampleos/x86_64/standard) = c91acd964b3fda561b87bfb7f7c80e36220d76b567f0ce90c0e60742ef33c360
58
59 1/1 refs were found.
60
61
62
63OSTree OSTREE FIND-REMOTES(1)