From 392fea92764824151a8a038af735f5cec834ef64 Mon Sep 17 00:00:00 2001
From: Christopher McIntyre <me@cgmcintyre.com>
Date: Wed, 23 Aug 2017 10:37:28 +0100
Subject: [PATCH 1/2] Add Using OSTree Examining Your System

closes #72
---
 _topic_map.yml              |  7 ++++
 using_ostree/examining.adoc | 64 +++++++++++++++++++++++++++++++++++++
 2 files changed, 71 insertions(+)
 create mode 100644 using_ostree/examining.adoc

diff --git a/_topic_map.yml b/_topic_map.yml
index f3e437a..324fc24 100644
--- a/_topic_map.yml
+++ b/_topic_map.yml
@@ -41,6 +41,13 @@ Topics:
   - Name: Vagrant
     File: vagrant
 
+---
+Name: Using OSTree
+Dir: using_ostree
+Topics:
+  - Name: Examining Your System
+    File: examining
+
 ---
 Name: Tools
 Dir: tools
diff --git a/using_ostree/examining.adoc b/using_ostree/examining.adoc
new file mode 100644
index 0000000..89a4b3f
--- /dev/null
+++ b/using_ostree/examining.adoc
@@ -0,0 +1,64 @@
+[[using-ostree-examining]]
+= Examining Your System
+{product-author}
+{product-version}
+:data-uri:
+:icons:
+
+=== Checking Your Current Ref
+
+OSTree "references" (abbreviated "refs") are textfiles that refer to particular
+commits. They are similar to git branches.
+
+The command `ostree refs` lists all refs available on the host. As an example
+of the output of this command:
+
+....
+$ ostree refs
+ostree/1/1/0
+ostree/1/1/1
+fedora-atomic:fedora/26/x86_64/updates/atomic-host
+....
+
+This shows the host has three refs, `ostree/1/1/0`, `ostree/1/1/1` and
+`fedora-atomic:fedora/26/x86_64/updates/atomic-host`. The refs statring with
+`ostree/` local refs, the ref starting with `fedora-atomic:` is a remote ref.
+
+To check which ref is currently checked out, run `ostree admin status`:
+
+....
+$ ostree admin status
+  fedora-atomic 55be41d9a8f5b7d774652aa4a4d407d496b8892d3d51a6585e6ee268940677ad.0 (pending)
+    Version: 26.111
+    origin refspec: fedora-atomic:fedora/26/x86_64/updates/atomic-host
+* fedora-atomic 0715ce81064c30d34ed52ef811a3ad5e5d6a34da980bf35b19312489b32d9b83.0
+    Version: 26.91
+    origin refspec: fedora-atomic:fedora/26/x86_64/updates/atomic-host
+....
+
+The `*` next to the second item in the list tells us this is the current tree.
+To explore this tree:
+
+....
+cd /ostree/deploy/fedora-atomic/deploy/0715ce81064c30d34ed52ef811a3ad5e5d6a34da980bf35b19312489b32d9b83.0/
+$ ls
+bin   dev  home  lib64  mnt  ostree  root  sbin  sys      tmp  var
+boot  etc  lib   media  opt  proc    run   srv   sysroot  usr
+....
+
+=== Browsing History
+
+To look at the history of a ref, use the `ostree log` command. Running the
+command on `fedora-atomic:fedora/26/x86_64/updates/atomic-host`:
+
+....
+$ ostree log fedora-atomic:fedora/26/x86_64/updates/atomic-host
+commit 55be41d9a8f5b7d774652aa4a4d407d496b8892d3d51a6585e6ee268940677ad
+Date:  2017-08-22 20:05:54 +0000
+Version: 26.111
+(no subject)
+
+<< History beyond this commit not fetched >>
+....
+
+This ref has one commit in its history.

From 6954df31214e0e189532e6da24422523e5898dec Mon Sep 17 00:00:00 2001
From: Christopher McIntyre <me@cgmcintyre.com>
Date: Wed, 23 Aug 2017 16:58:21 +0100
Subject: [PATCH 2/2] Fix typo in Using OSTree Checking Your Current ref

---
 using_ostree/examining.adoc | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/using_ostree/examining.adoc b/using_ostree/examining.adoc
index 89a4b3f..3792366 100644
--- a/using_ostree/examining.adoc
+++ b/using_ostree/examining.adoc
@@ -21,8 +21,9 @@ fedora-atomic:fedora/26/x86_64/updates/atomic-host
 ....
 
 This shows the host has three refs, `ostree/1/1/0`, `ostree/1/1/1` and
-`fedora-atomic:fedora/26/x86_64/updates/atomic-host`. The refs statring with
-`ostree/` local refs, the ref starting with `fedora-atomic:` is a remote ref.
+`fedora-atomic:fedora/26/x86_64/updates/atomic-host`. The refs starting with
+`ostree/` are local refs, the ref starting with `fedora-atomic:` is a remote
+ref.
 
 To check which ref is currently checked out, run `ostree admin status`: