Skip to content

Latest commit

 

History

History
103 lines (82 loc) · 4.33 KB

README.md

File metadata and controls

103 lines (82 loc) · 4.33 KB
Raw

DhcpDotNet

DhcpDotNet

DHCPv4 and DHCPv6 packet implemented with C#. Build DHCP-packages with nearly all possibilities. DhcpDotNet allows the programming of a DHCPv4/DHCPv6 server or client with full controll. DhcpDotNet was created according to the specifications of IANA and RFC 2131, 4388, 1531, 8415 and 3315.

  • Build DHCP Packets
  • Send DHCP Packets (via UdpClient or Socket (advanced: sharppcap or Pcap.Net)
  • Receive DHCP Packets
  • Parse DHCP Packets
  • Read parsed Packets

Become a contributor

If you want to help improve the project, you can read this. If you would like to be part of the project, please contact us here

Example Projects

See the Examples folder for a range of examples using DhcpDotNet.
As an example project you can look at DhcpSharp. DhcpSharp is a very basic DHCPv4 server programmed with DhcpDotNet.

Usage Example

Example of a DHCPv4 Discover package. The payload can be sent with a UdpClient or socket. (or using SharpPcap or Pcap.Net)

Socket sock = new Socket(AddressFamily.InterNetwork, SocketType.Dgram, ProtocolType.Udp);
IPAddress serverAddr = IPAddress.Parse("192.168.2.1");
IPEndPoint endPoint = new IPEndPoint(serverAddr, 67);

DHCPv4Option dhcpMessageTypeOption = new DHCPv4Option
{
    optionId = DHCPv4OptionIds.DhcpMessageType,
    optionLength = 0x01,
    optionValue = new byte[] { 0x02 },
};

DHCPv4Option dhcpServerIdentifierOption = new DHCPv4Option
{
    optionId = DHCPv4OptionIds.ServerIdentifier,
    optionLength = 0x04,
    optionValue = IPAddress.Parse("").GetAddressBytes(),
};

DHCPv4Packet dhcpPacket = new DHCPv4Packet
{
    op = 0x02,
    htype = 0x01,
    hlen = 0x06,
    xid = new byte[] {0x00, 0x01, 0x02, 0x03 },
    secs = 0x00,
    ciaddr = IPAddress.Parse("").GetAddressBytes(),
    yiaddr = IPAddress.Parse("").GetAddressBytes(),
    siaddr = IPAddress.Parse("").GetAddressBytes(),
    chaddr = PhysicalAddress.Parse("").GetAddressBytes(),
    dhcpOptions = dhcpMessageTypeOption.buildDhcpOption().Concat(dhcpServerIdentifierOption.buildDhcpOption()).ToArray(),
};

byte[] send_buffer = dhcpDiscoveryPacket.buildPacket();
sock.SendTo(send_buffer, endPoint);

NuGet

Package Manager

PM> Install-Package DhcpDotNet -Version 2.0.5

.NET CLI

> dotnet add package DhcpDotNet --version 2.0.5

NuGet-Page

Latest Version and Changelog

Version: 2.0.5

V 2.0.5
- Changed NuGet licence

V 2.0.4
- Fixed missing code in parsePacket-Method

V 2.0.3
- Full support for DHCPv6. Fixed several performance down grades. Switch from linq to Binary reader/writer.

V 2.0.2
- Renamed class and methods with "v4". Dhcp with IPv6 comming soon...

V. 2.0.1
- Added dhcpOption parsing support. DhcpDotNet is now able to parse incoming DhcpPackets and their DhcpOptions. You can read each DhcpOption cotained in a DhcpPacket. This allows you to read all information provided by the options above listed.
- Renamed DhcpPacket-Bytes. Each byte or byte-array in a DhcpPacket is now named as in the RFC 2132.
- Added the possibility to define DhcpOptions with an enmu or single byte. This offers more flexibility and simplicity at the same time.

Copyright

The contents and works in this software created by the software operators are subject to German copyright law. The reproduction, editing, distribution and any kind of use outside the limits of copyright law require the written consent of the respective author or creator. Downloads and copies of this software are only permitted for private, non-commercial use.

Insofar as the content on this software was not created by the operator, the copyrights of third parties are observed. In particular, third-party content is identified as such. Should you nevertheless become aware of a copyright infringement, please inform us accordingly. If we become aware of any infringements, we will remove such contents immediately.

Source: eRecht24.de

Author

This developer and the copyright holder of this library is MaxlLuky