Skip to content

Commit

Permalink
Create README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
ShaunLawrie authored Apr 21, 2022
1 parent 315eebc commit bc22f9a
Showing 1 changed file with 30 additions and 0 deletions.
30 changes: 30 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -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
```

0 comments on commit bc22f9a

Please sign in to comment.