agentic scripts & dotnet updated to dotnet 10

Author: Mathew

.github/workflows/main.yml

@@ -12,7 +12,7 @@ on:
 
 env:
   NUGET_PACKAGES: ${{ github.workspace }}/.nuget/packages
-  DOTNET_VERSION: '8.0.x' # The .NET SDK version to use
+  DOTNET_VERSION: '10.0.x' # The .NET SDK version to use
   PRODUCT_VERSION: '0.1.0'
 
 # A workflow run is made up of one or more jobs that can run sequentially or in parallel

.gitignore

@@ -34,6 +34,8 @@ x64/
 *.tli
 *.tlh
 *.tmp
+core
+core.*
 *.log
 *.vspscc
 *.vssscc
@@ -107,4 +109,4 @@ Generated_Code #added for RIA/Silverlight projects
 # Visual Studio version. Backup files are not needed, because we have git ;-)
 _UpgradeReport_Files/
 Backup*/
-UpgradeLog*.XML
+UpgradeLog*.XML

AGENTS.md

@@ -0,0 +1,35 @@
+# AGENTS.md
+
+## Overview
+
+This repository contains a .NET 8 solution for working with Linux iptables from C#. The managed code lives under `IPTables.Net/`, the NUnit tests live under `IPTables.Net.Tests/`, and the native helper library used by the libiptc-based adapter lives under `ipthelper/`.
+
+## Build And Test
+
+- Use `./build.sh` for a full solution build.
+- Use `./test.sh` to build and run tests.
+- Use `./test.sh --fast` for the managed-heavy test pass that sets `SKIP_SYSTEM_TESTS=1`.
+- Use `./test.sh --full` on Linux when root or passwordless `sudo` is available to run the stable native and system iptables tests.
+- Set `RUN_UNSTABLE_SYSTEM_TESTS=1` with `./test.sh --full` to include tests marked `NotWorkingOnTravis`, including the conntrack coverage that can crash on some containerized hosts.
+
+Both scripts will bootstrap a usable .NET SDK if `dotnet` is missing. By default they infer the needed SDK channel from the highest `TargetFramework` declared in the repo's `.csproj` files. On Linux they also build `libipthelper` and install missing native build dependencies through a supported package manager when needed.
+
+## Native Helper Notes
+
+- `ipthelper/` builds `libipthelper.so`, which is required for `IPTablesLibAdapter`, `IptcInterface`, and the conntrack/native tests.
+- The helper links against the system iptables development libraries, `libnl3`, and `libpcap`.
+- The scripts first try a normal helper build and then retry with `-DOLD_IPTABLES` if the local iptables headers are older.
+- `test.sh --full` prefers the `iptables-legacy` / `ip6tables-legacy` alternatives when they are available because that matches the native test expectations more closely.
+
+## Testing Guidance
+
+- Fast mode is the safest default when you only need parser, model, or mocked adapter coverage.
+- Full mode touches the real machine state. The system tests create and mutate chains like `test`, `test2`, and `test3`, and the opt-in conntrack tests hit kernel networking APIs directly.
+- If full mode fails because the host lacks privileges, kernel modules, or compatible iptables backends, rerun with `./test.sh --fast` unless you are specifically changing native or system behavior.
+
+## Development Guidance
+
+- Keep changes narrow and add or update NUnit coverage in `IPTables.Net.Tests/` when behavior changes.
+- Prefer following the existing project layout instead of introducing new abstractions unless the current design is clearly blocking the work.
+- When changing native interop behavior, verify both the managed call sites in `IPTables.Net/Iptables/NativeLibrary/` and the corresponding code in `ipthelper/`.
+- The tests project is also the best source of usage examples for the public API.

IPTables.Net.Benchmark/IPTables.Net.Benchmark.csproj

@@ -2,7 +2,7 @@
 
   <PropertyGroup>
     <OutputType>Exe</OutputType>
-    <TargetFramework>net8.0</TargetFramework>
+    <TargetFramework>net10.0</TargetFramework>
   </PropertyGroup>
 
   <ItemGroup>

IPTables.Net.TestFramework/IPTables - Backup.Net.TestFramework.csproj

@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk">
 
   <PropertyGroup>
-    <TargetFramework>netcoreapp3.1</TargetFramework>
+    <TargetFramework>net10.0</TargetFramework>
   </PropertyGroup>
 <ItemGroup>
 	<ProjectReference Include="..\IPTables.Net\IPTables.Net.csproj" />

IPTables.Net.TestFramework/IPTables.Net.TestFramework.csproj

@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk">
 
   <PropertyGroup>
-    <TargetFramework>net8.0</TargetFramework>
+    <TargetFramework>net10.0</TargetFramework>
   </PropertyGroup>
 <ItemGroup>
 	<ProjectReference Include="..\IPTables.Net\IPTables.Net.csproj" />

IPTables.Net.Tests/IPTables.Net.Tests.csproj

@@ -1,23 +1,22 @@
 <Project Sdk="Microsoft.NET.Sdk">
 
   <PropertyGroup>
-    <TargetFramework>net8.0</TargetFramework>
+    <TargetFramework>net10.0</TargetFramework>
   </PropertyGroup>
 
   <ItemGroup>
     <Compile Remove="GraphLayoutTests.cs" />
   </ItemGroup>
 
   <ItemGroup>
-    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="16.7.1" />
+    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.14.1" />
     <PackageReference Include="NUnit" Version="3.12.0" />
     <PackageReference Include="NUnit3TestAdapter" Version="3.17.0" />
     <PackageReference Include="SystemInteract.Local" Version="1.1.5" />
   </ItemGroup>
 
   <ItemGroup>
-    <ProjectReference Include="..\IPTables.Net.TestFramework\IPTables.Net.TestFramework.csproj" />
-    <ProjectReference Include="..\IPTables.Net\IPTables.Net.csproj" />
+    <ProjectReference Include="..\IPTables.Net.TestFramework\IPTables.Net.TestFramework.csproj" SkipGetTargetFrameworkProperties="true" />
   </ItemGroup>
 
 </Project>

IPTables.Net/IPTables.Net.csproj

@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk">
 
   <PropertyGroup>
-    <TargetFramework>net8.0</TargetFramework>
+    <TargetFramework>net10.0</TargetFramework>
   </PropertyGroup>
 
   <ItemGroup>

IPTables.Net/Iptables/IpTablesRule.cs

@@ -99,8 +99,8 @@ public override bool Equals(IpTablesRule x, IpTablesRule y)
         /// <summary>
         /// Data stored for each IPTables module / extension (including "core")
         /// </summary>
-        private OrderedDictionary<string, IIpTablesModule> _moduleData =
-            new OrderedDictionary<string, IIpTablesModule>();
+        private IPTables.Net.Supporting.OrderedDictionary<string, IIpTablesModule> _moduleData =
+            new IPTables.Net.Supporting.OrderedDictionary<string, IIpTablesModule>();
 
         /// <summary>
         /// The System hosting this IPTables rule
@@ -148,7 +148,7 @@ public IpTablesRule(IpTablesRule rule)
         private void Cow()
         {
             var moduleData = _moduleData;
-            _moduleData = new OrderedDictionary<string, IIpTablesModule>(moduleData.Count);
+            _moduleData = new IPTables.Net.Supporting.OrderedDictionary<string, IIpTablesModule>(moduleData.Count);
 
             foreach (var module in moduleData) _moduleData.Add(module.Key, module.Value.Clone() as IIpTablesModule);
         }
@@ -183,7 +183,7 @@ public PacketCounters Counters
         /// <summary>
         /// The parameters for all modules used in the rule (internal)
         /// </summary>
-        internal OrderedDictionary<string, IIpTablesModule> ModuleDataInternal => _moduleData;
+        internal IPTables.Net.Supporting.OrderedDictionary<string, IIpTablesModule> ModuleDataInternal => _moduleData;
 
         /// <summary>
         /// The parameters for all modules used in the rule

IPTables.Net/SystemInteract.nuspec

@@ -16,6 +16,6 @@
 		</dependencies>
 	</metadata>
 	<files>
-		<file src="bin/Release/netcoreapp3.1/IPTables.Net.dll" target="lib" />
+		<file src="bin/Release/net10.0/IPTables.Net.dll" target="lib/net10.0" />
 	</files>
-</package>
+</package>