From 507dc20bc7ff8e74550ce0b985f3282af0d491ef Mon Sep 17 00:00:00 2001
From: Noah Watkins <noahwatkins@gmail.com>
Date: Wed, 3 Dec 2014 21:05:08 -0800
Subject: [PATCH] doc: add read/write example to readme

Signed-off-by: Noah Watkins <noahwatkins@gmail.com>
---
 README.md | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/README.md b/README.md
index 5c6ac28..40a06a9 100644
--- a/README.md
+++ b/README.md
@@ -44,6 +44,28 @@ err := conn.ParseCmdLineArgs(args)
 
 For other configuration options see the full documentation.
 
+### Object I/O
+
+Object in RADOS can be written to and read from with through an interface very
+similar to a standard file I/O interface:
+
+```go
+    // open a pool handle
+    pool, err := conn.OpenPool("mypool")
+
+    // write some data
+    bytes_in := []byte("input data")
+    err = pool.Write("obj", bytes_in, 0)
+
+    // read the data back out
+    bytes_out := make([]byte, len(bytes_in))
+    n_out, err := pool.Read("obj", bytes_out, 0)
+
+    if bytes_in != bytes_out {
+        fmt.Println("Output is not input!")
+    }
+```
+
 ### Pool maintenance
 
 The list of pools in a cluster can be retreived using the `ListPools` method