Tips and Tricks

How do I find the differences between revisions ?

First, you want to make sure that you have more than the latest revision available in your repository:

$ ostree pull --repo=/ostree/repo --depth 15 gnome

pulls the last 15 revisions.

Now, you can see the differences between revisions by using diff:

$ ostree --repo=/ostree/repo diff trees/gnomeos-3.6-i686-devel^^^ trees/gnomeos-3.6-i686-devel^^
M    /contents.json
M    /usr/lib/libharfbuzz.so.0.903.0
M    /usr/lib/girepository-1.0/Soup-2.4.typelib
M    /usr/share/gir-1.0/Soup-2.4.gir

Here we see that the revision that is 2 steps behind the tip has been composed using new builds of harfbuzz and libsoup.

To find out more about the exact contents of this revision, you can study the contents.json file:

$ ostree --repo=/ostree/repo cat trees/gnomeos-3.6-i686-devel^^ contents.json
{
    "00ostbuild-manifest-version": 0,
    "architectures": [
        "i686"
    ],
    "base": {
        "name": "yocto",
        "src": "cgwalters:poky"
    },
    "components": [
        {
            "branch": "master",
            "component": "devel",
            "name": "gtk-doc-stub",
            "noarch": true,
            "revision": "3dfd0a09de696ec8c544762747f8a0f77153622e",
            "src": "git:git://git.gnome.org/gtk-doc-stub"
        },
        {
            "branch": "master",
   ...

As you can see, the bulk of the file is a list of components, each of which identifies a git repository and a revision, which pinpoints the exact source that this component was built from.