drbd 0.1.2 → 0.1.3

data/README.rdoc

@@ -23,63 +23,95 @@ Ruby wrapper for DRBD
 
 
 == How it works
-# simply fetch data from remote host
-d = Drbd.new("fqdn.domain.tld")
-
-# you can specify command to be executed 
-
-d = Drbd.new("fqdn.domain.tld", :command => 'sudo /sbin/drbdadm')
-
-# obtain array of configured resources
-r = d.resources.first
-
-# get resource name
-r.name
-
-# get resource protocol
-r.protocol
-
-# get hosts for resource
-r.hosts
-
-# get status for resource
-r.status
-
-# get node addresses
-r.hosts.map{|h| h.address }
-
-# get status
-# resource status is hash with keys: 
-# [:cs, :resynced_percent, :minor, :ro1, :ds1, :ro2, :ds2, :name]
-r.status
-
-# find resource by name
-r = d.find_resource_by_name("r0")
-
-# find resource by backing disk
-r = d.find_resource_by_disk("/dev/volgroup-logvolume--name")
-
-# true if both of devices are UpToDate
-r.consinstent?
-
-# true if resynced_percent is present in status
-r.resync_running?
-
-# true if resource status is "Connected"
-r.up?
-
-# true if resource status is "Unconfigured"
-r.down?
-
-# perform drbdadm up on resource (use at your own risk!)
-r.up!
-
-# perform drbdadm down on resource (use at your own risk!)
-r.down!
-
-# perform forced drbdadm create-md on resource (use at your own risk!)
-r.init_metadata
-
+- simply fetch data from remote host
+
+  <tt>d = Drbd.new("fqdn.domain.tld")</tt>
+
+  you can specify command to be executed 
+
+  <tt>d = Drbd.new("fqdn.domain.tld", :command => 'sudo /sbin/drbdadm')</tt>
+
+- obtain array of configured configured resources
+  
+  <tt>r = d.resources.first</tt>
+
+- get resource name
+  
+  <tt>r.name</tt>
+
+- get resource protocol
+  
+  <tt>r.protocol</tt>
+
+- get hosts for resource
+  
+  <tt>r.hosts</tt>
+
+- get status for resource
+  
+  <tt>r.status</tt>
+
+- get node addresses
+  
+  <tt>r.hosts.map{|h| h.address }</tt>
+
+- get status
+  
+  resource status is hash with keys:
+  
+  [:cs, :resynced_percent, :minor, :ro1, :ds1, :ro2, :ds2, :name]
+  
+  <tt>r.status</tt>
+
+- find resource by name
+  
+  <tt>r = d.find_resource_by_name("r0")</tt>
+
+- find resource by backing disk
+  
+  <tt>r = d.find_resource_by_disk("/dev/volgroup-logvolume--name")</tt>
+
+- true if both of devices are UpToDate
+  
+  <tt>r.consinstent?</tt>
+
+- true if resynced_percent is present in status
+  
+  <tt>r.resync_running?</tt>
+
+- true if resource status is "Connected"
+  
+  <tt>r.up?</tt>
+
+- true if resource status is "Unconfigured"
+  
+  <tt>r.down?</tt>
+
+- stateless perform drbdadm up on resource (use at your own risk!)
+  
+  <tt>r.up!</tt>
+
+- stateless perform drbdadm down on resource (use at your own risk!)
+  
+  <tt>r.down!</tt>
+
+- stateless perform forced drbdadm create-md on resource (use at your own risk!)
+  
+  if resource is not down, returns false and does nothing
+  
+  <tt>r.init_metadata</tt>
+  
+  
+  
+- back-reference to the DRBD object
+  
+  <tt>r.drbd</tt>
+
+- uptate status of all resources
+  
+  <tt>r.drbd.load_status!</tt>
+
+  <tt>d.load_status!</tt>
 
 == TODO
 

data/VERSION

@@ -1 +1 @@
-0.1.2
+0.1.3

data/lib/drbd.rb

@@ -97,6 +97,7 @@ class DRBD
       command = "ssh #{drbd.host} \"#{drbd.command} #{args}\""
       system(command)
       drbd.load_status!
+      nil
     end
     
     def down!
@@ -104,6 +105,7 @@ class DRBD
       command = "ssh #{drbd.host} \"#{drbd.command} #{args}\""
       system(command)
       drbd.load_status!
+      nil
     end
     
     def init_metadata!

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: drbd
 version: !ruby/object:Gem::Version 
-  hash: 31
+  hash: 29
   prerelease: false
   segments: 
   - 0
   - 1
-  - 2
-  version: 0.1.2
+  - 3
+  version: 0.1.3
 platform: ruby
 authors: 
 - Adam Kliment