ruby-lvm 0.0.1 → 0.1.1

data/lib/lvm/wrapper/pvsseg.rb

@@ -0,0 +1,57 @@
+require 'lvm/wrapper'
+require 'lvm/physical_volume_segment'
+
+module LVM
+  module Wrapper
+    # segment output is very different in that its multi line, easier to treat as own command
+    class PVSSEG
+      include Reporting
+
+      attr_reader :attributes
+      attr_reader :command
+
+      def initialize(options)
+        @attributes = Attributes.load(options[:version], ATTRIBUTES_FILE)
+        @command = "#{options[:command]} #{Reporting.build_command(attributes, BASE_COMMAND)}"
+      end
+
+      BASE_COMMAND = "pvs #{Reporting::BASE_ARGUMENTS}"
+      ATTRIBUTES_FILE = 'pvsseg.yaml'
+ 
+      def list
+        output = External.cmd(@command)
+        data = parse(output)
+        if block_given?
+          return data.each { |obj| yield obj }
+        else
+          return data
+        end
+      end
+ 
+      private
+
+        # Parses the output of self.command
+        def parse(output)
+          volumes = []
+
+          output.split("\n").each do |line|
+            args = process_line(attributes, line)
+
+            args[:finish] = args[:start] + args[:size]
+
+            # finally build our object
+            volume = PhysicalVolumeSegment.new(args)
+
+            if block_given?
+              yield volume
+            else
+              volumes << volume
+            end
+          end
+  
+          return volumes
+        end # parse
+        
+    end # class PVSSEG
+  end # module Wrapper
+end # module LVM 

data/lib/lvm/wrapper/vgs.rb

@@ -0,0 +1,112 @@
+require 'lvm/wrapper'
+require 'lvm/volume_group'
+
+module LVM
+  module Wrapper
+    class VGS
+      include Reporting
+
+      attr_reader :attributes
+      attr_reader :command
+
+      def initialize(options)
+        @attributes = Attributes.load(options[:version], ATTRIBUTES_FILE)
+        @command = "#{options[:command]} #{Reporting.build_command(attributes, BASE_COMMAND)}"
+      end
+
+      BASE_COMMAND = "vgs #{Reporting::BASE_ARGUMENTS}"
+      ATTRIBUTES_FILE = 'vgs.yaml'
+  
+      # vg_attr attribute handling constants
+      # roughly by order referenced in lib/report/report.c:360 (_vgstatus_disp)
+      #
+      PERMISSIONS = {
+        'w' => :writeable,
+        'r' => :readonly,
+      }
+      RESIZEABLE = {
+        # code says its a boolean
+        'z' => true 
+      }
+      EXPORTED = {
+        # code says its a boolean
+        'x' => true
+      }
+      PARTIAL = {
+        # code says its a boolean
+        'p' => true
+      }
+      ALLOCATION_POLICY = {
+        'c' => :contiguous,
+        'l' => :cling,
+        'n' => :normal,
+        'a' => :anywhere,
+        'i' => :inherited,
+        'C' => :contiguous_locked,
+        'L' => :cling_locked,
+        'N' => :normal_locked,
+        'A' => :anywhere_locked,
+        'I' => :inherited_locked
+      }
+      CLUSTERED = {
+        # code says its a boolean
+        'c' => true
+      }
+
+      def list
+        output = External.cmd(@command)
+        data = parse(output)
+        if block_given?
+          return data.each { |obj| yield obj }
+        else
+          return data
+        end
+      end
+
+      private
+
+        def parse_vg_attr(vg_attr) #:nodoc:
+          translated = {}
+          # translate them into nice symbols and a couple booleans 
+          translated[:permissions] = PERMISSIONS[vg_attr[0].chr]
+          translated[:resizeable] = RESIZEABLE[vg_attr[1].chr] ? true : false
+          translated[:exported] = EXPORTED[vg_attr[2].chr] ? true : false
+          translated[:partial] = PARTIAL[vg_attr[3].chr] ? true : false
+          translated[:allocation_policy] = ALLOCATION_POLICY[vg_attr[4].chr]
+          translated[:clustered] = CLUSTERED[vg_attr[5].chr] ? true : false
+
+          return translated
+       end
+  
+        # Parses the output of self.command
+        def parse(output) #:nodoc:
+          volumes = []
+ 
+          output.split("\n").each do |line|
+            args = process_line(attributes, line)
+
+            # now we force some types to ints since we've requested them as bytes
+            # without a suffix
+            args[:size] = args[:size].to_i
+  
+            # we resolve the attributes line to nicer symbols
+            args.merge!(parse_vg_attr(args[:attr]))
+
+            # finally build our object
+            volume = VolumeGroup.new(args)
+  
+            if block_given?
+              yield volume
+            else
+              volumes << volume
+            end
+          end
+    
+          return volumes
+        end # parse
+
+    end # class VGS
+  end # module Wrapper
+end # module LVM
+
+

metadata

@@ -1,116 +1,135 @@
 --- !ruby/object:Gem::Specification 
-rubygems_version: 0.9.0
-specification_version: 1
 name: ruby-lvm
 version: !ruby/object:Gem::Version 
-  version: 0.0.1
-date: 2008-05-30 00:00:00 -07:00
-summary: This is a wrapper for the LVM2 administration utility, lvm
-require_paths: 
-- lib
-email: 
-- matt@bravenet.com
-homepage: http://ruby-lvm.rubyforge.org
-rubyforge_project: ruby-lvm
-description: This is a wrapper for the LVM2 administration utility, lvm. Its primary function it to convert physical volumes, logical volumes and volume groups into easy to use ruby objects. It also provides a simple wrapper for typical create/delete/etc operations.  Unfortunately due to it's lack of a proper api this is as good as it gets for ruby integration for the forseeable future.  See this thread http://www.redhat.com/archives/libvir-list/2007-March/msg00192.html for a similar discussion.
+  version: 0.1.1
+platform: ruby
+authors: 
+- Matthew Kent
 autorequire: 
-default_executable: 
 bindir: bin
-has_rdoc: true
-required_ruby_version: !ruby/object:Gem::Version::Requirement 
-  requirements: 
-  - - ">"
-    - !ruby/object:Gem::Version 
-      version: 0.0.0
-  version: 
-platform: ruby
-signing_key: 
 cert_chain: 
 - |
   -----BEGIN CERTIFICATE-----
-  MIIDMDCCAhigAwIBAgIBADANBgkqhkiG9w0BAQUFADA+MQ0wCwYDVQQDDARtYXR0
-  MRgwFgYKCZImiZPyLGQBGRYIYnJhdmVuZXQxEzARBgoJkiaJk/IsZAEZFgNjb20w
-  HhcNMDgwNTI5MjM1MDUwWhcNMDkwNTI5MjM1MDUwWjA+MQ0wCwYDVQQDDARtYXR0
-  MRgwFgYKCZImiZPyLGQBGRYIYnJhdmVuZXQxEzARBgoJkiaJk/IsZAEZFgNjb20w
-  ggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDDGVrJnpk6/hCO5lg6T7As
-  unEksqdmCly6GkRpX0cVxusWG/wbjrZw4Ka5x9pSS2m3GfefEpu5CuWH9wnGB/q0
-  LwbWhrkpQb+uNVD6hEbQcngDEiQbiitaSWZKSvrIymbM5Tl92rIScmvx7Pd7l8tz
-  BLndL/DmrBHrHWQ47xLxOmBAA4NJy0gk7HdsdAFfJwrEoC14AAXqcI3X0qU3KGrr
-  9Fs0jVeIKktx3fthwGVPrpYrMIw3xgiUqOqn7M+V4soD013dopaN7orewmCm9dQL
-  4N06FMnGNjwFaS6+MV612nk8gkVpJwgcwTHE1GNt2NItR5zeK6j+AZ01DijYdjH9
-  AgMBAAGjOTA3MAkGA1UdEwQCMAAwCwYDVR0PBAQDAgSwMB0GA1UdDgQWBBQ6jcdN
-  QqNNsx2XxigfTWE0Owy0XzANBgkqhkiG9w0BAQUFAAOCAQEAvWBkYaD7eKP+KHxJ
-  dtQuaebQTZvBX4vjk/Omjn7hj7u8X8aTvmCKyopnmywiApFH1zgDa8NRc1KTsvZt
-  zhSRWIuI7fFB+JFZUatE7Nius56id9UchYO98569t6bNU284XwBtcj4MN5Andfcp
-  LKdUNuuT0yui1InJG4fD0uKnOS1qcXEm+mN2s1uqPGVltEHorG7L/bPNAw8xV+uq
-  NPc7hhQTkbi7HB2Uwxr9uK9IGHEE5tDVnsPWPnJJ4jSOc7Bd1eHZuSMkEPfyREDf
-  h9ljoX3AGXW8qYohFzGjflamaWZ4xYaKZSNqS2i0Kc+M76Sy+r9FldDRNn4FGUBE
-  JqYgHg==
+  MIIDMjCCAhqgAwIBAgIBADANBgkqhkiG9w0BAQUFADA/MQ4wDAYDVQQDDAVta2Vu
+  dDEYMBYGCgmSJomT8ixkARkWCG1hZ29henVsMRMwEQYKCZImiZPyLGQBGRYDY29t
+  MB4XDTA4MDcyODA0NTIzMVoXDTA5MDcyODA0NTIzMVowPzEOMAwGA1UEAwwFbWtl
+  bnQxGDAWBgoJkiaJk/IsZAEZFghtYWdvYXp1bDETMBEGCgmSJomT8ixkARkWA2Nv
+  bTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAK9kASXLzL37znIcJoWH
+  lE6LYK9Drf9/tTP0aMJBRwzFAL6NP4KCDTSbzRcurb2gqJI5Hz7wJBm7QQaw7jnx
+  F+wUWEUnXF9v8BIpruFpIM+VHIMaj4h5ifSOh7lOARCn0tBHYYadxlyHhj+cROCf
+  h8SPXUQ7Otsba/8tIjYZTh+tiru7hZApAXZRZOiGPjARwuqvcWYYstbxWOyG5hAB
+  QHdhJD1nv03uHuCR0S/FpLmDM+REEh2PAXbvJIMkBJJ+2KP+7oWwU95/pclnEXE/
+  e0qKZkVsaszihkvh1loxlKhU/sV0Sjo+LJ/fM7SR1a9WzSw1c1C/5Twjmq6jnaLG
+  ZGECAwEAAaM5MDcwCQYDVR0TBAIwADALBgNVHQ8EBAMCBLAwHQYDVR0OBBYEFGhf
+  2WxIO89iFR2KfqyyXeWlUsBMMA0GCSqGSIb3DQEBBQUAA4IBAQAyvET0KFjr4Ars
+  HvOFhZOer5jWTfGDUcKB8oOfLhbs7PANVNv0BARxgH0Dj95kTcIfSvQLWfv5OmqC
+  AT3P6hPV6WbRCJOGPy0jeZcKWgPepl8vqnBciqzB8beBXmYmEe097MNvnlZptqU5
+  If5GWrjlRoeYpRDNpMpaN4UFxsb/I4MGYvbnrEVc6Ev1ztgK5Kci8oYcINjUhCls
+  EOmi6kiwQNdHUW0XLqwGanEip196lyE5IHRylQ5UiwYI0T4hDSc9f0SE+dzENdFw
+  doMOs6odERAAmX+M7PQ4i3Zvs+Jv9SazZBcl8+sohZL3I5A1fkNQXts1hV6TObce
+  T6VhSPds
   -----END CERTIFICATE-----
 
-post_install_message: 
-authors: 
-- Matthew Kent
-files: 
-- History.txt
-- Manifest.txt
-- README.txt
-- Rakefile
-- Todo.txt
-- examples/create_snapshot.rb
-- examples/error_handling.rb
-- examples/show_volumes.rb
-- helpers/generate_field_data.rb
-- lib/lvm.rb
-- lib/lvm/attrib/lvs.yaml
-- lib/lvm/attrib/pvs.yaml
-- lib/lvm/attrib/vgs.yaml
-- lib/lvm/external.rb
-- lib/lvm/lv.rb
-- lib/lvm/lvmanager.rb
-- lib/lvm/lvs.rb
-- lib/lvm/lvseg.rb
-- lib/lvm/proc.rb
-- lib/lvm/pv.rb
-- lib/lvm/pvmanager.rb
-- lib/lvm/pvs.rb
-- lib/lvm/pvseg.rb
-- lib/lvm/vg.rb
-- lib/lvm/vgmanager.rb
-- lib/lvm/vgs.rb
-- test/test_lvm.rb
-test_files: 
-- test/test_lvm.rb
-rdoc_options: 
-- --main
-- README.txt
-extra_rdoc_files: 
-- History.txt
-- Manifest.txt
-- README.txt
-- Todo.txt
-executables: []
-
-extensions: []
-
-requirements: []
-
+date: 2008-07-31 00:00:00 -07:00
+default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: open4
+  type: :runtime
   version_requirement: 
-  version_requirements: !ruby/object:Gem::Version::Requirement 
+  version_requirements: !ruby/object:Gem::Requirement 
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
         version: 0.9.6
     version: 
+- !ruby/object:Gem::Dependency 
+  name: ruby-lvm-attrib
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.0.1
+    version: 
 - !ruby/object:Gem::Dependency 
   name: hoe
+  type: :development
   version_requirement: 
-  version_requirements: !ruby/object:Gem::Version::Requirement 
+  version_requirements: !ruby/object:Gem::Requirement 
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: 1.5.3
+        version: 1.7.0
     version: 
+description: This is a wrapper for the LVM2 administration utility, lvm. Its primary function it to convert physical volumes, logical volumes and volume groups into easy to use ruby objects. It also provides a simple wrapper for typical create/delete/etc operations.  Due to a lack of LVM2 api this is a best effort attempt at ruby integration but subject to complete replacement in the future.
+email: 
+- mkent@magoazul.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- Manifest.txt
+- README.txt
+- Todo.txt
+files: 
+- History.txt
+- Manifest.txt
+- README.txt
+- Rakefile
+- Todo.txt
+- examples/create_snapshot.rb
+- examples/error_handling.rb
+- examples/show_lvm_config.rb
+- lib/lvm.rb
+- lib/lvm/external.rb
+- lib/lvm/logical_volume.rb
+- lib/lvm/logical_volume_segment.rb
+- lib/lvm/logical_volumes.rb
+- lib/lvm/physical_volume.rb
+- lib/lvm/physical_volume_segment.rb
+- lib/lvm/physical_volumes.rb
+- lib/lvm/userland.rb
+- lib/lvm/volume_group.rb
+- lib/lvm/volume_groups.rb
+- lib/lvm/volumes.rb
+- lib/lvm/wrapper.rb
+- lib/lvm/wrapper/constants.rb
+- lib/lvm/wrapper/lvs.rb
+- lib/lvm/wrapper/lvsseg.rb
+- lib/lvm/wrapper/pvs.rb
+- lib/lvm/wrapper/pvsseg.rb
+- lib/lvm/wrapper/vgs.rb
+- test/test_lvm.rb
+has_rdoc: true
+homepage: http://ruby-lvm.rubyforge.org
+post_install_message: 
+rdoc_options: 
+- --main
+- README.txt
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: ruby-lvm
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: This is a wrapper for the LVM2 administration utility, lvm
+test_files: 
+- test/test_lvm.rb

data/examples/show_volumes.rb

@@ -1,26 +0,0 @@
-#!/usr/bin/ruby
-
-$: << File.dirname(__FILE__) + "/../lib"
-
-require 'lvm'
-require 'lvm/lvmanager'
-require 'lvm/pvmanager'
-require 'lvm/vgmanager'
-
-lvm = LVMWrapper::LVM.new(:command => "/usr/bin/sudo /sbin/lvm")
-lv = LVMWrapper::LogicalVolumeManager.new(lvm)
-vg = LVMWrapper::VolumeGroupManager.new(lvm)
-pv = LVMWrapper::PhysicalVolumeManager.new(lvm)
-
-pv.list.each do |p|
- puts "- pv #{p.name}"
-end
-
-puts ""
-
-vg.list.each do |v|
-  puts "- vg #{v.name}"
-  lv.list(v.name).each do |l|
-    puts "-- lv #{l.name}"
-  end
-end

data/helpers/generate_field_data.rb

@@ -1,117 +0,0 @@
-#!/usr/bin/ruby
-
-# collect all lvm reporting columns and format to our liking for inclusion in
-# the library
-#
-# ruby generate_field_data.rb ~/iscsi_work/LVM2.2.02.36
-
-require 'yaml'
-
-LVM_COLUMNS = "/lib/report/columns.h"
-
-CONVERSION_MAP = {
- # Only types we can really trust
- "uint32" => "Integer",
- "int32" => "Integer",
- # These were determined by reading the code, they invoke _(u)int32_disp right away
- "pvmdas" => "Integer",
- "vgmdas" => "Integer",
- "lvcount" => "Integer",
- "lvsegcount" => "Integer",
- "segstartpe" => "Integer",
- # listed to return STR?
- "lvkmaj" => "Integer",
- "lvkmin" => "Integer",
- "snpercent" => "Float",
- "copypercent" => "Float",
- # size32/64, these do unit formatting unless overridden on command line. We
- # typically want them in bytes so we can convert them to Integers safely
- "size32" => "Integer",
- "size64" => "Integer",
- # These types return size32/size64 as well
- "lvkreadahead" => "Integer",
- "pvsize" => "Integer",
- "devsize" => "Integer",
- "pvfree" => "Integer",
- "pvused" => "Integer",
- "pvmdafree" => "Integer",
- "vgsize" => "Integer",
- "vgfree" => "Integer",
- "vgmda_free" => "Integer",
- "chunksize" => "Integer",
- "segstart" => "Integer",
- "segsize" => "Integer",
- "vgmdafree" => "Integer",
- # Weird one, can be "auto" or size32
- "lvreadahead" => "String"
-}
-
-lvm_source = ARGV[0]
-
-lvs = [] 
-vgs = []
-pvs = []
-File.readlines(lvm_source + LVM_COLUMNS).each do |line|
-  chunked = line.split(", ")
-
-  app = chunked[0]
-  general_type = chunked[2]
-  specific_type = chunked[6] 
-  field = chunked[7]
-#  description = chunked[8]
-
-  attribute = field
-  attribute_type = nil
-
-  if app.nil? || general_type.nil? || specific_type.nil? || field.nil?
-    next
-  end
-
-  attribute.gsub!('"', '')
-
-  if general_type == "NUM"
-    attribute_type = CONVERSION_MAP[specific_type]
-    if attribute_type.nil?
-      puts "oops, missing hanlding of attribute '#{attribute}' which says its going to return a '#{specific_type}'"
-      exit 1
-    end
-  else
-    attribute_type = "String"
-  end
- #XXX man page says we can skip the lv_ prefixes! and seg_!
-  if app == "FIELD(LVS" || app == "FIELD(SEGS"
-    lvs << { :option => attribute, :type_hint => attribute_type, :method => attribute.sub(%r{^lv_}, '') }
-  elsif app == "FIELD(PVS" || app == "FIELD(PVSEGS"
-    pvs << { :option => attribute, :type_hint => attribute_type, :method => attribute.sub(%r{^pv_}, '') }
-  elsif app == "FIELD(VGS"
-    vgs << { :option => attribute, :type_hint => attribute_type, :method => attribute.sub(%r{^vg_}, '') }
-  end
-end
-
-lvs.sort! {|x,y| x[:option] <=> y[:option]}
-pvs.sort! {|x,y| x[:option] <=> y[:option]} 
-vgs.sort! {|x,y| x[:option] <=> y[:option]}
-
-File.open("lvs.yaml", "w") do |f|
-  f.write "# these are column to object attribute mappings \n"
-  f.write "# generated by #{$0} based on \n"
-  f.write "# #{lvm_source}/lib/report/columns.h\n"
-  f.write(lvs.to_yaml)
-end
-puts "Wrote data to lvs.yaml"
-
-File.open("pvs.yaml", "w") do |f|
-  f.write "# these are column to object attribute mappings \n"
-  f.write "# generated by #{$0} based on \n"
-  f.write "# #{lvm_source}/lib/report/columns.h\n"
-  f.write(pvs.to_yaml)
-end
-puts "Wrote data to pvs.yaml"
-
-File.open("vgs.yaml", "w") do |f|
-  f.write "# these are column to object attribute mappings \n"
-  f.write "# generated by #{$0} based on \n"
-  f.write "# #{lvm_source}/lib/report/columns.h\n"
-  f.write(vgs.to_yaml)
-end
-puts "Wrote data to vgs.yaml"