redhound 1.0.1 → 2.0.0.rc2

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: redhound
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 2.0.0.rc2
 platform: ruby
 authors:
 - Yudai Takada
 bindir: exe
 cert_chain: []
-date: 2025-01-17 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
 description: Redhound is a pure Ruby packet analyzer that can be used to capture and
   analyze network packets.
@@ -19,71 +19,193 @@ extensions: []
 extra_rdoc_files: []
 files:
 - CHANGELOG.md
-- CODE_OF_CONDUCT.md
-- Dockerfile
 - LICENSE.txt
 - README.md
-- Rakefile
-- Steepfile
-- docker-compose.yml
+- docs/API.md
+- docs/FILTERS.md
+- docs/MIGRATION.md
+- docs/PROTOCOLS.md
+- docs/USAGE.md
+- docs/VALIDATION.md
+- docs/json-schema.json
 - exe/redhound
 - lib/redhound.rb
-- lib/redhound/analyzer.rb
-- lib/redhound/builder.rb
-- lib/redhound/builder/packet_mreq.rb
-- lib/redhound/builder/socket.rb
-- lib/redhound/command.rb
-- lib/redhound/l2.rb
-- lib/redhound/l2/ether.rb
-- lib/redhound/l2/protocol.rb
-- lib/redhound/l3.rb
-- lib/redhound/l3/arp.rb
-- lib/redhound/l3/base.rb
-- lib/redhound/l3/ipv4.rb
-- lib/redhound/l3/ipv6.rb
-- lib/redhound/l3/protocol.rb
-- lib/redhound/l3/resolver.rb
-- lib/redhound/l4.rb
-- lib/redhound/l4/base.rb
-- lib/redhound/l4/icmp.rb
-- lib/redhound/l4/resolver.rb
-- lib/redhound/l4/udp.rb
-- lib/redhound/receiver.rb
-- lib/redhound/resolver.rb
-- lib/redhound/source.rb
-- lib/redhound/source/socket.rb
+- lib/redhound/analysis.rb
+- lib/redhound/analysis/flow_key.rb
+- lib/redhound/analysis/flow_table.rb
+- lib/redhound/analysis/ip_reassembler.rb
+- lib/redhound/analysis/stats.rb
+- lib/redhound/analysis/tcp_analysis.rb
+- lib/redhound/analysis/tcp_reassembler.rb
+- lib/redhound/analysis/tcp_stream.rb
+- lib/redhound/capture.rb
+- lib/redhound/capture/bsd/bpf_device.rb
+- lib/redhound/capture/bsd/constants.rb
+- lib/redhound/capture/bsd/ifreq.rb
+- lib/redhound/capture/file_source.rb
+- lib/redhound/capture/interface.rb
+- lib/redhound/capture/linktype.rb
+- lib/redhound/capture/linux/constants.rb
+- lib/redhound/capture/linux/cooked.rb
+- lib/redhound/capture/linux/ifreq.rb
+- lib/redhound/capture/linux/packet_socket.rb
+- lib/redhound/capture/linux/sockaddr_ll.rb
+- lib/redhound/capture/linux/tpacket_v3.rb
+- lib/redhound/capture/source.rb
+- lib/redhound/capture/stats.rb
+- lib/redhound/cli/command.rb
+- lib/redhound/cli/options.rb
+- lib/redhound/cli/privileges.rb
+- lib/redhound/cli/runner.rb
+- lib/redhound/context.rb
+- lib/redhound/cursor.rb
+- lib/redhound/diagnostic.rb
+- lib/redhound/dissector.rb
+- lib/redhound/engine.rb
+- lib/redhound/errors.rb
+- lib/redhound/field.rb
+- lib/redhound/file/format.rb
+- lib/redhound/file/pcap_reader.rb
+- lib/redhound/file/pcap_writer.rb
+- lib/redhound/file/pcapng_reader.rb
+- lib/redhound/file/pcapng_writer.rb
+- lib/redhound/file/rotating_writer.rb
+- lib/redhound/filter.rb
+- lib/redhound/filter/analyzer.rb
+- lib/redhound/filter/bpf/assembler.rb
+- lib/redhound/filter/bpf/disassembler.rb
+- lib/redhound/filter/bpf/validator.rb
+- lib/redhound/filter/bpf/vm.rb
+- lib/redhound/filter/codegen.rb
+- lib/redhound/filter/lexer.rb
+- lib/redhound/filter/parser.rb
+- lib/redhound/filter/program.rb
+- lib/redhound/layer.rb
+- lib/redhound/output/fields.rb
+- lib/redhound/output/follow.rb
+- lib/redhound/output/hexdump.rb
+- lib/redhound/output/json.rb
+- lib/redhound/output/summary.rb
+- lib/redhound/output/timestamp.rb
+- lib/redhound/output/tree.rb
+- lib/redhound/packet.rb
+- lib/redhound/protocols/arp.rb
+- lib/redhound/protocols/checksum.rb
+- lib/redhound/protocols/data.rb
+- lib/redhound/protocols/dhcp.rb
+- lib/redhound/protocols/dns.rb
+- lib/redhound/protocols/ethernet.rb
+- lib/redhound/protocols/http.rb
+- lib/redhound/protocols/icmp.rb
+- lib/redhound/protocols/ipv4.rb
+- lib/redhound/protocols/ipv6.rb
+- lib/redhound/protocols/link.rb
+- lib/redhound/protocols/llc.rb
+- lib/redhound/protocols/ntp.rb
+- lib/redhound/protocols/tcp.rb
+- lib/redhound/protocols/tls.rb
+- lib/redhound/protocols/tunnel.rb
+- lib/redhound/protocols/udp.rb
+- lib/redhound/protocols/vlan.rb
+- lib/redhound/reader.rb
+- lib/redhound/registry.rb
+- lib/redhound/stream_dissector.rb
+- lib/redhound/util/seq.rb
 - lib/redhound/version.rb
 - lib/redhound/writer.rb
-- rbs_collection.lock.yaml
-- rbs_collection.yaml
-- sig/generated/redhound/analyzer.rbs
-- sig/generated/redhound/builder/packet_mreq.rbs
-- sig/generated/redhound/builder/socket.rbs
-- sig/generated/redhound/command.rbs
-- sig/generated/redhound/l2/ether.rbs
-- sig/generated/redhound/l2/protocol.rbs
-- sig/generated/redhound/l3/arp.rbs
-- sig/generated/redhound/l3/base.rbs
-- sig/generated/redhound/l3/ipv4.rbs
-- sig/generated/redhound/l3/ipv6.rbs
-- sig/generated/redhound/l3/protocol.rbs
-- sig/generated/redhound/l3/resolver.rbs
-- sig/generated/redhound/l4/base.rbs
-- sig/generated/redhound/l4/icmp.rbs
-- sig/generated/redhound/l4/resolver.rbs
-- sig/generated/redhound/l4/udp.rbs
-- sig/generated/redhound/receiver.rbs
-- sig/generated/redhound/resolver.rbs
-- sig/generated/redhound/source/socket.rbs
+- sig/generated/redhound.rbs
+- sig/generated/redhound/analysis.rbs
+- sig/generated/redhound/analysis/flow_key.rbs
+- sig/generated/redhound/analysis/flow_table.rbs
+- sig/generated/redhound/analysis/ip_reassembler.rbs
+- sig/generated/redhound/analysis/stats.rbs
+- sig/generated/redhound/analysis/tcp_analysis.rbs
+- sig/generated/redhound/analysis/tcp_reassembler.rbs
+- sig/generated/redhound/analysis/tcp_stream.rbs
+- sig/generated/redhound/capture.rbs
+- sig/generated/redhound/capture/bsd/bpf_device.rbs
+- sig/generated/redhound/capture/bsd/constants.rbs
+- sig/generated/redhound/capture/bsd/ifreq.rbs
+- sig/generated/redhound/capture/file_source.rbs
+- sig/generated/redhound/capture/interface.rbs
+- sig/generated/redhound/capture/linktype.rbs
+- sig/generated/redhound/capture/linux/constants.rbs
+- sig/generated/redhound/capture/linux/cooked.rbs
+- sig/generated/redhound/capture/linux/ifreq.rbs
+- sig/generated/redhound/capture/linux/packet_socket.rbs
+- sig/generated/redhound/capture/linux/sockaddr_ll.rbs
+- sig/generated/redhound/capture/linux/tpacket_v3.rbs
+- sig/generated/redhound/capture/source.rbs
+- sig/generated/redhound/capture/stats.rbs
+- sig/generated/redhound/cli/command.rbs
+- sig/generated/redhound/cli/options.rbs
+- sig/generated/redhound/cli/privileges.rbs
+- sig/generated/redhound/cli/runner.rbs
+- sig/generated/redhound/context.rbs
+- sig/generated/redhound/cursor.rbs
+- sig/generated/redhound/diagnostic.rbs
+- sig/generated/redhound/dissector.rbs
+- sig/generated/redhound/engine.rbs
+- sig/generated/redhound/errors.rbs
+- sig/generated/redhound/field.rbs
+- sig/generated/redhound/file/format.rbs
+- sig/generated/redhound/file/pcap_reader.rbs
+- sig/generated/redhound/file/pcap_writer.rbs
+- sig/generated/redhound/file/pcapng_reader.rbs
+- sig/generated/redhound/file/pcapng_writer.rbs
+- sig/generated/redhound/file/rotating_writer.rbs
+- sig/generated/redhound/filter.rbs
+- sig/generated/redhound/filter/analyzer.rbs
+- sig/generated/redhound/filter/bpf/assembler.rbs
+- sig/generated/redhound/filter/bpf/disassembler.rbs
+- sig/generated/redhound/filter/bpf/validator.rbs
+- sig/generated/redhound/filter/bpf/vm.rbs
+- sig/generated/redhound/filter/codegen.rbs
+- sig/generated/redhound/filter/lexer.rbs
+- sig/generated/redhound/filter/parser.rbs
+- sig/generated/redhound/filter/program.rbs
+- sig/generated/redhound/layer.rbs
+- sig/generated/redhound/output/fields.rbs
+- sig/generated/redhound/output/follow.rbs
+- sig/generated/redhound/output/hexdump.rbs
+- sig/generated/redhound/output/json.rbs
+- sig/generated/redhound/output/summary.rbs
+- sig/generated/redhound/output/timestamp.rbs
+- sig/generated/redhound/output/tree.rbs
+- sig/generated/redhound/packet.rbs
+- sig/generated/redhound/protocols/arp.rbs
+- sig/generated/redhound/protocols/checksum.rbs
+- sig/generated/redhound/protocols/data.rbs
+- sig/generated/redhound/protocols/dhcp.rbs
+- sig/generated/redhound/protocols/dns.rbs
+- sig/generated/redhound/protocols/ethernet.rbs
+- sig/generated/redhound/protocols/http.rbs
+- sig/generated/redhound/protocols/icmp.rbs
+- sig/generated/redhound/protocols/ipv4.rbs
+- sig/generated/redhound/protocols/ipv6.rbs
+- sig/generated/redhound/protocols/link.rbs
+- sig/generated/redhound/protocols/llc.rbs
+- sig/generated/redhound/protocols/ntp.rbs
+- sig/generated/redhound/protocols/tcp.rbs
+- sig/generated/redhound/protocols/tls.rbs
+- sig/generated/redhound/protocols/tunnel.rbs
+- sig/generated/redhound/protocols/udp.rbs
+- sig/generated/redhound/protocols/vlan.rbs
+- sig/generated/redhound/reader.rbs
+- sig/generated/redhound/registry.rbs
+- sig/generated/redhound/stream_dissector.rbs
+- sig/generated/redhound/util/seq.rbs
 - sig/generated/redhound/version.rbs
 - sig/generated/redhound/writer.rbs
+- sig/shims/io.rbs
+- sig/shims/process.rbs
 homepage: https://github.com/ydah/redhound
 licenses:
 - MIT
 metadata:
   homepage_uri: https://github.com/ydah/redhound
-  source_code_uri: https://github.com/ydah/redhound
-  documentation_uri: https://github.com/ydah/redhound
+  source_code_uri: https://github.com/ydah/redhound/tree/main
+  documentation_uri: https://github.com/ydah/redhound/blob/main/docs/API.md
   changelog_uri: https://github.com/ydah/redhound/releases
   bug_tracker_uri: https://github.com/ydah/redhound/issues
   rubygems_mfa_required: 'true'
@@ -101,7 +223,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.7.0.dev
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Pure Ruby packet analyzer
 test_files: []

data/CODE_OF_CONDUCT.md

@@ -1,132 +0,0 @@
-# Contributor Covenant Code of Conduct
-
-## Our Pledge
-
-We as members, contributors, and leaders pledge to make participation in our
-community a harassment-free experience for everyone, regardless of age, body
-size, visible or invisible disability, ethnicity, sex characteristics, gender
-identity and expression, level of experience, education, socio-economic status,
-nationality, personal appearance, race, caste, color, religion, or sexual
-identity and orientation.
-
-We pledge to act and interact in ways that contribute to an open, welcoming,
-diverse, inclusive, and healthy community.
-
-## Our Standards
-
-Examples of behavior that contributes to a positive environment for our
-community include:
-
-* Demonstrating empathy and kindness toward other people
-* Being respectful of differing opinions, viewpoints, and experiences
-* Giving and gracefully accepting constructive feedback
-* Accepting responsibility and apologizing to those affected by our mistakes,
-  and learning from the experience
-* Focusing on what is best not just for us as individuals, but for the overall
-  community
-
-Examples of unacceptable behavior include:
-
-* The use of sexualized language or imagery, and sexual attention or advances of
-  any kind
-* Trolling, insulting or derogatory comments, and personal or political attacks
-* Public or private harassment
-* Publishing others' private information, such as a physical or email address,
-  without their explicit permission
-* Other conduct which could reasonably be considered inappropriate in a
-  professional setting
-
-## Enforcement Responsibilities
-
-Community leaders are responsible for clarifying and enforcing our standards of
-acceptable behavior and will take appropriate and fair corrective action in
-response to any behavior that they deem inappropriate, threatening, offensive,
-or harmful.
-
-Community leaders have the right and responsibility to remove, edit, or reject
-comments, commits, code, wiki edits, issues, and other contributions that are
-not aligned to this Code of Conduct, and will communicate reasons for moderation
-decisions when appropriate.
-
-## Scope
-
-This Code of Conduct applies within all community spaces, and also applies when
-an individual is officially representing the community in public spaces.
-Examples of representing our community include using an official email address,
-posting via an official social media account, or acting as an appointed
-representative at an online or offline event.
-
-## Enforcement
-
-Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported to the community leaders responsible for enforcement at
-[INSERT CONTACT METHOD].
-All complaints will be reviewed and investigated promptly and fairly.
-
-All community leaders are obligated to respect the privacy and security of the
-reporter of any incident.
-
-## Enforcement Guidelines
-
-Community leaders will follow these Community Impact Guidelines in determining
-the consequences for any action they deem in violation of this Code of Conduct:
-
-### 1. Correction
-
-**Community Impact**: Use of inappropriate language or other behavior deemed
-unprofessional or unwelcome in the community.
-
-**Consequence**: A private, written warning from community leaders, providing
-clarity around the nature of the violation and an explanation of why the
-behavior was inappropriate. A public apology may be requested.
-
-### 2. Warning
-
-**Community Impact**: A violation through a single incident or series of
-actions.
-
-**Consequence**: A warning with consequences for continued behavior. No
-interaction with the people involved, including unsolicited interaction with
-those enforcing the Code of Conduct, for a specified period of time. This
-includes avoiding interactions in community spaces as well as external channels
-like social media. Violating these terms may lead to a temporary or permanent
-ban.
-
-### 3. Temporary Ban
-
-**Community Impact**: A serious violation of community standards, including
-sustained inappropriate behavior.
-
-**Consequence**: A temporary ban from any sort of interaction or public
-communication with the community for a specified period of time. No public or
-private interaction with the people involved, including unsolicited interaction
-with those enforcing the Code of Conduct, is allowed during this period.
-Violating these terms may lead to a permanent ban.
-
-### 4. Permanent Ban
-
-**Community Impact**: Demonstrating a pattern of violation of community
-standards, including sustained inappropriate behavior, harassment of an
-individual, or aggression toward or disparagement of classes of individuals.
-
-**Consequence**: A permanent ban from any sort of public interaction within the
-community.
-
-## Attribution
-
-This Code of Conduct is adapted from the [Contributor Covenant][homepage],
-version 2.1, available at
-[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
-
-Community Impact Guidelines were inspired by
-[Mozilla's code of conduct enforcement ladder][Mozilla CoC].
-
-For answers to common questions about this code of conduct, see the FAQ at
-[https://www.contributor-covenant.org/faq][FAQ]. Translations are available at
-[https://www.contributor-covenant.org/translations][translations].
-
-[homepage]: https://www.contributor-covenant.org
-[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
-[Mozilla CoC]: https://github.com/mozilla/diversity
-[FAQ]: https://www.contributor-covenant.org/faq
-[translations]: https://www.contributor-covenant.org/translations

data/Dockerfile

@@ -1,7 +0,0 @@
-FROM ruby:3.3.4
-RUN apt-get update -qq && apt-get install -y build-essential libpq-dev nodejs iputils-ping iproute2 iptables
-WORKDIR /app
-COPY Gemfile /app/Gemfile
-RUN bundle install
-ENV LANG=ja_JP.UTF-8
-ENV TZ=Asia/Tokyo

data/Rakefile

@@ -1,15 +0,0 @@
-# frozen_string_literal: true
-
-require 'bundler/gem_tasks'
-
-desc "steep check"
-task :steep do
-  sh "bundle exec steep check"
-end
-
-desc "Run rbs-inline"
-task :rbs_inline do
-  sh "bundle exec rbs-inline --output lib/"
-end
-
-task default: %i[rbs_inline steep]

data/Steepfile

@@ -1,4 +0,0 @@
-target :lib do
-  signature "sig"
-  check "lib"
-end

data/docker-compose.yml

@@ -1,9 +0,0 @@
-version: '3.7'
-services:
-  app:
-    build: .
-    tty: true
-    ports:
-      - 3000:3000
-    volumes:
-      - .:/app

data/lib/redhound/analyzer.rb

@@ -1,34 +0,0 @@
-# rbs_inline: enabled
-# frozen_string_literal: true
-
-module Redhound
-  class Analyzer
-    # @rbs (msg: String, count: Integer) -> void
-    def self.analyze(msg:, count:)
-      new(msg:, count:).analyze
-    end
-
-    # @rbs (msg: String, count: Integer) -> void
-    def initialize(msg:, count:)
-      @msg = msg
-      @count = count
-    end
-
-    # @rbs () -> void
-    def analyze
-      l2 = L2::Ether.generate(bytes: @msg.bytes[0..], count: @count)
-      l2.dump
-      return unless l2.supported_type?
-
-      l3 = L3::Resolver.resolve(bytes: @msg.bytes[l2.size..], l2:)
-      return if !l3 || @msg.bytes.size <= l2.size + l3.size
-      l3.dump
-      unless l3.supported_protocol?
-        puts "    └─ Unsupported protocol #{l3.protocol}"
-        return
-      end
-
-      L4::Resolver.resolve(bytes: @msg.bytes[(l2.size + l3.size)..], l3:)&.dump
-    end
-  end
-end

data/lib/redhound/builder/packet_mreq.rb

@@ -1,56 +0,0 @@
-# rbs_inline: enabled
-# frozen_string_literal: true
-
-require 'socket'
-
-module Redhound
-  module Builder
-    class PacketMreq
-      PACKET_MR_PROMISC = 0x0001 # NOTE: netpacket/packet.h
-
-      # @rbs (ifname: String) -> void
-      def initialize(ifname:)
-        @ifname = ifname
-      end
-
-      # see: https://man7.org/linux/man-pages/man7/packet.7.html
-      # struct packet_mreq {
-      #   int            mr_ifindex;    /* interface index */
-      #   unsigned short mr_type;       /* action */
-      #   unsigned short mr_alen;       /* address length */
-      #   unsigned char  mr_address[8]; /* physical-layer address */
-      # };
-      # @rbs () -> String
-      def build
-        mr_ifindex + mr_type + mr_alen + mr_address
-      end
-
-      # @rbs () -> String
-      def mr_ifindex
-        @mr_ifindex ||= [[index].pack('I')].pack('a4')
-      end
-
-      private
-
-      # @rbs () -> Integer?
-      def index
-        ::Socket.getifaddrs.find { |ifaddr| ifaddr.name == @ifname }&.ifindex
-      end
-
-      # @rbs () -> String
-      def mr_type
-        @mr_type ||= [PACKET_MR_PROMISC].pack('S')
-      end
-
-      # @rbs () -> String
-      def mr_alen
-        @mr_alen ||= [0].pack('S')
-      end
-
-      # @rbs () -> String
-      def mr_address
-        @mr_address ||= [0].pack('C') * 8
-      end
-    end
-  end
-end

data/lib/redhound/builder/socket.rb

@@ -1,35 +0,0 @@
-# rbs_inline: enabled
-# frozen_string_literal: true
-
-require 'socket'
-
-module Redhound
-  module Builder
-    class Socket
-      SOL_PACKET            = 0x0107 # bits/socket.h
-      PACKET_ADD_MEMBERSHIP = 0x0001 # NOTE: netpacket/packet.h
-      ETH_P_ALL             = 768    # NOTE: htons(ETH_P_ALL) => linux/if_ether.h
-      PACKED_ETH_P_ALL = [ETH_P_ALL].pack('S').unpack1('S>')
-
-      class << self
-        # @rbs (ifname: String) -> Redhound::Source::Socket
-        def build(ifname:)
-          new(ifname:).build
-        end
-      end
-
-      # @rbs (ifname: String) -> void
-      def initialize(ifname:)
-        @mq_req = PacketMreq.new(ifname:)
-      end
-
-      # @rbs () -> Redhound::Source::Socket
-      def build
-        socket = ::Socket.new(::Socket::AF_PACKET, ::Socket::SOCK_RAW, ETH_P_ALL)
-        socket.bind([::Socket::AF_PACKET, PACKED_ETH_P_ALL, @mq_req.mr_ifindex].pack('SS>a16'))
-        socket.setsockopt(SOL_PACKET, PACKET_ADD_MEMBERSHIP, @mq_req.build)
-        Redhound::Source::Socket.new(socket:)
-      end
-    end
-  end
-end

data/lib/redhound/builder.rb

@@ -1,4 +0,0 @@
-# frozen_string_literal: true
-
-require_relative 'builder/packet_mreq'
-require_relative 'builder/socket'

data/lib/redhound/command.rb

@@ -1,67 +0,0 @@
-# rbs_inline: enabled
-# frozen_string_literal: true
-
-require 'optparse'
-require 'socket'
-
-module Redhound
-  class Command
-    # @rbs () -> void
-    def initialize
-      @options = { ifname: nil }
-    end
-
-    # @rbs (Array[untyped] argv) -> void
-    def run(argv)
-      parse(argv)
-      if @options[:ifname].nil?
-        warn 'Error: interface is required'
-        exit 1
-      end
-      Receiver.run(ifname: @options[:ifname], filename: @options[:filename])
-    end
-
-    # @rbs (Array[untyped] argv) -> void
-    def parse(argv)
-      OptionParser.new do |o| # steep:ignore
-        o.banner = <<~'BANNER' + <<~BANNER2
-             ___         ____                     __
-            / _ \___ ___/ / /  ___  __ _____  ___/ /
-           / , _/ -_) _  / _ \/ _ \/ // / _ \/ _  /
-          /_/|_|\__/\_,_/_//_/\___/\_,_/_//_/\_,_/
-
-        BANNER
-          Version: #{Redhound::VERSION}
-          Dump and analyze network packets.
-
-          Usage: redhound [options] ...
-        BANNER2
-        o.separator ''
-        o.separator 'Options:'
-        o.on('-i', '--interface INTERFACE', 'name or idx of interface') { |v| @options[:ifname] = v }
-        o.on('-D', '--list-interfaces', 'print list of interfaces and exit') do
-          list_interfaces
-          exit
-        end
-        o.on('-w FILE', 'write packets to a pcap capture file format to file') { |v| @options[:filename] = v }
-        o.on('-h', '--help', 'display this help and exit') do
-          puts o
-          exit
-        end
-        o.on('-v', '--version', 'display version information and exit') do
-          puts "Redhound #{Redhound::VERSION}"
-          exit
-        end
-        o.on_tail
-        o.parse!(argv)
-      end
-    end
-
-    private
-
-    # @rbs () -> void
-    def list_interfaces
-      ::Socket.getifaddrs.each { |ifaddr| puts ifaddr.name }
-    end
-  end
-end