ovsimager 0.0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 5a4813849f38c8999ec90b9f68e1607e681681e9
+  data.tar.gz: c08b1ec71b6b0a1b5e04c459bdc4f7238823edab
+SHA512:
+  metadata.gz: 9a270e213b0422701c25006ee62397d623ecfd5c19a483459936c2da2f38e7c62abce02afc83634c25f618fbb76e196c3474dd3b83e24868452381e54aa0de42
+  data.tar.gz: adcdff1ffb9073c446e171c64592e41247eb51e21978bd7a4591bb38b3ac77fe78092891f6fbbb09ce44461a6e55f7579a486f8ea996f0d0509686555bd062a4

data/.gitignore

@@ -0,0 +1,15 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+*.dot
+mkmf.log

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.travis.yml

@@ -0,0 +1,3 @@
+language: ruby
+rvm:
+  - 2.1.6

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in ovsimager.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2015 Tomoki Sekiyama
+
+MIT License
+
+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.

data/README.md

@@ -0,0 +1,48 @@
+# OVSImager
+
+OVSImager draws a graph that describes relationship among Open vSwitch
+bridges, Linux bridges, and namespaces for routing. It can also mark
+the ports where ping packets went through using tcpdump, which is a
+useful feature for trouble-shooting in SDN environments.
+
+## Installation
+
+    $ gem install ovsimager
+    # sudo yum install graphviz
+
+## Usage
+
+### Draw a graph of Open vSwitch'es
+
+    $ ovsimager
+    ( => interfaces.png will be generated. )
+
+![sample](sample-interfaces.png)
+
+### Trace ping packets
+
+Execute ping packet with size = 400 byte, and trace them:
+
+    $ ping -s 400 192.0.2.1
+    $ sudo ovsimager -d
+    ( => interfaces.png will be generated. )
+
+![sample](sample-ping-trace.png)
+
+Or, ovsimager also can send ping:
+
+    $ sudo ovsimager -d -f 10.0.0.1 -t 192.0.2.1
+
+Colors:
+
+- Yellow => both 'ping' and 'pong' are went through
+- Pink   => only 'ping' is went through
+- Red    => only 'pong' is went through
+
+## Contributing
+
+1. Fork it ( https://github.com/NeoCat/ovsimager/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/Rakefile

@@ -0,0 +1,7 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec
+

data/bin/ovsimager

@@ -0,0 +1,11 @@
+#!/usr/bin/env ruby
+
+lib_dir = File.join(File.dirname(__FILE__), '..', 'lib')
+$LOAD_PATH.unshift lib_dir if File.directory?(lib_dir)
+
+require 'ovsimager'
+
+ovsimager = OVSImager::OVSImager.new
+ovsimager.parse_options
+ovsimager.execute_dump
+ovsimager.show_all

data/lib/ovsimager.rb

@@ -0,0 +1,2 @@
+require "ovsimager/version"
+require "ovsimager/ovsimager"

data/lib/ovsimager/dotwriter.rb

@@ -0,0 +1,86 @@
+module OVSImager
+  class DotWriter
+    def initialize(fname)
+      @fname = fname
+      @dot = File.open(fname, 'w')
+      @dot.puts 'graph interfaces {'
+      @dot.puts '  compound=true'
+      @dot.puts '  node [shape=rect]'
+      @dot_peers = []
+    end
+
+    def escape(name)
+      name.to_s.gsub('-', '_')
+    end
+
+    def mark2color(mark)
+      {'<' => 'red', '>' => 'pink', '*' => 'yellow'}[mark]
+    end
+
+    def finish(pngname)
+      @dot.puts @dot_peers.join "\n"
+      @dot.puts '}'
+      @dot.close
+      @dot = nil
+      system("dot -Tpng \"#{@fname}\" -o \"#{pngname}\"")
+    end
+
+    # For OVSVS & LinuxBridge
+    def br_begin(name, br_type)
+      @dot.puts "  subgraph cluster_br__#{escape(name)} {"
+      @dot.puts "    label = \"#{br_type}Bridge #{name}\""
+    end
+
+    def br_iface(name, mark, dump, inet, tag, peer, remote=nil)
+      fill = mark ? "fillcolor=#{mark2color(mark)},style=filled," : ''
+      label = "#{name}<BR/><FONT POINT-SIZE=\"10\">#{inet.join(',')}"
+      if tag or remote
+        label += "<BR/>#{tag}#{remote && remote.gsub('>','&gt;')}"
+      end
+      if dump
+        label += " </FONT><FONT COLOR=\"blue\">"
+        if dump[0] && dump[2] && dump[0] == dump[3] && dump[1] == dump[2]
+          label += "<BR/>[#{dump[0]} &lt;-&gt; #{dump[1]}]"
+        else
+          label += "<BR/>[#{dump[0]} --&gt; #{dump[1]}]" if dump[0]
+          label += "<BR/>[#{dump[3]} &lt;-- #{dump[2]}]" if dump[2]
+        end
+      end
+      label += " </FONT>"
+      @dot.puts "    #{escape(name)} [#{fill}label=<#{label}>]"
+      if peer && name <= peer
+        @dot_peers << "  #{escape(name)} -- #{escape(peer)}"
+      end
+    end
+
+    def br_end
+      @dot.puts "  }"
+    end
+
+    # For IPNetNS
+    def ns_begin(name)
+      @dot.puts "  subgraph cluster_ns__#{escape(name)} {"
+      @dot.puts "  label = \"Namespace\\n#{name}\""
+      @dot.puts "  style = \"filled\""
+      @dot.puts "  fillcolor = \"#eeeeee\""
+      @dot.puts "  ns__#{escape(name)} " +
+        "[label=\"\",style=invis,width=0,height=0,margin=0]"
+      @nsname = name
+    end
+
+    def ns_br_iface(name)
+      @dot_peers << "  #{escape(name)} -- ns__#{escape(@nsname)} " +
+        "[style=dashed,lhead=cluster_ns__#{escape(@nsname)}]"
+    end
+
+    def ns_iface(name, mark, dump, inet, tag, peer)
+      br_iface(name, mark, dump, inet, tag, peer)
+      # @dot.puts "    #{escape(name)} -- #{escape(@last)} [style=invis]" if @last
+      # @last = name
+    end
+
+    def ns_end
+      @dot.puts '  }'
+    end
+  end
+end

data/lib/ovsimager/ipnetns.rb

@@ -0,0 +1,97 @@
+require_relative 'utils'
+
+module OVSImager
+  class IPNetNS
+    def initialize()
+      @ns = exec_ip('netns').split(/\n/)
+      @ifaces = {:root => parse_address(exec_ip('a'), :root)}
+      links = parse_link(exec_ip('-d link'), :root)
+      merge_link_type(@ifaces[:root], links)
+      @ns.each {|ns|
+        out = exec_ip("netns exec #{ns} ip a", true)
+        @ifaces[ns] = parse_address(out, ns)
+        out = exec_ip("netns exec #{ns} ip -d link", true)
+        links = parse_link(out, ns)
+        merge_link_type(@ifaces[ns], links)
+      }
+      find_veth_pair
+    end
+
+    def to_hash()
+      @ifaces
+    end
+
+    def ifaces_hash()
+      @ifaces.inject({}) {|h, (ns, v)| v.each {|i| h[i[:name]] = i}; h}
+    end
+
+    def ifaces_ary()
+      @ifaces.inject([]) {|a, (ns, v)| v.each {|i| a[i[:id].to_i] = i}; a}
+    end
+
+    def exec_ip(args, root=false)
+      Utils.execute("ip #{args}", root)
+    end
+
+    private
+    def parse(out, args)
+      out.split(/\n(?=[^ \s])/).map do |iface|
+        if iface.match(/^(\d+):\s+(\S+?):+/)
+          params = {:id => $1, :name => $2}
+          yield params, iface, args
+        else
+          STDERR.puts "IPNetNS: parse error: #{iface}"
+          {}
+        end
+      end
+    end
+
+    def parse_address(out, ns)
+      parse(out, ns) do |params, iface, ns|
+        params[:ns] = ns
+        params[:mac] = $1 if iface.match(/link\/\w+ (\S+)/)
+        [:inet, :inet6].each do |key|
+          params[key] = iface.scan(/#{key.to_s} (\S+)/)
+        end
+        [:mtu, :state].each do |key|
+          params[key] = $1 if iface.match(/#{key.to_s} (\S+)/)
+        end
+        params
+      end
+    end
+
+    def parse_link(out, ns)
+      parse(out, ns) do |params, iface, ns|
+        params[:ns] = ns
+        params[:mac] = $1 if iface.match(/link\/\w+ (\S+)/)
+        params[:type] = (iface.split(/\n/)[2] || '').strip
+        params
+      end
+    end
+
+    def merge_link_type(ifaces, links)
+      link_types = links.inject({}) {|h, link| h[link[:id]] = link[:type]; h}
+      ifaces.each {|iface| iface[:type] = link_types[iface[:id]]}
+    end
+
+    def find_veth_pair()
+      ifaces = ifaces_ary
+      ifaces.each do |iface|
+        next unless iface
+        if iface[:type] == 'veth' && !iface[:peer]
+          if iface[:ns] == :root
+            out = Utils::execute("ethtool -S #{iface[:name]}")
+          else
+            out = exec_ip("netns exec #{iface[:ns]} ethtool -S #{iface[:name]}", root=true)
+          end
+          if out.match /peer_ifindex: (\d+)/
+            iface[:peer] = ifaces[$1.to_i][:name]
+            ifaces[$1.to_i][:peer] = iface[:name]
+          else
+            STDERR.puts("Failed to lookup veth peer of '#{iface[:name]}'")
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ovsimager/linuxbridge.rb

@@ -0,0 +1,33 @@
+require_relative 'utils'
+
+module OVSImager
+  class LinuxBridge
+    def initialize()
+      brctl_out = exec_brtcl
+      @br = parse brctl_out
+    end
+
+    def to_hash()
+      return @br
+    end
+
+    def exec_brtcl()
+      Utils.execute('brctl show')
+    end
+
+    private
+    def parse(str)
+      params = {}
+      str.split(/\n(?=\S)/)[1..-1].map do |br|
+        data = br.split
+        params[data[0]] = {
+          :name => data[0],
+          :id => data[1],
+          :stp => data[2],
+          :interfaces => [data[0]] + data[3..-1],
+        }
+      end
+      params
+    end
+  end
+end

data/lib/ovsimager/ovsimager.rb

@@ -0,0 +1,145 @@
+require 'optparse'
+require_relative 'ovsvs'
+require_relative 'linuxbridge'
+require_relative 'ipnetns'
+require_relative 'tcpdump'
+require_relative 'dotwriter'
+
+module OVSImager
+  class OVSImager
+    DOT_FILENAME = 'interfaces.dot'
+    PNG_FILENAME = 'interfaces.png'
+
+    def initialize(dump_mode=false, ping_from=nil, ping_to=nil)
+      @netns = IPNetNS.new
+      @ifaces = @netns.ifaces_hash
+      @linbr = LinuxBridge.new
+      @ovsvs = OVSVS.new
+
+      @dotwriter = DotWriter.new(DOT_FILENAME)
+
+      @dump_mode = dump_mode
+      @mark = {}
+      @dump_result = {}
+      @ping_from = ping_from
+      @ping_to = ping_to
+      @done = {'lo' => true}
+    end
+
+    def parse_options
+      OptionParser.new do |opts|
+        opts.banner = "Usage: #$0 [options]"
+        opts.on("-d", "--dump",
+                "enable dump mode (trace ping -s 400 packets)") do
+          @dump_mode = true
+        end
+        opts.on("-f ADDRESS", "--from ADDRESS",
+                "send ping from specified address") do |v|
+          @ping_from = v
+        end
+        opts.on("-t ADDRESS", "--to ADDRESS",
+                "send ping to specified address") do |v|
+          @ping_to = v
+        end
+      end.parse!
+    end
+
+    def execute_dump
+      return unless @dump_mode
+      tcpdump = TcpDump.new(@ping_from && @ping_to, @ping_from, @ping_to)
+      @dump_result = tcpdump.test(@ifaces)
+      @dump_result.each do |(iface, result)|
+        if result[0] && result[2]
+          @mark[iface] = '*'
+        elsif result[0]
+          @mark[iface] = '>'
+        elsif result[2]
+          @mark[iface] = '<'
+        end
+      end
+    end
+
+    def show_all
+      show_ovsvs
+      puts '-' * 80
+      show_linbr
+      puts '-' * 80
+      show_netns
+      @dotwriter.finish(PNG_FILENAME) if @dotwriter
+      @dotwriter = nil
+    end
+
+    private
+    def show_iface_common(name, inet, patch, tag='', ns='')
+      puts "    [#{@mark[name]||' '}] #{name}#{tag}#{patch}\t" +
+        "#{inet.join(',')}\t#{ns}"
+    end
+
+    def show_iface(iface)
+      patch = iface[:peer] ? " <-> #{iface[:peer]}" : ''
+      show_iface_common(iface[:name], iface[:inet], patch)
+    end
+
+    def show_ovsvs
+      @ovsvs.to_hash[:bridges].each do |br|
+        puts "OVS Bridge #{br[:name]}:"
+        @dotwriter.br_begin(br[:name], 'OVS ')
+
+        br[:ports].each do |port|
+          name = port[:name]
+          iface = @ifaces[name] || {}
+          inet = iface[:inet] || []
+          tag = port[:tag] ? ' (tag=' + port[:tag] + ')' : ''
+          peer = port[:peer] || iface[:peer]
+          remote = port[:remote_ip] ?
+            " #{port[:local_ip] || ''} => #{port[:remote_ip]}" : ''
+          patch = peer ? ' <-> ' + peer : remote
+          ns = iface[:ns] == :root ? '' : iface[:ns]
+
+          show_iface_common(name, inet, patch, tag, ns)
+          @dotwriter.br_iface(name, @mark[name], @dump_result[name],
+                             inet, tag, peer, remote)
+          @done[name] = true
+        end
+        @dotwriter.br_end
+      end
+    end
+
+    def show_linbr
+      @linbr.to_hash.each do |name, br|
+        puts "Bridge #{name}"
+        @dotwriter.br_begin(name, '')
+        br[:interfaces].each do |ifname|
+          iface = @ifaces[ifname]
+          @dotwriter.br_iface(ifname, @mark[ifname], @dump_result[ifname],
+                              iface[:inet], iface[:tag], iface[:peer])
+          show_iface iface
+          @done[ifname] = true
+        end
+        @dotwriter.br_end
+      end
+    end
+
+    def show_netns
+      @netns.to_hash.each do |name, ifaces|
+        puts "Namespace #{name}"
+        @dotwriter.ns_begin(name)
+        ifaces.each do |iface|
+          ifname = iface[:name]
+          if ifname != 'lo' and !iface[:inet].empty?
+            if @done[ifname]
+              @dotwriter.ns_br_iface(ifname)
+            else
+              @dotwriter.ns_iface(ifname, @mark[ifname], @dump_result[ifname],
+                                  iface[:inet], iface[:tag], iface[:peer])
+            end
+          end
+          show_iface iface unless @done[iface[:name]]
+          @done[iface[:name]] = true
+        end
+        @dotwriter.ns_end
+      end
+    end
+
+  end
+end

data/lib/ovsimager/ovsvs.rb

@@ -0,0 +1,72 @@
+require_relative 'utils'
+
+module OVSImager
+  class OVSVS
+    def initialize()
+      vsctl_out = exec_vstcl
+      @vs = parse(vsctl_out, ['bridge', 'port', 'interface'])
+      @vs[:bridges] ||= []
+
+      # Mark the peer port.
+      @vs[:bridges].each do |br|
+        br[:ports].each do |port|
+          iface = port[:interfaces][0]
+          if iface[:type] == 'patch' && iface[:options].match(/peer="?(\S+?)"?[,\}]/)
+            port[:peer] = $1
+          end
+          if iface[:type] == 'gre' || iface[:type] == 'vxlan'
+            if iface[:options].match(/remote_ip="?(\S+?)"?[,\}]/)
+              port[:remote_ip] = $1
+            end
+            if iface[:options].match(/local_ip="?(\S+?)"?[,\}]/)
+              port[:local_ip] = $1
+            end
+          end
+        end
+      end
+
+      # Move the port that has the same name with the interface to first.
+      @vs[:bridges].each do |vs|
+        vs[:ports].sort!{|a, b|
+          vs[:name] == a[:name] ? -1 : vs[:name] == b[:name] ? 1 :
+          a[:ns] == b[:ns] ? a[:name] <=> b[:name] : a[:ns] <=> b[:ns]
+        }
+      end
+    end
+
+    def to_hash()
+      return @vs
+    end
+
+    def exec_vstcl()
+      begin
+        Utils.execute('ovs-vsctl show', root=true)
+      rescue
+        ''
+      end
+    end
+
+    private
+    def parse(str, types)
+      name, attrs = str.split(/\n/, 2)
+      return {} unless name
+      name.gsub!(/^\"|\"$/, '')
+      params = {:name => name}
+      return params unless attrs
+
+      indent = attrs.match(/^(\s*)/)[1]
+      attrs.gsub!(/^#{indent}([^ ]*):\s+"?(.*?)"?\s*(?:$|\n)/) do |m|
+        params[$1.to_sym] = $2
+        ''
+      end
+      return params if types.empty?
+
+      params[(types[0]+'s').downcase.to_sym] =
+          attrs.split(/\s+#{types[0]} /i)[1..-1].map do |cstr|
+        parse(cstr, types[1..-1])
+      end
+
+      return params
+    end
+  end
+end

data/lib/ovsimager/tcpdump.rb

@@ -0,0 +1,64 @@
+require 'time'
+
+module OVSImager
+  class TcpDump
+    SIZE = 400
+    def initialize(ping=false, from=nil, to=nil)
+      throw 'must be root.' if Process::UID.eid != 0
+      @ping = ping
+      @from = from
+      @to = to
+    end
+
+    def test(ifaces)
+      result = {}
+      ping = nil
+      if @ping
+        puts "Sending ping from #{@from} to #{@to} ..."
+        ping = IO.popen("ping -s #{SIZE} -c 15 -I #{@from} #{@to} >/dev/null", "r")
+      end
+
+      threads = ifaces.map do |(iface, iref)|
+        Thread.new do
+          Thread.current[:iface] = iface
+          ns = iref[:ns]
+          nscmd = ns == :root ? '' : "ip netns exec #{ns} "
+          dump = IO.popen("exec #{nscmd}tcpdump -v -l -n -i #{iface} \\( icmp or udp port 4789 \\) and greater #{SIZE} 2>&1", "r")
+          puts dump.gets
+          time_end = Time.now + 5
+          req_from = req_to = rep_from = rep_to = nil
+          while (waitmax = time_end - Time.now) > 0 do
+            rs, ws, = IO.select([dump], [], [], waitmax)
+            break unless rs
+            if r = rs[0]
+              msg = r.gets
+              break unless msg
+              # puts msg
+              if msg.match(/length #{SIZE+8}/) &&
+                  msg.match(/([\da-f\.:]+) > ([\da-f\.:]+): ICMP echo (request|reply)/)
+                if $3 == 'request'
+                  req_from = $1
+                  req_to = $2
+                else
+                  rep_from = $1
+                  rep_to = $2
+                end
+                break if req_from && req_to && rep_from && rep_to
+              end
+            end
+          end
+          puts "Killing tcpdump(#{dump.pid}) on interface #{iface}."
+          Process.kill('TERM', dump.pid)
+          dump.close
+          result[iface] = [req_from, req_to, rep_from, rep_to]
+        end
+      end
+      threads.each {|th| th.join(10)}
+      if @ping
+        Process.kill('TERM', ping.pid)
+        ping.close
+      end
+      return result
+    end
+  end
+end

data/lib/ovsimager/utils.rb

@@ -0,0 +1,19 @@
+require 'open3'
+
+module OVSImager
+  class Utils
+    def self.get_root_helper(root=true)
+      return '' if not root or Process::UID.eid == 0
+      root ? 'sudo ' : ''
+    end
+
+    def self.execute(cmd, root=false)
+      root_helper = self.get_root_helper(root)
+      out = `#{root_helper}#{cmd}`
+      if $? != 0
+        raise "command execution failure: #{$?}"
+      end
+      return out
+    end
+  end
+end

data/lib/ovsimager/version.rb

@@ -0,0 +1,3 @@
+module OVSImager
+  VERSION = "0.0.2"
+end

data/ovsimager.gemspec

@@ -0,0 +1,24 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'ovsimager/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "ovsimager"
+  spec.version       = OVSImager::VERSION
+  spec.authors       = ["NeoCat"]
+  spec.email         = ["neocat@neocat.jp"]
+  spec.summary       = %q{Draw graph of Open vSwitch virtual bridges.}
+  spec.description   = %q{OVSImager draws a graph that describes relationship among Open vSwitch bridges, Linux bridges, and namespaces for routing. It can also mark the ports where ping packets went through using tcpdump, which is a useful feature for trouble-shooting in SDN environments. }
+  spec.homepage      = ""
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.7"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec"
+end

data/spec/ovsimager_spec.rb

@@ -0,0 +1,11 @@
+require 'spec_helper'
+
+describe Ovsimager do
+  it 'has a version number' do
+    expect(Ovsimager::VERSION).not_to be nil
+  end
+
+  it 'does something useful' do
+    expect(false).to eq(true)
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,2 @@
+$LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
+require 'ovsimager'

metadata

@@ -0,0 +1,114 @@
+--- !ruby/object:Gem::Specification
+name: ovsimager
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+platform: ruby
+authors:
+- NeoCat
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-08-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: 'OVSImager draws a graph that describes relationship among Open vSwitch
+  bridges, Linux bridges, and namespaces for routing. It can also mark the ports where
+  ping packets went through using tcpdump, which is a useful feature for trouble-shooting
+  in SDN environments. '
+email:
+- neocat@neocat.jp
+executables:
+- ovsimager
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/ovsimager
+- lib/ovsimager.rb
+- lib/ovsimager/dotwriter.rb
+- lib/ovsimager/ipnetns.rb
+- lib/ovsimager/linuxbridge.rb
+- lib/ovsimager/ovsimager.rb
+- lib/ovsimager/ovsvs.rb
+- lib/ovsimager/tcpdump.rb
+- lib/ovsimager/utils.rb
+- lib/ovsimager/version.rb
+- ovsimager.gemspec
+- sample-interfaces.png
+- sample-ping-trace.png
+- spec/ovsimager_spec.rb
+- spec/spec_helper.rb
+homepage: ''
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.3
+signing_key: 
+specification_version: 4
+summary: Draw graph of Open vSwitch virtual bridges.
+test_files:
+- spec/ovsimager_spec.rb
+- spec/spec_helper.rb