GitHub - HakanL/Haukcode.Network: Common Network utilities (original) (raw)

A .NET library providing common network utilities and efficient binary I/O operations for network programming.

Features

Network Utilities

• Network Adapter Discovery - Enumerate and query network interfaces with detailed information
• IP Address Management - Get IPv4 addresses, netmasks, and MAC addresses from adapters
• Multicast Support - Generate and validate multicast addresses
• Broadcast Addresses - Calculate broadcast addresses from IP and netmask
• Socket Configuration - Helper methods for socket options (reuse, non-exclusive, ICMP)

Binary I/O

• Big-Endian Binary Reader/Writer - Efficient binary serialization in network byte order
• Little-Endian Binary Reader/Writer - Binary serialization in little-endian format
• Memory-Efficient - Built on Memory<T> and Span<T> for zero-copy operations
• Type Support - Int16, UInt16, Int32, UInt32, bytes, strings, GUIDs

Installation

Install via NuGet Package Manager:

dotnet add package Haukcode.Network

Or via Package Manager Console:

Install-Package Haukcode.Network

Usage

Network Adapter Discovery

Get All Common Network Adapters (Ethernet and WiFi)

using Haukcode.Network; using System;

// Get all ethernet and WiFi adapters var adapters = Utils.GetCommonAdapters();

foreach (var adapter in adapters) { Console.WriteLine($"Adapter: {adapter.DisplayName}"); Console.WriteLine($" Type: {adapter.Type}"); Console.WriteLine($" MAC: {BitConverter.ToString(adapter.PhysicalAddress)}");

foreach (var (ip, netmask) in adapter.AllIpv4Addresses)
{
    Console.WriteLine($"  IP: {ip}, Netmask: {netmask}");
}

}

Get First Available Bind Address

using Haukcode.Network; using System;

// Get the first available IP address (prefers Ethernet over WiFi) var (ipAddress, netMask, macAddress) = Utils.GetFirstBindAddress();

if (ipAddress != null) { Console.WriteLine($"Bind to: {ipAddress}"); Console.WriteLine($"Netmask: {netMask}"); Console.WriteLine($"MAC: {BitConverter.ToString(macAddress)}"); }

Get Network Interfaces with IP Details

using Haukcode.Network;

// Get list of interface names with IP addresses var interfaces = Utils.GetCommonInterfaces(excludeHyperV: true);

foreach (var (adapterName, description, ipAddress, netMask) in interfaces) { Console.WriteLine($"{adapterName} ({description}): {ipAddress}/{netMask}"); }

Multicast and Broadcast Addresses

Generate Multicast Address

using Haukcode.Network; using System.Net;

// Generate a multicast address from a universe ID ushort universeId = 1; IPAddress multicastAddr = Utils.GetMulticastAddress(universeId); // Result: 239.255.0.1

Console.WriteLine($"Multicast address for universe {universeId}: {multicastAddr}");

// Check if an address is a multicast address bool isMulticast = Utils.IsMulticast(multicastAddr);

Calculate Broadcast Address

using Haukcode.Network; using System.Net;

IPAddress ipAddress = IPAddress.Parse("192.168.1.100"); IPAddress subnetMask = IPAddress.Parse("255.255.255.0");

IPAddress broadcastAddr = Utils.GetBroadcastAddress(ipAddress, subnetMask); // Result: 192.168.1.255

Console.WriteLine($"Broadcast address: {broadcastAddr}");

Socket Configuration

using Haukcode.Network; using System.Net.Sockets;

var socket = new Socket(AddressFamily.InterNetwork, SocketType.Dgram, ProtocolType.Udp);

// Configure socket with recommended options for UDP networking: // - Non-exclusive address use // - Address reuse enabled // - ICMP unreachable suppressed (Windows) Utils.SetSocketOptions(socket);

Binary Reading and Writing

Big-Endian Binary I/O (Network Byte Order)

using Haukcode.Network; using System;

// Writing binary data in big-endian format var buffer = new byte[1024]; var writer = new BigEndianBinaryWriter(buffer);

writer.WriteUInt16(0x1234); // Write 2-byte value writer.WriteUInt32(0x12345678); // Write 4-byte value writer.WriteString("Hello", 10); // Write string with fixed length writer.WriteGuid(Guid.NewGuid()); // Write GUID writer.WriteByte(0xFF); // Write single byte

Console.WriteLine($"Wrote {writer.BytesWritten} bytes");

// Reading binary data in big-endian format var reader = new BigEndianBinaryReader(buffer);

ushort value16 = reader.ReadUInt16(); uint value32 = reader.ReadUInt32(); string text = reader.ReadString(10); Guid guid = reader.ReadGuid(); byte byteValue = reader.ReadByte();

Console.WriteLine($"Read {reader.BytesRead} bytes, {reader.BytesLeft} bytes remaining");

Little-Endian Binary I/O

using Haukcode.Network; using System;

// Writing in little-endian format var buffer = new byte[256]; var writer = new LittleEndianBinaryWriter(buffer);

writer.WriteInt16(-1234); writer.WriteUInt32(0xDEADBEEF); writer.WriteBytes(new byte[] { 0x01, 0x02, 0x03 });

// Reading in little-endian format var reader = new LittleEndianBinaryReader(buffer);

short signedValue = reader.ReadInt16(); uint unsignedValue = reader.ReadUInt32(); byte[] bytes = reader.ReadBytes(3);

Working with Memory Slices

using Haukcode.Network; using System;

var data = new byte[100]; var reader = new BigEndianBinaryReader(data);

// Read a slice of data without copying ReadOnlyMemory slice = reader.ReadSlice(20);

// Skip bytes reader.SkipBytes(10);

// Verify expected byte sequence bool isValid = reader.VerifyBytes(new byte[] { 0x00, 0x01, 0x02 });

// Get remaining unread data ReadOnlyMemory remaining = reader.Memory;

Reverse Byte Order Reading

using Haukcode.Network;

var buffer = new byte[4]; var reader = new BigEndianBinaryReader(buffer);

// Read UInt16 in reverse byte order (useful for mixed endianness) ushort valueReversed = reader.ReadUInt16Reverse();

API Reference

Utils Class

Adapter Class

IBinaryReader Interface

IBinaryWriter Interface

Target Framework

• .NET Standard 2.1

License

This project is licensed under the MIT License - see the LICENSE file for details.

Author

Hakan Lindestaf

Contributing

Contributions are welcome! Please feel free to submit issues or pull requests.

Repository

https://github.com/HakanL/Haukcode.Network