From bc22f9acb55e648bedbc4cc9f6f4c9ff272ccb93 Mon Sep 17 00:00:00 2001 From: ShaunLawrie Date: Thu, 21 Apr 2022 17:55:20 +1200 Subject: [PATCH] Create README.md --- README.md | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..3ff5aff --- /dev/null +++ b/README.md @@ -0,0 +1,30 @@ +# HNS Explorer +A simple GUI for exploring the data in Windows Host Networking Service. + +This was created while I have been learning more about the HNS and how to debug container networking issues on Windows Kubernetes nodes. + +## Running Instructions + +### Search +Entering something like a container ID in the test entry and hitting enter will do a primitive search for all HNS activities that reference it. +![image](https://user-images.githubusercontent.com/13159458/164382951-0f7648fc-694f-4050-b1ec-78dca21dffe2.png) + +### Dump to JSON +The "Dump to JSON" button will dump all the data collected by the tool to a massive JSON file. + +### Packet Capture +Packet capture for these virtual adaptors can be done with the pktmon tool https://docs.microsoft.com/en-us/windows-server/networking/technologies/pktmon/pktmon +The "Packet Capture" button just sets up a basic capture using pktmon and converts the output to something that can be opened in Wireshark. +![image](https://user-images.githubusercontent.com/13159458/164383733-767b3e46-cf75-4955-8946-2d78f22e7494.png) + +### Reload HNS Data +The "Reload HNS Data" button will reload the data from the HNS/HCS apis. + +## Build Instructions + +To build install the dotnet 6 SDK https://dotnet.microsoft.com/en-us/download/dotnet/6.0 + +This will generate a single exe output +``` +dotnet publish -c Release -r win-x64 -p:PublishSingleFile=true -p:EnableCompressionInSingleFile=true --self-contained +```