RubyGems - istat - Versions diffs - 0.0.1 - Mend

istat 0.0.1

Files changed (35) hide show

data/README.md +57 -0
data/debug.log +181 -0
data/doc/_index.html +82 -0
data/doc/class_list.html +36 -0
data/doc/css/common.css +1 -0
data/doc/css/full_list.css +53 -0
data/doc/css/style.css +318 -0
data/doc/file.README.html +99 -0
data/doc/file_list.html +38 -0
data/doc/frames.html +13 -0
data/doc/index.html +99 -0
data/doc/js/app.js +203 -0
data/doc/js/full_list.js +149 -0
data/doc/js/jquery.js +16 -0
data/doc/method_list.html +35 -0
data/doc/top-level-namespace.html +78 -0
data/istat.gemspec +42 -0
data/lib/istat/client.rb +158 -0
data/lib/istat/frames/authentication.rb +62 -0
data/lib/istat/frames/base.rb +60 -0
data/lib/istat/frames/connection_test.rb +36 -0
data/lib/istat/frames/measurement.rb +254 -0
data/lib/istat/frames/register.rb +61 -0
data/lib/istat/utils.rb +35 -0
data/lib/istat/version.rb +22 -0
data/lib/istat.rb +9 -0
data/spec/client_spec.rb +50 -0
data/spec/frames/authentication_spec.rb +23 -0
data/spec/frames/connection_test_spec.rb +18 -0
data/spec/frames/measurement_request_spec.rb +117 -0
data/spec/frames/register_spec.rb +22 -0
data/spec/spec_helper.rb +8 -0
data/spec/utils_spec.rb +9 -0
data/test_rc.sh +3 -0
metadata +122 -0

data/doc/top-level-namespace.html ADDED Viewed

@@ -0,0 +1,78 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+<title>Top Level Namespace</title>
+<link rel="stylesheet" href="css/style.css" type="text/css" media="screen" charset="utf-8" />
+<link rel="stylesheet" href="css/common.css" type="text/css" media="screen" charset="utf-8" />
+<script type="text/javascript" charset="utf-8">
+  relpath = '';
+  if (relpath != '') relpath += '/';
+</script>
+<script type="text/javascript" charset="utf-8" src="js/jquery.js"></script>
+<script type="text/javascript" charset="utf-8" src="js/app.js"></script>
+  </head>
+  <body>
+    <script type="text/javascript" charset="utf-8">
+      if (window.top.frames.main) document.body.className = 'frames';
+    </script>
+    <div id="header">
+      <div id="menu">
+    <a href="_index.html">Index</a> &raquo;
+    <span class="title">Top Level Namespace</span>
+  <div class="noframes"><span class="title">(</span><a href="." target="_top">no frames</a><span class="title">)</span></div>
+</div>
+      <div id="search">
+  <a id="class_list_link" href="#">Class List</a>
+  <a id="method_list_link" href="#">Method List</a>
+  <a id ="file_list_link" href="#">File List</a>
+</div>
+      <div class="clear"></div>
+    </div>
+    <iframe id="search_frame"></iframe>
+    <div id="content"><h1>Top Level Namespace
+</h1>
+<dl class="box">
+</dl>
+<div class="clear"></div>
+</div>
+    <div id="footer">
+  Generated on Fri Apr 29 23:16:07 2011 by
+  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
+  0.6.8 (ruby-1.8.7).
+</div>
+  </body>
+</html>

data/istat.gemspec ADDED Viewed

@@ -0,0 +1,42 @@
+# -*- encoding: utf-8 -*-
+$:.push('lib')
+require "istat/version"
+Gem::Specification.new do |s|
+  s.name     = "istat"
+  s.version  = Istat::VERSION.dup
+  s.date     = "2011-04-29"
+  s.summary  = "an istat client library for ruby"
+  s.email    = "vilandgr+github@googlemail.com"
+  s.homepage = "https://github.com/threez/istat"
+  s.authors  = ['Vincent Landgaf']
+  s.description = <<-EOF
+an istat client library for ruby
+EOF
+  dependencies = [
+    # Examples:
+    # [:runtime,     "rack",  "~> 1.1"],
+    [:development, "rspec", "~> 2.1"],
+  ]
+  s.files         = Dir['**/*']
+  s.test_files    = Dir['spec/**/*']
+  s.executables   = Dir['bin/*'].map { |f| File.basename(f) }
+  s.require_paths = ["lib"]
+  ## Make sure you can build the gem on older versions of RubyGems too:
+  s.rubygems_version = "1.6.1"
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.specification_version = 3 if s.respond_to? :specification_version
+  dependencies.each do |type, name, version|
+    if s.respond_to?("add_#{type}_dependency")
+      s.send("add_#{type}_dependency", name, version)
+    else
+      s.add_dependency(name, version)
+    end
+  end
+end

data/lib/istat/client.rb ADDED Viewed

@@ -0,0 +1,158 @@
+require "socket"
+# Copyright (c) 2011 Vincent Landgraf
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+module Istat
+  class Client
+    class WrongPasswordException < Exception; end
+    class NoServiceException < Exception; end
+    class RegisterException < Exception; end
+    # the frame that was send from the server after registration
+    attr_accessor :connection_frame
+    # create a new istat client instance
+    # @param host [String] the hostname of the remote istat server
+    # @param port [String] the port of the istat server usually 5109
+    # @param passwd [String] the passwd or code to access the server
+    # @param logger [optional Logger] a logger that will log all actions on the client
+    # @example
+    #   @client = Istat::Clinet.new("example.com", 5109, "00000")
+    #
+    def initialize(host, port, passwd, logger = nil)
+      @host, @port, @passwd, @logger = host, port, passwd, logger
+      @request_id = 1
+    end
+    # starts a session on the remote machine and yields it to the passed block.
+    # @yield [Istat::Client] the remote session
+    # @example
+    #   @client = Istat::Clinet.new("example.com", 5109, "00000")
+    #   @client.start do |session|
+    #     # work with the session
+    #   end
+    #
+    def start
+      connect!
+      if online?
+        if register!
+          if authenticate!
+            yield(self)
+          else
+            raise WrongPasswordException.new("Wrong password/code!")
+          end
+        else
+          raise RegisterException.new("Can't register to the service")
+        end
+      else
+        raise NoServiceException.new("Service is not available")
+      end
+      close!
+    end
+    # connect to the remote server
+    # @return [Boolean] true is the connection was successfull
+    def connect!
+      @logger.info "Connect to #{@host}:#{@port}" if @logger
+      @socket = TCPSocket.new(@host, @port)
+      true
+    end
+    # authenticate using the password, that was passed during initialization
+    # @note must be connected and registered to the remote machine
+    # @return [Boolean] true on success
+    def authenticate!
+      @logger.info "Authenticate using password #{'*' * @passwd.size}" if @logger
+      send Istat::Frames::AuthenticationRequest.new(@passwd)
+      response = Istat::Frames::AuthenticationResponse.new(receive)
+      response.ready?
+    end
+    # checks if the host has the istat service active
+    # @note must be connected to the remote machine
+    # @return true on success
+    def online?
+      @logger.info "Test the connection" if @logger
+      send Istat::Frames::ConnectionTestRequest.new
+      response = Istat::Frames::ConnectionTestResponse.new(receive)
+      response.success?
+    end
+    # closes the connection
+    # @return true on success
+    def close!
+      @logger.info "Close the connection" if @logger
+      @socket.close
+      true
+    end
+    # register to the remote server using the source hostname and a uuid. If
+    # no values are passed, they will be fetched usind system methods. (Socket.gethostname)
+    # @note must be connected before this action should be called
+    # @param [optional, String] hostname the hostname for the registration (e.g. example.com)
+    # @param [optional, String] duuid the uuid for the registration
+    def register!(hostname = nil, duuid = nil)
+      hostname ||= Socket.gethostname
+      duuid ||= Istat::Utils.uuid
+      @logger.info "Register using hostname '#{hostname}' and duuid '#{duuid}'" if @logger
+      send Istat::Frames::RegisterRequest.new(hostname, duuid)
+      @connection_frame = Istat::Frames::RegisterResponse.new(receive)
+    end
+    # fetch data from the remote server
+    # @param [Integer|Time] since size of the requested history (-1 last)
+    # @return [Istat::Frames::MeasurementResponse] the fetched result
+    # @example
+    #   @client = Istat::Clinet.new("example.com", 5109, "00000")
+    #   @client.start do |session|
+    #     response = session.fetch
+    #     response.load # => [0.54, 0.59, 0.65]
+    #   end
+    #
+    def fetch(since = -1)
+      @logger.info("Fetch measurements with request_id #{@request_id}")
+      send Istat::Frames::MeasurementRequest.new(@request_id, since)
+      @request_id += 1 # increment for next request
+      Istat::Frames::MeasurementResponse.new(receive)
+    end
+  protected
+    # send a frame to the remote system (istatd)
+    # @note will use the *to_s* method to serialize the frame on the wire
+    # @param [Istat::Frame::Request] the frame to send
+    # @return [Integer] number of bytes send
+    def send(frame)
+      @logger.debug "Send: #{frame.to_s}" if @logger
+      @socket.send frame.to_s, 0
+    end
+    # receive data for a frame from the remote system (istatd)
+    # @return [String] the xml stream that was send from istatd
+    def receive
+      data = ""
+      begin
+        data << @socket.recv(1024)
+      end while !data.include?("</isr>")
+      @logger.debug "Recieved: #{data}" if @logger
+      data
+    end
+  end
+end

data/lib/istat/frames/authentication.rb ADDED Viewed

@@ -0,0 +1,62 @@
+# Copyright (c) 2011 Vincent Landgraf
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+module Istat
+  module Frames
+    # authenticate with passwd
+    class AuthenticationRequest
+      # create a new authentication resquest frame with the passed code/password
+      # @param [String] password the password to use for authentication
+      def initialize(password)
+        @password = password
+      end
+      # just returns the password, the frame has no header or container
+      # @return [String] the password
+      def to_s
+        @password
+      end
+    end
+    class AuthenticationResponse < Response
+      READY  = "ready".freeze
+      REJECT = "athrej".freeze
+      # check if he authentication was successful
+      # @return [Boolean] true if authentication is successful
+      def ready?
+        if val = @root.attributes[READY]
+          val.to_i == 1
+        else
+          false
+        end
+      end
+      # check if he authentication was rejected
+      # @return [Boolean] true if authentication is rejected
+      def rejected?
+        if val = @root.attributes[REJECT]
+          val.to_i == 1
+        else
+          false
+        end
+      end
+    end
+  end
+end

data/lib/istat/frames/base.rb ADDED Viewed

@@ -0,0 +1,60 @@
+require "rexml/document"
+# Copyright (c) 2011 Vincent Landgraf
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+module Istat
+  module Frames
+    # This class handles basic xml actions and content parsing for the frames
+    # @abstract
+    class Base
+      # xml doytype style header
+      DOCTYPE = "<?xml version=\"1.0\" encoding=\"UTF-8\"?>".freeze
+      # creates a frame based on the passed xml string
+      # @param [String] xml_str the xml string to use for initalization
+      def initialize(xml_str)
+        @doc = REXML::Document.new(xml_str)
+        @root = @doc.root
+      end
+      # serialize the frame (as xml)
+      # @return [String] a xml structure
+      def to_s
+        @doc.to_s
+      end
+    protected
+      # create new frame (xml) based on the passed params
+      # @params [Array<Array>] the arrays on which the xml structure will be generated
+      # @return [String] the generated xml structure
+      # @api private
+      def create(*params)
+        xml = "#{DOCTYPE}<isr>"
+        params.each { |key, value| xml << "<#{key}>#{value}</#{key}>" }
+        xml << "</isr>"
+        xml
+      end
+    end
+    class Request < Base;  end
+    class Response < Base; end
+  end
+end

data/lib/istat/frames/connection_test.rb ADDED Viewed

@@ -0,0 +1,36 @@
+# Copyright (c) 2011 Vincent Landgraf
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+module Istat
+  module Frames
+    class ConnectionTestRequest < Request
+      def initialize
+        super create([:conntest, nil])
+      end
+    end
+    class ConnectionTestResponse < Response
+      # check for an empty frame, that will be returned by the server
+      # @return [Boolean] ture if the connection was successful established
+      def success?
+        @root.to_a.empty?
+      end
+    end
+  end
+end

data/lib/istat/frames/measurement.rb ADDED Viewed

@@ -0,0 +1,254 @@
+# Copyright (c) 2011 Vincent Landgraf
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+module Istat
+  module Frames
+    class MeasurementRequest < Request
+      RID      = :rid
+      CPU      = :c
+      NETWORK  = :n
+      MEMORY   = :m
+      LOAD     = :lo
+      TEMP     = :t  # qnap only
+      FAN      = :f
+      UPTIME   = :u
+      DISK     = :d
+      # create a new request based on the requested id. The default is to
+      # request only the last values (since -1)
+      # @param [Integer] rid the request identifier (increases)
+      # @param [Integer] since the since field (-1 for last, or Time.now timestamp)
+      def initialize(rid, since = -1)
+        since = Time.now.to_i - since.to_i if since.is_a? Time
+        super create([RID,     rid],
+                     [CPU,     since],
+                     [NETWORK, since],
+                     [MEMORY,  since],
+                     [LOAD,    since],
+                     [TEMP,    since],
+                     [FAN,     since],
+                     [UPTIME,  since],
+                     [DISK,    since])
+      end
+    end
+    class MeasurementResponse < Response
+      # returns true if there is a cpu section in the frame
+      def cpu?
+        has_node? :CPU
+      end
+      # collect cpu data (can contain history)
+      # @return [Array<Hash>] the cpu load and usage data
+      # @example Result
+      #   [
+      #     { :id => 28388970, :user => 0, :system => 0, :nice => 0 },
+      #     { :id => 28388971, :user => 0, :system => 0, :nice => 0 },
+      #     { :id => 28388972, :user => 0, :system => 0, :nice => 0 },
+      #     { :id => 28388973, :user => 0, :system => 0, :nice => 0 }
+      #   ]
+      def cpu
+        entires_for(:CPU) do |element, attributes|
+          {
+            :id     => attributes["id"].to_i,
+            :user   => attributes["u"].to_i,
+            :system => attributes["s"].to_i,
+            :nice   => attributes["n"].to_i
+          }
+        end
+      end
+      # returns true if there is a network section in the frame
+      def network?
+        has_node? :NET
+      end
+      # collects all network information over the interfaces (can contain history)
+      # @return [Hash<Array<Hash>>] the network data for the interfaces
+      # @example Result
+      #   {
+      #     1 => [
+      #       { :id => 28388970, :d => 4177773, :u => 232278672, :t => 1304082088 },
+      #       { :id => 28388971, :d => 4177773, :u => 232278672, :t => 1304082089 },
+      #       { :id => 28388972, :d => 4177773, :u => 232278672, :t => 1304082090 },
+      #       { :id => 28388973, :d => 4177773, :u => 232278672, :t => 1304082091 }
+      #     ]
+      #   }
+      #
+      def network
+        interfaces = { 1 => [] }
+        entires_for(:NET) do |element, attributes|
+          interfaces[1] << {
+            :id => attributes["id"].to_i,
+            :d  => attributes["d"].to_i,
+            :u  => attributes["u"].to_i,
+            :t  => attributes["t"].to_i
+          }
+        end
+        interfaces
+      end
+      # returns true if there is a memory section in the frame
+      def memory?
+        has_node? :MEM
+      end
+      # parse the memory informations
+      # @return [Hash] the memory information
+      # @example Result
+      #   {
+      #     :wired => 25938,
+      #     :active => 27620,
+      #     :inactive => 11664,
+      #     :free => 7983,
+      #     :total => 73207,
+      #     :swap_used => 3,
+      #     :swap_total => 36861,
+      #     :page_ins => 0,
+      #     :page_outs => 0
+      #   }
+      #
+      def memory
+        attributes = @root.elements["MEM"].attributes
+        {
+          :wired => attributes["w"].to_i,
+          :active => attributes["a"].to_i,
+          :inactive => attributes["i"].to_i,
+          :free => attributes["f"].to_i,
+          :total => attributes["t"].to_i,
+          :swap_used => attributes["su"].to_i,
+          :swap_total => attributes["st"].to_i,
+          :page_ins => attributes["pi"].to_i,
+          :page_outs => attributes["po"].to_i
+        }
+      end
+      # returns true if there is a load section in the frame
+      def load?
+        has_node? :LOAD
+      end
+      # parse the load informations
+      # @return [Array] the load of the system
+      # @example Result
+      #   [0.54, 0.60, 0.67]
+      #
+      def load
+        attributes = @root.elements["LOAD"].attributes
+        [attributes["one"].to_f, attributes["fv"].to_f, attributes["ff"].to_f]
+      end
+      # returns true if there is a temps section in the frame
+      def temps?
+        has_node? :TEMPS
+      end
+      # collect all temperature informations in order
+      # @return [Array] the temps that are returned using the sensor modules
+      # @example
+      #   [30, 52, 29, 50, 30, 64, 61]
+      #
+      def temps
+        temps = []
+        entires_for(:TEMPS) do |element, attributes|
+          temps[attributes["i"].to_i] = attributes["t"].to_i
+        end
+        temps
+      end
+      # returns true if there is a fan section in the frame
+      def fans?
+        has_node? :FANS
+      end
+      # collect all fan informations in order
+      # @return [Array] containing all the fans
+      # @example Result
+      #   [1999]
+      #
+      def fans
+        fans = []
+        entires_for(:FANS) do |element, attributes|
+          fans[attributes["i"].to_i] = attributes["s"].to_i
+        end
+        fans
+      end
+      # returns true if there is a uptime section in the frame
+      def uptime?
+        has_node? :UPT
+      end
+      # calculate the system uptime
+      # @return [Time] the uptime orf the system
+      # @example Result
+      #   "Sat Apr 30 09:46:45 +0200 2011"
+      #
+      def uptime
+        Time.now - @root.elements["UPT"].attributes["u"].to_i
+      end
+      # returns true if there is a disks section in the frame
+      def disks?
+        has_node? :DISKS
+      end
+      # collect all disk informations
+      # @return [Array<Hash>] all disks of the system
+      # @example Result
+      #   [
+      #     :label => "/",
+      #     :uuid => "/dev/vzfs",
+      #     :free => 9226,
+      #     :percent_used => 39.931
+      #   ]
+      #
+      def disks
+        entires_for(:DISKS) do |element, attributes|
+          {
+            :label          => attributes["n"],
+            :uuid           => attributes["uuid"],
+            :free           => attributes["f"].to_i,
+            :percent_used   => attributes["p"].to_f
+          }
+        end
+      end
+    protected
+      # returns true if a node is available
+      # @api private
+      def has_node?(name)
+        !@root.elements["#{name}"].nil?
+      end
+      # yields over the elements of a path
+      # @api private
+      def entires_for(name, &block)
+        entries = []
+        @root.elements["#{name}"].map do |element|
+          unless element.is_a? REXML::Text
+            entries << block.call(element, element.attributes)
+          end
+        end
+        entries
+      end
+    end
+  end
+end