packetgen 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b95374a3ba00773c1a45e0464a797b1173aa4285
-  data.tar.gz: 4a6e2f8b12b6552de7afdca695e99221453439c1
+  metadata.gz: 7d79b3046c42fa081a32cbb80633d26115aa8d8a
+  data.tar.gz: 554c95accb7cba2eb8fd1199962b76c914d479dd
 SHA512:
-  metadata.gz: 95ddd04f2758a1ef9f17d0b343ea9b00f718ad926adbf13bdd3bc9444e3d8a3cf980a8a8c7e3f5ebebf27a775da676f1754f86cf1dd15756c03fa76a1901184c
-  data.tar.gz: 145591b54094dcac9690e483138f123597029b12659c95d5ee1d7c14865f654003b17c24fd75a46647fe6c0864bccdff69bfd6e7e28623e2b3024628c447d073
+  metadata.gz: 4543ec99fea03226b5a0acaf712f49e2683910953d852dcdff5ec1d71e3ec7e908efb32ee7a5e9707ed0bfe8ec33fba757922a7c0ae4a99e84401e8454e934f0
+  data.tar.gz: e4c77821a111d8d0b921c87067d3a890c2efd23d2127b0655863ca7b062ac1546746a9d2e0690b3622cc73e355b7592fbe34bbb2b75c3e7770d6ee82e2065a6a

data/.travis.yml

@@ -11,4 +11,4 @@ install:
   - bundler install --path vendor/bundle --jobs=3 --retry=3
 script:
   - bundler exec rake
-  - rvmsudo bundle exec rake spec:sudo
+  - rvmsudo bundle exec rake spec:sudo

data/README.md

@@ -1,9 +1,10 @@
 
+[![Gem Version](https://badge.fury.io/rb/packetgen.svg)](https://badge.fury.io/rb/packetgen)
 [![Build Status](https://travis-ci.org/sdaubert/packetgen.svg?branch=master)](https://travis-ci.org/sdaubert/packetgen)
 
 # PacketGen
 
-PacketGen aims at generate and capture network packets easily.
+PacketGen provides simple ways to generate, send and capture network packets easily.
 
 ## Why PacketGen
 Why create PacketGen ? There is already PacketFu!
@@ -17,7 +18,11 @@ Yes. But PacketFu is limited:
 
 ## use cases
 
-For now, PacketGen is only a concept...
+These use cases are the roadmap for PacketGen.
+
+Not yet implemented:
+- encapsulation/decapsulation
+- some protocols...
 
 ### Easily create packets
 ```

data/Rakefile

@@ -8,11 +8,14 @@ RSpec::Core::RakeTask.new do |t|
   t.rspec_opts = '-t ~sudo'
 end
 RSpec::Core::RakeTask.new('spec:sudo') do |t|
-  t.rspec_opts = '-t sudo'
+  if ENV['TRAVIS']
+    t.rspec_opts = '-t sudo -t ~notravis'
+  else
+    t.rspec_opts = '-t sudo'
+  end
 end
 
 YARD::Rake::YardocTask.new do |t|
   t.options = ['--no-private']
   t.files = ['lib/**/*.rb', '-', 'LICENSE']
 end
-

data/lib/packetgen/header/header_methods.rb

@@ -42,7 +42,7 @@ module PacketGen
       # @raise FormatError +header+ not in a packet
       def ip_header(header)
         hid = header_id(header)
-        iph = packet.headers[0...hid].reverse.find { |h| h.is_a? IP }
+        iph = packet.headers[0...hid].reverse.find { |h| h.is_a? IP or h.is_a? IPv6 }
         raise FormatError, 'no IP or IPv6 header in packet' if iph.nil?
         iph
       end

data/lib/packetgen/header/ip.rb

@@ -1,3 +1,5 @@
+require 'socket'
+
 module PacketGen
   module Header
 
@@ -275,6 +277,25 @@ module PacketGen
         first_byte = [(version << 4) | ihl].pack('C')
         first_byte << to_a[2..-1].map { |field| field.to_s }.join
       end
+
+      # Get IP part of pseudo header sum.
+      # @return [Integer]
+      def pseudo_header_sum
+        sum = self[:src].to_i + self[:dst].to_i
+        (sum >> 16) + (sum & 0xffff)
+      end
+
+      # Send IP packet on wire.
+      #
+      # When sending packet at IP level, +sum+ and +length+ fields are set by
+      # kernel, so bad IP packets cannot be sent this way. To do so, use {Eth#to_w}.
+      # @param [String,nil] iface interface name. Not used
+      # @return [void]
+      def to_w(iface=nil)
+        sock = Socket.new(Socket::AF_INET, Socket::SOCK_RAW, Socket::IPPROTO_RAW)
+        sockaddrin = Socket.sockaddr_in(0, dst)
+        sock.send to_s, 0, sockaddrin
+      end
     end
 
     Eth.bind_header IP, proto: 0x800

data/lib/packetgen/header/ipv6.rb

@@ -1,3 +1,4 @@
+# coding: utf-8
 require 'ipaddr'
 
 module PacketGen
@@ -207,6 +208,45 @@ module PacketGen
         first32 = (version << 28) | (traffic_class << 20) | flow_label
         [first32].pack('N') << to_a[3..-1].map { |field| field.to_s }.join
       end
+
+      # Get IPv6 part of pseudo header sum.
+      # @return [Integer]
+      def pseudo_header_sum
+        sum = 0
+        self[:src].each { |word| sum += word.to_i }
+        self[:dst].each { |word| sum += word.to_i }
+        sum
+      end
+      
+      # Send IPv6 packet on wire.
+      #
+      # When sending packet at IPv6 level, +version+, +flow_label+ and +length+
+      # fields are set by kernel. Source address should be a unicast address
+      # assigned to the host. To set any of this fields, use {Eth#to_w}.
+      # @param [String] iface interface name
+      # @return [void]
+      def to_w(iface=nil)
+        sock = Socket.new(Socket::AF_INET6, Socket::SOCK_RAW, self.next)
+        sockaddrin = Socket.sockaddr_in(0, dst)
+
+        # IPv6 RAW sockets don't have IPHDRINCL option to send IPv6 header.
+        # So, header must be built using ancillary data.
+        # Only src address, traffic_class and hop_limit can be set this way.
+        hop_limit = Socket::AncillaryData.int(Socket::AF_INET6,
+                                              Socket::IPPROTO_IPV6,
+                                              Socket::IPV6_HOPLIMIT, hop)
+        tc = Socket::AncillaryData.int(Socket::AF_INET6,
+                                       Socket::IPPROTO_IPV6,
+                                       Socket::IPV6_TCLASS,
+                                       traffic_class)
+
+        # src address is set through PKT_INFO, which needs interface index.
+        ifaddr = Socket.getifaddrs.find { |ia| ia.name == iface }
+        raise WireError, "unknown #{iface} interface" if ifaddr.nil?
+        pkt_info = Socket::AncillaryData.ipv6_pktinfo(Addrinfo.ip(src), ifaddr.ifindex)
+
+        sock.sendmsg body.to_s, 0, sockaddrin, hop_limit, tc, pkt_info
+      end
     end
 
     Eth.bind_header IPv6, proto: 0x86DD

data/lib/packetgen/header/udp.rb

@@ -45,10 +45,7 @@ module PacketGen
       # @return [Integer]
       def calc_sum
         ip = ip_header(self)
-        sum = ip[:src].to_i >> 16
-        sum += ip[:src].to_i & 0xffff
-        sum += ip[:dst].to_i >> 16
-        sum += ip[:dst].to_i & 0xffff
+        sum = ip.pseudo_header_sum
         sum += IP_PROTOCOL
         sum += length
         sum += sport
@@ -129,5 +126,6 @@ module PacketGen
     end
 
     IP.bind_header UDP, proto: UDP::IP_PROTOCOL
+    IPv6.bind_header UDP, next: UDP::IP_PROTOCOL
   end
 end

data/lib/packetgen/packet.rb

@@ -211,8 +211,8 @@ module PacketGen
     # Recalculate all calculatable fields (for now: length and sum)
     # @return [void]
     def calc
-      calc_sum
       calc_length
+      calc_sum
     end
 
     # Get packet body

data/lib/packetgen/version.rb

@@ -3,5 +3,5 @@
 # @author Sylvain Daubert
 module PacketGen
   # PacketGen version
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

data/packetgen.gemspec

@@ -20,6 +20,8 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
+  spec.required_ruby_version = '>= 2.1.0'
+
   spec.add_dependency 'pcaprub', '~>0.12.4'
 
   spec.add_development_dependency 'bundler', '~> 1.7'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: packetgen
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Sylvain Daubert
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2016-12-06 00:00:00.000000000 Z
+date: 2016-12-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: pcaprub
@@ -140,7 +140,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 2.1.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="