di-ruby-lvm-attrib 0.0.4 → 0.0.7

data/Manifest.txt

@@ -31,6 +31,11 @@ lib/lvm/attributes/2.02.95(2)/lvsseg.yaml
 lib/lvm/attributes/2.02.95(2)/pvs.yaml
 lib/lvm/attributes/2.02.95(2)/pvsseg.yaml
 lib/lvm/attributes/2.02.95(2)/vgs.yaml
+lib/lvm/attributes/2.02.98(2)/lvs.yaml
+lib/lvm/attributes/2.02.98(2)/lvsseg.yaml
+lib/lvm/attributes/2.02.98(2)/pvs.yaml
+lib/lvm/attributes/2.02.98(2)/pvsseg.yaml
+lib/lvm/attributes/2.02.98(2)/vgs.yaml
 Manifest.txt
 Rakefile
 README.txt

data/README.txt

@@ -6,7 +6,8 @@
 == DESCRIPTION:
 
 This is a list of attributes for lvm objects. They are generated from the 
-source code and broken down by version.
+source code and broken down by version. See ADDING ATTRIBUTES below
+to contribute.
 
 At their core these files exist to determine which arguments to pass
 lvs/vgs/pvs and the subsequent type conversions.
@@ -32,6 +33,35 @@ updating to follow LVM2 releases.
 
 * sudo gem install ruby-lvm-attrib
 
+== ADDING ATTRIBUTES:
+
+To add attributes:
+* Download and extract LVM2 source version from: http://git.fedorahosted.org/cgit/lvm2.git/refs/tags
+* Fork this repository
+* `git clone your-forked-repo`
+* `cd your-forked-repo`
+* `git checkout -b mybranch`
+* `bin/generate_field_data path/to/lvm2-source`
+  * See missing attribute type note below if there's issues, otherwise will just return "Done."
+* `mv LVM_VERSION_FULL lib/lvm/attributes/LVM_VERSION`
+  * LVM_VERSION_FULL being something like 2.02.86(2)-cvs or 2.02.98(2)-git
+  * LVM_VERSION being something like 2.02.86(2) or 2.02.98(2)
+* `git commit -am "Added LVM_VERSION attributes"`
+* `git push origin mybranch`
+* Submit PR to this repository. Please make sure to point your pull at the
+  `next` branch -- NOT MASTER!
+
+=== MISSING ATTRIBUTE TYPE:
+
+If you get an error like the below:
+
+    Oops, missing type conversion data of column 'discards' use by 'SEGS' which says its going to return a 'discards'
+    Figure out the missing type and rerun.
+
+* Look in `path/to/lvm-source/lib/report/columns.rb` for the column name in the 7th field.
+* If the 3rd field is NUM, type will be Integer. If 3rd field is STR, type will be String.
+* Add the information to `bin/generate_field_data` in the TYPE_CONVERSION_MAP and try running again
+
 == FEEDBACK:
 
 Please feel free to submit patches or constructive criticism, I'm still pretty

data/bin/generate_field_data

@@ -59,6 +59,7 @@ TYPE_CONVERSION_MAP = {
  "vgmdasused" => "Integer",
  "vgmdacopies" => "Integer",
  "thincount" => "Integer",
+ "discards" => "Integer",
  "thinzero" => "Integer",
  "transactionid" => "Integer"
 }

data/lib/lvm/attributes.rb

@@ -2,7 +2,7 @@ require 'yaml'
 
 module LVM
   module Attributes
-    VERSION = '0.0.4'
+    VERSION = '0.0.7'
 
     def load(version, name)
       cwd = File.dirname(__FILE__)

data/lib/lvm/attributes/2.02.98(2)/lvs.yaml

@@ -0,0 +1,124 @@
+# These are column to object attribute mappings
+# generated by bin/generate_field_data based on
+# /Users/bflad/Desktop/lvm2-2_02_98/lib/report/columns.h
+---
+- :method: convert_lv
+  :column: convert_lv
+  :type_hint: String
+  :description: For lvconvert
+- :method: copy_percent
+  :column: copy_percent
+  :type_hint: Float
+  :description: For mirrors and pvmove
+- :method: data_lv
+  :column: data_lv
+  :type_hint: String
+  :description: For thin pools
+- :method: data_percent
+  :column: data_percent
+  :type_hint: Float
+  :description: For snapshot and thin pools and volumes
+- :method: attr
+  :column: lv_attr
+  :type_hint: String
+  :description: Various attributes - see man page.
+- :method: host
+  :column: lv_host
+  :type_hint: String
+  :description: Creation host of the LV
+- :method: kernel_major
+  :column: lv_kernel_major
+  :type_hint: String
+  :description: Currently assigned major number or -1 if LV is not active.
+- :method: kernel_minor
+  :column: lv_kernel_minor
+  :type_hint: String
+  :description: Currently assigned minor number or -1 if LV is not active.
+- :method: kernel_read_ahead
+  :column: lv_kernel_read_ahead
+  :type_hint: Integer
+  :description: Currently-in-use read ahead setting in current units.
+- :method: major
+  :column: lv_major
+  :type_hint: Integer
+  :description: Persistent major number or -1 if not persistent.
+- :method: metadata_size
+  :column: lv_metadata_size
+  :type_hint: Integer
+  :description: For thin pools
+- :method: minor
+  :column: lv_minor
+  :type_hint: Integer
+  :description: Persistent minor number or -1 if not persistent.
+- :method: name
+  :column: lv_name
+  :type_hint: String
+  :description: Name.  LVs created for internal use are enclosed in brackets.
+- :method: path
+  :column: lv_path
+  :type_hint: String
+  :description: Full pathname for LV.
+- :method: read_ahead
+  :column: lv_read_ahead
+  :type_hint: String
+  :description: Read ahead setting in current units.
+- :method: size
+  :column: lv_size
+  :type_hint: Integer
+  :description: Size of LV in current units.
+- :method: tags
+  :column: lv_tags
+  :type_hint: String
+  :description: Tags
+- :method: time
+  :column: lv_time
+  :type_hint: String
+  :description: Creation time of the LV
+- :method: uuid
+  :column: lv_uuid
+  :type_hint: String
+  :description: Unique identifier.
+- :method: metadata_lv
+  :column: metadata_lv
+  :type_hint: String
+  :description: For thin pools
+- :method: metadata_percent
+  :column: metadata_percent
+  :type_hint: Float
+  :description: For thin pools
+- :method: mirror_log
+  :column: mirror_log
+  :type_hint: String
+  :description: For mirrors
+- :method: modules
+  :column: modules
+  :type_hint: String
+  :description: Kernel device-mapper modules required for this LV.
+- :method: move_pv
+  :column: move_pv
+  :type_hint: String
+  :description: For pvmove
+- :method: origin
+  :column: origin
+  :type_hint: String
+  :description: For snapshots
+- :method: origin_size
+  :column: origin_size
+  :type_hint: Integer
+  :description: For snapshots
+- :method: pool_lv
+  :column: pool_lv
+  :type_hint: String
+  :description: For thin volumes
+- :method: seg_count
+  :column: seg_count
+  :type_hint: Integer
+  :description: Number of segments in LV.
+- :method: snap_percent
+  :column: snap_percent
+  :type_hint: Float
+  :description: For snapshots
+- :method: vg_uuid
+  :column: vg_uuid
+  :type_hint: String
+  :description: For VolumeGroup to LogicalVolume relationship.

data/lib/lvm/attributes/2.02.98(2)/lvsseg.yaml

@@ -0,0 +1,80 @@
+# These are column to object attribute mappings
+# generated by bin/generate_field_data based on
+# /Users/bflad/Desktop/lvm2-2_02_98/lib/report/columns.h
+---
+- :method: chunk_size
+  :column: chunk_size
+  :type_hint: Integer
+  :description: For snapshots
+- :method: chunksize
+  :column: chunksize
+  :type_hint: Integer
+  :description: For snapshots
+- :method: devices
+  :column: devices
+  :type_hint: String
+  :description: Underlying devices used with starting extent numbers.
+- :method: discards
+  :column: discards
+  :type_hint: Integer
+  :description: For thin pools
+- :method: lv_uuid
+  :column: lv_uuid
+  :type_hint: String
+  :description: For LogicalVolume to LogicalVolumeSegment relationship.
+- :method: region_size
+  :column: region_size
+  :type_hint: Integer
+  :description: For mirrors
+- :method: regionsize
+  :column: regionsize
+  :type_hint: Integer
+  :description: For mirrors
+- :method: pe_ranges
+  :column: seg_pe_ranges
+  :type_hint: String
+  :description: Ranges of Physical Extents of underlying devices in command line format.
+- :method: size
+  :column: seg_size
+  :type_hint: Integer
+  :description: Size of segment in current units.
+- :method: start
+  :column: seg_start
+  :type_hint: Integer
+  :description: Offset within the LV to the start of the segment in current units.
+- :method: start_pe
+  :column: seg_start_pe
+  :type_hint: Integer
+  :description: Offset within the LV to the start of the segment in physical extents.
+- :method: tags
+  :column: seg_tags
+  :type_hint: String
+  :description: Tags
+- :method: segtype
+  :column: segtype
+  :type_hint: String
+  :description: Type of LV segment.
+- :method: stripe_size
+  :column: stripe_size
+  :type_hint: Integer
+  :description: For stripes
+- :method: stripes
+  :column: stripes
+  :type_hint: Integer
+  :description: Number of stripes or mirror legs.
+- :method: stripesize
+  :column: stripesize
+  :type_hint: Integer
+  :description: For stripes
+- :method: thin_count
+  :column: thin_count
+  :type_hint: Integer
+  :description: For thin pools
+- :method: transaction_id
+  :column: transaction_id
+  :type_hint: Integer
+  :description: For thin pools
+- :method: zero
+  :column: zero
+  :type_hint: Integer
+  :description: For thin pools

data/lib/lvm/attributes/2.02.98(2)/pvs.yaml

@@ -0,0 +1,72 @@
+# These are column to object attribute mappings
+# generated by bin/generate_field_data based on
+# /Users/bflad/Desktop/lvm2-2_02_98/lib/report/columns.h
+---
+- :method: dev_size
+  :column: dev_size
+  :type_hint: Integer
+  :description: Size of underlying device in current units.
+- :method: pe_start
+  :column: pe_start
+  :type_hint: Integer
+  :description: Offset to the start of data on the underlying device.
+- :method: attr
+  :column: pv_attr
+  :type_hint: String
+  :description: Various attributes - see man page.
+- :method: fmt
+  :column: pv_fmt
+  :type_hint: String
+  :description: Type of metadata.
+- :method: free
+  :column: pv_free
+  :type_hint: Integer
+  :description: Total amount of unallocated space in current units.
+- :method: mda_count
+  :column: pv_mda_count
+  :type_hint: Integer
+  :description: Number of metadata areas on this device.
+- :method: mda_free
+  :column: pv_mda_free
+  :type_hint: Integer
+  :description: Free metadata area space on this device in current units.
+- :method: mda_size
+  :column: pv_mda_size
+  :type_hint: Integer
+  :description: Size of smallest metadata area on this device in current units.
+- :method: mda_used_count
+  :column: pv_mda_used_count
+  :type_hint: Integer
+  :description: Number of metadata areas in use on this device.
+- :method: name
+  :column: pv_name
+  :type_hint: String
+  :description: Name.
+- :method: pe_alloc_count
+  :column: pv_pe_alloc_count
+  :type_hint: Integer
+  :description: Total number of allocated Physical Extents.
+- :method: pe_count
+  :column: pv_pe_count
+  :type_hint: Integer
+  :description: Total number of Physical Extents.
+- :method: size
+  :column: pv_size
+  :type_hint: Integer
+  :description: Size of PV in current units.
+- :method: tags
+  :column: pv_tags
+  :type_hint: String
+  :description: Tags
+- :method: used
+  :column: pv_used
+  :type_hint: Integer
+  :description: Total amount of allocated space in current units.
+- :method: uuid
+  :column: pv_uuid
+  :type_hint: String
+  :description: Unique identifier.
+- :method: vg_uuid
+  :column: vg_uuid
+  :type_hint: String
+  :description: For VolumeGroup to PhysicalVolume relationship.

data/lib/lvm/attributes/2.02.98(2)/pvsseg.yaml

@@ -0,0 +1,16 @@
+# These are column to object attribute mappings
+# generated by bin/generate_field_data based on
+# /Users/bflad/Desktop/lvm2-2_02_98/lib/report/columns.h
+---
+- :method: pv_uuid
+  :column: pv_uuid
+  :type_hint: String
+  :description: For PhysicalVolume to PhysicalVolumeSegment relationship.
+- :method: size
+  :column: pvseg_size
+  :type_hint: Integer
+  :description: Number of extents in segment.
+- :method: start
+  :column: pvseg_start
+  :type_hint: Integer
+  :description: Physical Extent number of start of segment.

data/lib/lvm/attributes/2.02.98(2)/vgs.yaml

@@ -0,0 +1,92 @@
+# These are column to object attribute mappings
+# generated by bin/generate_field_data based on
+# /Users/bflad/Desktop/lvm2-2_02_98/lib/report/columns.h
+---
+- :method: lv_count
+  :column: lv_count
+  :type_hint: Integer
+  :description: Number of LVs.
+- :method: max_lv
+  :column: max_lv
+  :type_hint: Integer
+  :description: Maximum number of LVs allowed in VG or 0 if unlimited.
+- :method: max_pv
+  :column: max_pv
+  :type_hint: Integer
+  :description: Maximum number of PVs allowed in VG or 0 if unlimited.
+- :method: pv_count
+  :column: pv_count
+  :type_hint: Integer
+  :description: Number of PVs.
+- :method: snap_count
+  :column: snap_count
+  :type_hint: Integer
+  :description: Number of snapshots.
+- :method: attr
+  :column: vg_attr
+  :type_hint: String
+  :description: Various attributes - see man page.
+- :method: extent_count
+  :column: vg_extent_count
+  :type_hint: Integer
+  :description: Total number of Physical Extents.
+- :method: extent_size
+  :column: vg_extent_size
+  :type_hint: Integer
+  :description: Size of Physical Extents in current units.
+- :method: fmt
+  :column: vg_fmt
+  :type_hint: String
+  :description: Type of metadata.
+- :method: free
+  :column: vg_free
+  :type_hint: Integer
+  :description: Total amount of free space in current units.
+- :method: free_count
+  :column: vg_free_count
+  :type_hint: Integer
+  :description: Total number of unallocated Physical Extents.
+- :method: mda_copies
+  :column: vg_mda_copies
+  :type_hint: Integer
+  :description: Target number of in use metadata areas in the VG.
+- :method: mda_count
+  :column: vg_mda_count
+  :type_hint: Integer
+  :description: Number of metadata areas on this VG.
+- :method: mda_free
+  :column: vg_mda_free
+  :type_hint: Integer
+  :description: Free metadata area space for this VG in current units.
+- :method: mda_size
+  :column: vg_mda_size
+  :type_hint: Integer
+  :description: Size of smallest metadata area for this VG in current units.
+- :method: mda_used_count
+  :column: vg_mda_used_count
+  :type_hint: Integer
+  :description: Number of metadata areas in use on this VG.
+- :method: name
+  :column: vg_name
+  :type_hint: String
+  :description: Name.
+- :method: seqno
+  :column: vg_seqno
+  :type_hint: Integer
+  :description: Revision number of internal metadata.  Incremented whenever it changes.
+- :method: size
+  :column: vg_size
+  :type_hint: Integer
+  :description: Total size of VG in current units.
+- :method: sysid
+  :column: vg_sysid
+  :type_hint: String
+  :description: System ID indicating when and where it was created.
+- :method: tags
+  :column: vg_tags
+  :type_hint: String
+  :description: Tags
+- :method: uuid
+  :column: vg_uuid
+  :type_hint: String
+  :description: Unique identifier.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: di-ruby-lvm-attrib
 version: !ruby/object:Gem::Version
-  version: 0.0.4
+  version: 0.0.7
   prerelease: 
 platform: ruby
 authors:
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-02-07 00:00:00.000000000 Z
+date: 2013-02-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rdoc
@@ -45,10 +45,10 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '3.5'
 description: ! "This is a list of attributes for lvm objects. They are generated from
-  the \nsource code and broken down by version.\n\nAt their core these files exist
-  to determine which arguments to pass\nlvs/vgs/pvs and the subsequent type conversions.\n\nCurrently
-  this is split from the main ruby-lvm gem since these files require\nupdating to
-  follow LVM2 releases."
+  the \nsource code and broken down by version. See ADDING ATTRIBUTES below\nto contribute.\n\nAt
+  their core these files exist to determine which arguments to pass\nlvs/vgs/pvs and
+  the subsequent type conversions.\n\nCurrently this is split from the main ruby-lvm
+  gem since these files require\nupdating to follow LVM2 releases."
 email:
 - mkent@magoazul.com
 - gsymons@drillinginfo.com
@@ -94,6 +94,11 @@ files:
 - lib/lvm/attributes/2.02.95(2)/pvs.yaml
 - lib/lvm/attributes/2.02.95(2)/pvsseg.yaml
 - lib/lvm/attributes/2.02.95(2)/vgs.yaml
+- lib/lvm/attributes/2.02.98(2)/lvs.yaml
+- lib/lvm/attributes/2.02.98(2)/lvsseg.yaml
+- lib/lvm/attributes/2.02.98(2)/pvs.yaml
+- lib/lvm/attributes/2.02.98(2)/pvsseg.yaml
+- lib/lvm/attributes/2.02.98(2)/vgs.yaml
 - Manifest.txt
 - Rakefile
 - README.txt