xlat 0.1.0.alpha1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 126ee3a81f73b95a7d4f4a60ca386ddeb3174cb38f95d9e6fee7767dc67fd3e7
+  data.tar.gz: 8f9ac3aede68f63bed9b284257625a8f24074f7978642d16923d38c544adfaa1
+SHA512:
+  metadata.gz: 95afa491cdaab20b2124c7ba3d54daaa45921af230ba7417dca3446de0d611bddf10263a976423a044b4a0d7344d98bde66a64ff456fc999f20e4c37d1da407d
+  data.tar.gz: b68d8af403aa962e378c133b196d2c5748fc41f2925d5c3cf1658cb02b874477806d36b1f9a358e467d5cbb963374ce5a0bc16873011096d322dcacc7ff84330

data/.dockerignore

@@ -0,0 +1,7 @@
+.git/
+.bundle/
+vendor/
+clab/
+tmp/
+
+Dockerfile

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/Cargo.lock

@@ -0,0 +1,348 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 3
+
+[[package]]
+name = "aho-corasick"
+version = "1.1.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8e60d3430d3a69478ad0993f19238d2df97c507009a52b3c10addcd7f6bcb916"
+dependencies = [
+ "memchr",
+]
+
+[[package]]
+name = "bindgen"
+version = "0.69.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "271383c67ccabffb7381723dea0672a673f292304fcb45c01cc648c7a8d58088"
+dependencies = [
+ "bitflags",
+ "cexpr",
+ "clang-sys",
+ "itertools",
+ "lazy_static",
+ "lazycell",
+ "proc-macro2",
+ "quote",
+ "regex",
+ "rustc-hash",
+ "shlex",
+ "syn",
+]
+
+[[package]]
+name = "bitflags"
+version = "2.8.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8f68f53c83ab957f72c32642f3868eec03eb974d1fb82e453128456482613d36"
+
+[[package]]
+name = "cexpr"
+version = "0.6.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6fac387a98bb7c37292057cffc56d62ecb629900026402633ae9160df93a8766"
+dependencies = [
+ "nom",
+]
+
+[[package]]
+name = "cfg-if"
+version = "1.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "baf1de4339761588bc0619e3cbc0120ee582ebb74b53b4efbf79117bd2da40fd"
+
+[[package]]
+name = "clang-sys"
+version = "1.8.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0b023947811758c97c59bf9d1c188fd619ad4718dcaa767947df1cadb14f39f4"
+dependencies = [
+ "glob",
+ "libc",
+ "libloading",
+]
+
+[[package]]
+name = "either"
+version = "1.13.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "60b1af1c220855b6ceac025d3f6ecdd2b7c4894bfe9cd9bda4fbb4bc7c0d4cf0"
+
+[[package]]
+name = "glob"
+version = "0.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a8d1add55171497b4705a648c6b583acafb01d58050a51727785f0b2c8e0a2b2"
+
+[[package]]
+name = "io_buffer_ext"
+version = "0.0.0"
+dependencies = [
+ "magnus",
+ "rb-sys",
+]
+
+[[package]]
+name = "itertools"
+version = "0.12.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ba291022dbbd398a455acf126c1e341954079855bc60dfdda641363bd6922569"
+dependencies = [
+ "either",
+]
+
+[[package]]
+name = "lazy_static"
+version = "1.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bbd2bcb4c963f2ddae06a2efc7e9f3591312473c50c6685e1f298068316e66fe"
+
+[[package]]
+name = "lazycell"
+version = "1.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "830d08ce1d1d941e6b30645f1a0eb5643013d835ce3779a5fc208261dbe10f55"
+
+[[package]]
+name = "libc"
+version = "0.2.169"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b5aba8db14291edd000dfcc4d620c7ebfb122c613afb886ca8803fa4e128a20a"
+
+[[package]]
+name = "libloading"
+version = "0.8.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fc2f4eb4bc735547cfed7c0a4922cbd04a4655978c09b54f1f7b228750664c34"
+dependencies = [
+ "cfg-if",
+ "windows-targets",
+]
+
+[[package]]
+name = "magnus"
+version = "0.7.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3d87ae53030f3a22e83879e666cb94e58a7bdf31706878a0ba48752994146dab"
+dependencies = [
+ "magnus-macros",
+ "rb-sys",
+ "rb-sys-env",
+ "seq-macro",
+]
+
+[[package]]
+name = "magnus-macros"
+version = "0.6.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5968c820e2960565f647819f5928a42d6e874551cab9d88d75e3e0660d7f71e3"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "memchr"
+version = "2.7.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "78ca9ab1a0babb1e7d5695e3530886289c18cf2f87ec19a575a0abdce112e3a3"
+
+[[package]]
+name = "minimal-lexical"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "68354c5c6bd36d73ff3feceb05efa59b6acb7626617f4962be322a825e61f79a"
+
+[[package]]
+name = "nom"
+version = "7.1.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d273983c5a657a70a3e8f2a01329822f3b8c8172b73826411a55751e404a0a4a"
+dependencies = [
+ "memchr",
+ "minimal-lexical",
+]
+
+[[package]]
+name = "proc-macro2"
+version = "1.0.93"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "60946a68e5f9d28b0dc1c21bb8a97ee7d018a8b322fa57838ba31cc878e22d99"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.38"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0e4dccaaaf89514f546c693ddc140f729f958c247918a13380cccc6078391acc"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "rb-sys"
+version = "0.9.110"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "56cf964f8e44115e50009921ea3d3791b6f74d1ae6d6ed37114fbe03a1cd7308"
+dependencies = [
+ "rb-sys-build",
+]
+
+[[package]]
+name = "rb-sys-build"
+version = "0.9.110"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "161480347f56473107d4135643b6b1909331eec61445e113b256708a28b691c5"
+dependencies = [
+ "bindgen",
+ "lazy_static",
+ "proc-macro2",
+ "quote",
+ "regex",
+ "shell-words",
+ "syn",
+]
+
+[[package]]
+name = "rb-sys-env"
+version = "0.1.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a35802679f07360454b418a5d1735c89716bde01d35b1560fc953c1415a0b3bb"
+
+[[package]]
+name = "regex"
+version = "1.11.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b544ef1b4eac5dc2db33ea63606ae9ffcfac26c1416a2806ae0bf5f56b201191"
+dependencies = [
+ "aho-corasick",
+ "memchr",
+ "regex-automata",
+ "regex-syntax",
+]
+
+[[package]]
+name = "regex-automata"
+version = "0.4.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "809e8dc61f6de73b46c85f4c96486310fe304c434cfa43669d7b40f711150908"
+dependencies = [
+ "aho-corasick",
+ "memchr",
+ "regex-syntax",
+]
+
+[[package]]
+name = "regex-syntax"
+version = "0.8.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2b15c43186be67a4fd63bee50d0303afffcef381492ebe2c5d87f324e1b8815c"
+
+[[package]]
+name = "rustc-hash"
+version = "1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "08d43f7aa6b08d49f382cde6a7982047c3426db949b1424bc4b7ec9ae12c6ce2"
+
+[[package]]
+name = "seq-macro"
+version = "0.3.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a3f0bf26fd526d2a95683cd0f87bf103b8539e2ca1ef48ce002d67aad59aa0b4"
+
+[[package]]
+name = "shell-words"
+version = "1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "24188a676b6ae68c3b2cb3a01be17fbf7240ce009799bb56d5b1409051e78fde"
+
+[[package]]
+name = "shlex"
+version = "1.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0fda2ff0d084019ba4d7c6f371c95d8fd75ce3524c3cb8fb653a3023f6323e64"
+
+[[package]]
+name = "syn"
+version = "2.0.98"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "36147f1a48ae0ec2b5b3bc5b537d267457555a10dc06f3dbc8cb11ba3006d3b1"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.16"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a210d160f08b701c8721ba1c726c11662f877ea6b7094007e1ca9a1041945034"
+
+[[package]]
+name = "windows-targets"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9b724f72796e036ab90c1021d4780d4d3d648aca59e491e6b98e725b84e99973"
+dependencies = [
+ "windows_aarch64_gnullvm",
+ "windows_aarch64_msvc",
+ "windows_i686_gnu",
+ "windows_i686_gnullvm",
+ "windows_i686_msvc",
+ "windows_x86_64_gnu",
+ "windows_x86_64_gnullvm",
+ "windows_x86_64_msvc",
+]
+
+[[package]]
+name = "windows_aarch64_gnullvm"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "32a4622180e7a0ec044bb555404c800bc9fd9ec262ec147edd5989ccd0c02cd3"
+
+[[package]]
+name = "windows_aarch64_msvc"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "09ec2a7bb152e2252b53fa7803150007879548bc709c039df7627cabbd05d469"
+
+[[package]]
+name = "windows_i686_gnu"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8e9b5ad5ab802e97eb8e295ac6720e509ee4c243f69d781394014ebfe8bbfa0b"
+
+[[package]]
+name = "windows_i686_gnullvm"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0eee52d38c090b3caa76c563b86c3a4bd71ef1a819287c19d586d7334ae8ed66"
+
+[[package]]
+name = "windows_i686_msvc"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "240948bc05c5e7c6dabba28bf89d89ffce3e303022809e73deaefe4f6ec56c66"
+
+[[package]]
+name = "windows_x86_64_gnu"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "147a5c80aabfbf0c7d901cb5895d1de30ef2907eb21fbbab29ca94c5b08b1a78"
+
+[[package]]
+name = "windows_x86_64_gnullvm"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "24d5b23dc417412679681396f2b49f3de8c1473deb516bd34410872eff51ed0d"
+
+[[package]]
+name = "windows_x86_64_msvc"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "589f6da84c646204747d1270a2a5661ea66ed1cced2631d546fdfb155959f9ec"

data/Cargo.toml

@@ -0,0 +1,7 @@
+# This Cargo.toml is here to let externals tools (IDEs, etc.) know that this is
+# a Rust project. Your extensions dependencies should be added to the Cargo.toml
+# in the ext/ directory.
+
+[workspace]
+members = ["./ext/xlat/io_buffer_ext"]
+resolver = "2"

data/Dockerfile

@@ -0,0 +1,49 @@
+ARG RUBY=public.ecr.aws/sorah/ruby:3.4-dev
+ARG RUBY_DEV=public.ecr.aws/sorah/ruby:3.4-dev-noble
+
+FROM $RUBY_DEV AS build
+
+RUN --mount=type=cache,target=/var/cache/apt,sharing=locked \
+    --mount=type=cache,target=/var/lib/apt,sharing=locked \
+    apt-get update && \
+    apt-get install -y clang cargo
+
+WORKDIR /app
+COPY . .
+
+RUN bundle config set --local deployment true
+RUN bundle install
+
+RUN bundle exec rake compile
+
+
+###
+
+FROM $RUBY
+
+RUN --mount=type=cache,target=/var/cache/apt,sharing=locked \
+    --mount=type=cache,target=/var/lib/apt,sharing=locked \
+    apt-get update && \
+    apt-get install -y ubuntu-dbgsym-keyring
+
+RUN <<NUR
+. /etc/os-release
+cat <<EOF > /etc/apt/sources.list.d/ddebs.sources
+Types: deb
+URIs: http://ddebs.ubuntu.com
+Suites: ${VERSION_CODENAME} ${VERSION_CODENAME}-updates ${VERSION_CODENAME}-proposed
+Components: main restricted universe multiverse
+EOF
+NUR
+
+RUN --mount=type=cache,target=/var/cache/apt,sharing=locked \
+    --mount=type=cache,target=/var/lib/apt,sharing=locked \
+    apt-get update && \
+    apt-get install -y iproute2 nftables debian-goodies elfutils dctrl-tools && \
+    find-dbgsym-packages --install /usr/bin/ruby
+
+COPY --from=build /app /app
+COPY --from=build /app/.bundle /app/.bundle
+
+ENV BUNDLE_GEMFILE=/app/Gemfile
+ENTRYPOINT ["bundle", "exec", "ruby", "/app/exe/xlat-siit"]

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2024 Sorah Fukumori
+
+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,100 @@
+# Xlat
+
+Userland NAT64 implementation on Linux in Ruby.
+
+## Supported usage
+
+- Stateless NAT64 - [RFC 7915](https://datatracker.ietf.org/doc/rfc7915/)
+  - Maps 1 IPv6 Address : 1 IPv4 Address
+  - Combine with kernel netfilter NAT66 masquerade to archieve stateful NAT64 NAPT functionality (multiple IPv6 address/port : 1 IPv4 Address)
+  - `IPv6(src=nat66outer, dst=pref64n+ipv4) -> IPv4(src=ipv4nat64outer, dst=ipv4)`
+  - `IPv4(src=ipv4, dst=ipv4nat64outer) -> IPv6(src=pref64n+ipv4, dst=nat66outer)`
+
+<!--
+### Todo?
+
+- Stateful NAT64  - [RFC 6146](https://datatracker.ietf.org/doc/rfc6146/)
+  - Maps multiple IPv6 addresses and ports : IPv4 addresses and ports
+-->
+
+## Installation
+
+```ruby
+# Gemfile
+source 'https://rubygems.org'
+gem 'xlat'
+```
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Caveats
+
+- Expecting no difference in IPv4 and IPv6 MTU
+- Fragmented packets are silently discarded
+
+## Tips
+
+### Checksum Neutrality
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+### Benchmarking
+
+Requires: iproute2, trafgen&ifpps from [netsniff-ng](http://netsniff-ng.org/) (v0.6.8 of netsniff-ng has [a bug](https://github.com/netsniff-ng/netsniff-ng/pull/233) and you need to build the development version).
+
+The `benchmark/` directory has `trafgen` scenarios to generate artificial traffic to benchmark Xlat.
+
+```shell
+sudo XLAT_PROFILE=1 XLAT_NOJIT=1 ruby ./benchmark/run.rb ./benchmark/tcp.cfg
+# or if your ruby is managed by rbenv
+sudo XLAT_PROFILE=1 XLAT_NOJIT=1 "$(rbenv which ruby)" ./benchmark/run.rb ./benchmark/tcp.cfg
+```
+
+If `XLAT_PROFILE` variable is set, profile is emitted every 10 seconds at `/tmp/xlat-#{pid}.pf2profile`. You need to disable YJIT by setting `XLAT_NOJIT` variable due to the current limitation of Pf2.
+
+### Profiling with Pf2 in Docker
+
+Requires: Docker, containerlab, iproute2, iperf3.
+
+```shell
+cd clab/
+./build
+containerlab deploy --reconfigure
+sudo ip netns exec clab-464xlat-ue-pd-sv iperf3 -s
+
+# in another session:
+sudo ip netns exec clab-464xlat-ue-pd-ue iperf3 -c 64:ff9b::192.0.2.80
+docker kill --signal=USR1 clab-464xlat-ue-pd-plat
+docker cp clab-464xlat-ue-pd-plat:/tmp/xlat-1.pf2profile .
+pf2 report ./xlat-1.pf2profile -o ./xlat.json
+```
+
+### Fuzzing
+
+Requires: CRuby built with clang compiler.
+
+`fuzz/run` performs fuzzing against the parsers and `Xlat::Rfc7915` translator.
+
+```shell
+./fuzz/run
+```
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/xlat.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+### Credits
+
+- Copyright (c) 2024 Sorah Fukumori
+- Copyright (c) 2022 Kazuho Oku
+  - Some part of this source code are based on the source code at https://github.com/kazuho/rat available under MIT License

data/Rakefile

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+require "rake/extensiontask"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec
+
+Rake::ExtensionTask.new("xlat/io_buffer_ext",
+  Gem::Specification.load("xlat.gemspec")) do |ext|
+  ext.lib_dir = "lib/xlat"
+end
+
+task spec: :compile
+
+
+directory 'doc'
+
+file 'doc/test_packets.xml' => ['doc', 'spec/test_packets.rb', 'Rakefile'] do |f|
+  require 'open3'
+  require 'pathname'
+  require 'rexml'
+  require 'xlat/pcap'
+  require_relative './spec/test_packets'
+
+  packets = TestPackets.constants.filter_map {|k|
+    val = TestPackets.const_get(k)
+    next unless val.is_a?(IO::Buffer)
+
+    {
+      name: k,
+      source_location: TestPackets.const_source_location(k).yield_self {|path, line|
+        [Pathname(path).relative_path_from(__dir__), line]
+      },
+      value: val,
+    }
+  }.sort_by { _1[:source_location] }
+
+  opts = {
+    'tcp.check_checksum' => 'TRUE',
+    'udp.check_checksum' => 'TRUE',
+    'ip.check_checksum' => 'TRUE',
+  }.map {|k, v| "-o#{k}:#{v}" }
+  pdml = Open3.popen2(*%W[tshark -n -r- -Tpdml], *opts) do |stdin, stdout, *|
+    pcap = Xlat::Pcap.new(stdin)
+    packets.each do |h|
+      pcap.write(h[:value], ts: Time.at(0))
+    end
+    stdin.close
+
+    xml = REXML::Document.new(stdout)
+
+    xml.get_elements('//packet').zip(packets) do |e_packet, pkt|
+      comment = "#{pkt[:name]} at #{pkt[:source_location].join(?:)}"
+
+      e_packet.unshift(
+        REXML::Element.new('proto').tap {|e_field|
+          e_field.add_attribute('name', 'pkt_comment')
+          e_field.add_attribute('pos', 0)
+          e_field.add_attribute('size', 0)
+          e_field.add_attribute('showname', comment)
+        },
+      )
+    end
+
+    File.write(f.name, xml.to_s)
+  end
+end
+
+file 'doc/pdml2html.xsl' => ['doc'] do |f|
+  require 'net/http'
+  require 'uri'
+
+  uri = URI.parse('https://gitlab.com/wireshark/wireshark/-/raw/v4.4.0/resources/share/doc/wireshark/pdml2html.xsl').freeze
+
+  File.write(f.name, Net::HTTP.get(uri))
+end
+
+desc 'Generate documents'
+task gendoc: %w[doc/test_packets.xml doc/pdml2html.xsl]

data/benchmark/run.rb

@@ -0,0 +1,38 @@
+warn 'Run as root!!!!!' if Process.euid != 0
+
+require 'securerandom'
+
+@iface = "tun-xlat-#{SecureRandom.hex(3)}"
+@trafgen_cfg = File.expand_path(ARGV.shift)
+fail "#{@trafgen_cfg} not found" unless File.exist?(@trafgen_cfg)
+
+Dir.chdir(File.expand_path('..', __dir__))
+
+xlat = spawn(*%W[#{RbConfig.ruby} -I./lib ./exe/xlat-siit #@iface 2001:db8:66:d1e0::/96 64:ff9b::/96], %i[out err] => '/tmp/xlat.log')
+
+th = Thread.new do
+  loop do
+    sleep 10
+    Process.kill(:USR1, xlat)
+  end
+rescue Errno::ESRCH
+end
+
+begin
+  sleep 1 until system(*%W[ip link show dev #{@iface}])
+
+  system(*%W[ip link set up dev #{@iface}])
+
+  trafgen = spawn(*%W[trafgen -P 1 -i #{@trafgen_cfg} -o #{@iface}], %i[out err] => '/tmp/trafgen.log')
+  begin
+    system(*%W[ifpps -t 10000 -d #{@iface}])
+  ensure
+    Process.kill(:KILL, trafgen)
+    Process.wait(trafgen)
+  end
+ensure
+  Process.kill(:KILL, xlat)
+  Process.wait(xlat)
+  th.kill
+  th.join
+end

data/benchmark/tcp.cfg

@@ -0,0 +1,23 @@
+# Simulates TCP download and upload traffic, checksum neutral prefixes
+
+{
+  ip6(sa=2001:db8:66:d1e0::c0a8:1, da=64:ff9b::c000:250),
+  tcp(sp=60000, dp=80, ack),
+}
+
+{
+  ip4(sa=192.0.2.80, da=192.168.0.1),
+  tcp(sp=80, dp=60000),
+  fill(0x20, 1460),
+}
+
+{
+  ip6(sa=2001:db8:66:d1e0::c0a8:1, da=64:ff9b::c000:250),
+  tcp(sp=60010, dp=80),
+  fill(0x20, 1440),
+}
+
+{
+  ip4(sa=192.0.2.80, da=192.168.0.1),
+  tcp(sp=80, dp=60010, ack),
+}