// Copyright 2019 Yunion // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package dhcp import ( "encoding/binary" "errors" "fmt" "net" "time" ) // Option is a DHCP option. type Option struct { Code OptionCode Value []byte } type OptionCode byte type OpCode byte type MessageType byte // Option 53 // A DHCP packet type Packet []byte func (p Packet) OpCode() OpCode { return OpCode(p[0]) } func (p Packet) HType() byte { return p[1] } func (p Packet) HLen() byte { return p[2] } func (p Packet) Hops() byte { return p[3] } func (p Packet) XId() []byte { return p[4:8] } func (p Packet) TransactionID() string { return string(p.XId()) } func (p Packet) Secs() []byte { return p[8:10] } // Never Used? func (p Packet) Flags() []byte { return p[10:12] } func (p Packet) CIAddr() net.IP { return net.IP(p[12:16]) } // Client's current IP address (it will respond to ARP for this IP) func (p Packet) YIAddr() net.IP { return net.IP(p[16:20]) } // Client IP address offered/assigned by server func (p Packet) SIAddr() net.IP { return net.IP(p[20:24]) } // Responding server's IP address func (p Packet) GIAddr() net.IP { return net.IP(p[24:28]) } // IP address of DHCP relay agent, if an agent forwarded the request func (p Packet) CHAddr() net.HardwareAddr { hLen := p.HLen() if hLen > 16 { // Prevent chaddr exceeding p boundary hLen = 16 } return net.HardwareAddr(p[28 : 28+hLen]) // max endPos 44 } func (p Packet) RelayAddr() net.IP { return p.GIAddr() } func Unmarshal(b []byte) Packet { p := Packet(b) return p } func (p Packet) Marshal() []byte { return p } func (p Packet) Type() MessageType { return MessageType(p.ParseOptions()[OptionDHCPMessageType][0]) } // 192 bytes of zeros BOOTP legacy // BOOTP legacy func (p Packet) SName() []byte { return trimNull(p[44:108]) } // BOOTP legacy func (p Packet) File() []byte { return trimNull(p[108:236]) } func trimNull(d []byte) []byte { for i, v := range d { if v == 0 { return d[:i] } } return d } func (p Packet) Cookie() []byte { return p[236:240] } func (p Packet) Options() []byte { if len(p) > 240 { return p[240:] } return nil } func (p Packet) Broadcast() bool { return p.Flags()[0] > 127 } func (p Packet) SetBroadcast(broadcast bool) { if p.Broadcast() != broadcast { p.Flags()[0] ^= 128 } } func (p Packet) SetOpCode(c OpCode) { p[0] = byte(c) } func (p Packet) SetCHAddr(a net.HardwareAddr) { copy(p[28:44], a) p[2] = byte(len(a)) } func (p Packet) SetHType(hType byte) { p[1] = hType } func (p Packet) SetCookie(cookie []byte) { copy(p.Cookie(), cookie) } func (p Packet) SetHops(hops byte) { p[3] = hops } func (p Packet) SetXId(xId []byte) { copy(p.XId(), xId) } func (p Packet) SetSecs(secs []byte) { copy(p.Secs(), secs) } func (p Packet) SetFlags(flags []byte) { copy(p.Flags(), flags) } func (p Packet) SetCIAddr(ip net.IP) { copy(p.CIAddr(), ip.To4()) } func (p Packet) SetYIAddr(ip net.IP) { copy(p.YIAddr(), ip.To4()) } func (p Packet) SetSIAddr(ip net.IP) { copy(p.SIAddr(), ip.To4()) } func (p Packet) SetGIAddr(ip net.IP) { copy(p.GIAddr(), ip.To4()) } // BOOTP legacy func (p Packet) SetSName(sName []byte) { copy(p[44:108], sName) if len(sName) < 64 { p[44+len(sName)] = 0 } } // BOOTP legacy func (p Packet) SetFile(file []byte) { copy(p[108:236], file) if len(file) < 128 { p[108+len(file)] = 0 } } func (p Packet) GetOptionValue(code OptionCode) []byte { return p.ParseOptions()[code] } // Map of DHCP options type Options map[OptionCode][]byte var ( ErrOptionWrongSize = errors.New("option value is the wrong size") ) func (o Options) Bytes(code OptionCode) ([]byte, error) { bs := o[code] if bs == nil { return nil, fmt.Errorf("option %d not found", code) } return bs, nil } func (o Options) String(n OptionCode) (string, error) { bs, err := o.Bytes(n) if err != nil { return "", err } return string(bs), err } func (o Options) Byte(n OptionCode) (byte, error) { bs, err := o.Bytes(n) if err != nil { return 0, err } if len(bs) != 1 { return 0, fmt.Errorf("option value %d is the wrong size", n) } return bs[0], nil } func (o Options) Uint16(n OptionCode) (uint16, error) { bs, err := o.Bytes(n) if err != nil { return 0, err } if len(bs) != 2 { return 0, ErrOptionWrongSize } return binary.BigEndian.Uint16(bs), nil } func (o Options) Uint32(n OptionCode) (uint32, error) { bs, err := o.Bytes(n) if err != nil { return 0, err } if len(bs) != 4 { return 0, ErrOptionWrongSize } return binary.BigEndian.Uint32(bs), nil } func (o Options) IPs(n OptionCode) ([]net.IP, error) { bs, err := o.Bytes(n) if err != nil { return nil, err } if len(bs) < 4 || len(bs)%4 != 0 { return nil, ErrOptionWrongSize } ret := make([]net.IP, 0, len(bs)/4) for i := 0; i < len(bs); i += 4 { ret = append(ret, net.IP(bs[i:i+4])) } return ret, nil } func (o Options) IP(n OptionCode) (net.IP, error) { ips, err := o.IPs(n) if err != nil { return nil, err } if len(ips) != 1 { return nil, ErrOptionWrongSize } return ips[0], nil } func (o Options) IPMask(n OptionCode) (net.IPMask, error) { bs := o[n] if bs == nil { return nil, fmt.Errorf("option %d not found", n) } if len(bs) != 4 { return nil, fmt.Errorf("option %d is the wrong size for an IPMask", n) } return net.IPMask(bs), nil } // Parses the packet's options into an Options map func (p Packet) ParseOptions() Options { opts := p.Options() options := make(Options, 10) for len(opts) >= 2 && OptionCode(opts[0]) != End { if OptionCode(opts[0]) == Pad { opts = opts[1:] continue } size := int(opts[1]) if len(opts) < 2+size { break } options[OptionCode(opts[0])] = opts[2 : 2+size] opts = opts[2+size:] } return options } func NewPacket(opCode OpCode) Packet { var magic = []byte{99, 130, 83, 99} p := make(Packet, 241) p.SetOpCode(opCode) p.SetHType(1) // Ethernet p.SetCookie(magic) p[240] = byte(End) return p } // Appends a DHCP option to the end of a packet func (p *Packet) AddOption(o OptionCode, value []byte) { *p = append((*p)[:len(*p)-1], []byte{byte(o), byte(len(value))}...) // Strip off End, Add OptionCode and Length *p = append(*p, value...) // Add Option Value *p = append(*p, byte(End)) // Add on new End } // Removes all options from packet. func (p *Packet) StripOptions() { *p = append((*p)[:240], byte(End)) } // Creates a request packet that a Client would send to a server. func RequestPacket(mt MessageType, chAddr net.HardwareAddr, cIAddr net.IP, xId []byte, broadcast bool, options []Option) Packet { p := NewPacket(BootRequest) p.SetCHAddr(chAddr) p.SetXId(xId) if cIAddr != nil { p.SetCIAddr(cIAddr) } p.SetBroadcast(broadcast) p.AddOption(OptionDHCPMessageType, []byte{byte(mt)}) for _, o := range options { p.AddOption(o.Code, o.Value) } p.PadToMinSize() return p } // ReplyPacket creates a reply packet that a Server would send to a client. // It uses the req Packet param to copy across common/necessary fields to // associate the reply the request. func ReplyPacket(req Packet, mt MessageType, serverId, yIAddr net.IP, leaseDuration time.Duration, options []Option) Packet { p := NewPacket(BootReply) p.SetXId(req.XId()) p.SetFlags(req.Flags()) p.SetYIAddr(yIAddr) p.SetGIAddr(req.GIAddr()) p.SetCHAddr(req.CHAddr()) p.AddOption(OptionDHCPMessageType, []byte{byte(mt)}) p.AddOption(OptionServerIdentifier, []byte(serverId.To4())) if leaseDuration > 0 { p.AddOption(OptionIPAddressLeaseTime, GetOptTime(leaseDuration)) } for _, o := range options { p.AddOption(o.Code, o.Value) } p.PadToMinSize() return p } // PadToMinSize pads a packet so that when sent over UDP, the entire packet, // is 300 bytes (BOOTP min), to be compatible with really old devices. var padder [272]byte func (p *Packet) PadToMinSize() { if n := len(*p); n < 272 { *p = append(*p, padder[:272-n]...) } } // decides how to send Packet on the wire, based on its field values. // // This implements the transmission decision process in section 4.1 of // RFC 2131. func (p *Packet) txType() txType { switch { case p.GIAddr() != nil && p.GIAddr().IsGlobalUnicast(): return txRelayAddr case p.Type() == NAK: return txBroadcast case p.CIAddr() != nil && (p.CIAddr().IsGlobalUnicast() || p.CIAddr().IsLoopback()): return txClientAddr case p.Broadcast(): return txBroadcast default: return txHardwareAddr } } //go:generate stringer -type=OpCode // OpCodes const ( BootRequest OpCode = 1 // From Client BootReply OpCode = 2 // From Server ) //go:generate stringer -type=MessageType // DHCP Message Type 53 const ( Discover MessageType = 1 // Broadcast Packet From Client - Can I have an IP? Offer MessageType = 2 // Broadcast From Server - Here's an IP Request MessageType = 3 // Broadcast From Client - I'll take that IP (Also start for renewals) Decline MessageType = 4 // Broadcast From Client - Sorry I can't use that IP ACK MessageType = 5 // From Server, Yes you can have that IP NAK MessageType = 6 // From Server, No you cannot have that IP Release MessageType = 7 // From Client, I don't need that IP anymore Inform MessageType = 8 // From Client, I have this IP and there's nothing you can do about it ) //go:generate stringer -type=OptionCode // DHCP Options const ( End OptionCode = 255 Pad OptionCode = 0 OptionSubnetMask OptionCode = 1 OptionTimeOffset OptionCode = 2 OptionRouter OptionCode = 3 OptionTimeServer OptionCode = 4 OptionNameServer OptionCode = 5 OptionDomainNameServer OptionCode = 6 OptionLogServer OptionCode = 7 OptionCookieServer OptionCode = 8 OptionLPRServer OptionCode = 9 OptionImpressServer OptionCode = 10 OptionResourceLocationServer OptionCode = 11 OptionHostName OptionCode = 12 OptionBootFileSize OptionCode = 13 OptionMeritDumpFile OptionCode = 14 OptionDomainName OptionCode = 15 OptionSwapServer OptionCode = 16 OptionRootPath OptionCode = 17 OptionExtensionsPath OptionCode = 18 // IP Layer Parameters per Host OptionIPForwardingEnableDisable OptionCode = 19 OptionNonLocalSourceRoutingEnableDisable OptionCode = 20 OptionPolicyFilter OptionCode = 21 OptionMaximumDatagramReassemblySize OptionCode = 22 OptionDefaultIPTimeToLive OptionCode = 23 OptionPathMTUAgingTimeout OptionCode = 24 OptionPathMTUPlateauTable OptionCode = 25 // IP Layer Parameters per Interface OptionInterfaceMTU OptionCode = 26 OptionAllSubnetsAreLocal OptionCode = 27 OptionBroadcastAddress OptionCode = 28 OptionPerformMaskDiscovery OptionCode = 29 OptionMaskSupplier OptionCode = 30 OptionPerformRouterDiscovery OptionCode = 31 OptionRouterSolicitationAddress OptionCode = 32 OptionStaticRoute OptionCode = 33 // Link Layer Parameters per Interface OptionTrailerEncapsulation OptionCode = 34 OptionARPCacheTimeout OptionCode = 35 OptionEthernetEncapsulation OptionCode = 36 // TCP Parameters OptionTCPDefaultTTL OptionCode = 37 OptionTCPKeepaliveInterval OptionCode = 38 OptionTCPKeepaliveGarbage OptionCode = 39 // Application and Service Parameters OptionNetworkInformationServiceDomain OptionCode = 40 OptionNetworkInformationServers OptionCode = 41 OptionNetworkTimeProtocolServers OptionCode = 42 OptionVendorSpecificInformation OptionCode = 43 OptionNetBIOSOverTCPIPNameServer OptionCode = 44 OptionNetBIOSOverTCPIPDatagramDistributionServer OptionCode = 45 OptionNetBIOSOverTCPIPNodeType OptionCode = 46 OptionNetBIOSOverTCPIPScope OptionCode = 47 OptionXWindowSystemFontServer OptionCode = 48 OptionXWindowSystemDisplayManager OptionCode = 49 OptionNetworkInformationServicePlusDomain OptionCode = 64 OptionNetworkInformationServicePlusServers OptionCode = 65 OptionMobileIPHomeAgent OptionCode = 68 OptionSimpleMailTransportProtocol OptionCode = 69 OptionPostOfficeProtocolServer OptionCode = 70 OptionNetworkNewsTransportProtocol OptionCode = 71 OptionDefaultWorldWideWebServer OptionCode = 72 OptionDefaultFingerServer OptionCode = 73 OptionDefaultInternetRelayChatServer OptionCode = 74 OptionStreetTalkServer OptionCode = 75 OptionStreetTalkDirectoryAssistance OptionCode = 76 OptionRelayAgentInformation OptionCode = 82 // DHCP Extensions OptionRequestedIPAddress OptionCode = 50 OptionIPAddressLeaseTime OptionCode = 51 OptionOverload OptionCode = 52 OptionDHCPMessageType OptionCode = 53 OptionServerIdentifier OptionCode = 54 OptionParameterRequestList OptionCode = 55 OptionMessage OptionCode = 56 OptionMaximumDHCPMessageSize OptionCode = 57 OptionRenewalTimeValue OptionCode = 58 OptionRebindingTimeValue OptionCode = 59 OptionVendorClassIdentifier OptionCode = 60 OptionClientIdentifier OptionCode = 61 OptionTFTPServerName OptionCode = 66 OptionBootFileName OptionCode = 67 OptionUserClass OptionCode = 77 OptionClientArchitecture OptionCode = 93 OptionClientNetworkInterfaceIdentifier OptionCode = 94 OptionClientMachineIdentifier OptionCode = 97 OptionTZPOSIXString OptionCode = 100 OptionTZDatabaseString OptionCode = 101 // https://datatracker.ietf.org/doc/html/rfc8925 OptionIPv6Only OptionCode = 108 OptionDomainSearch OptionCode = 119 OptionClasslessRouteFormat OptionCode = 121 // From RFC3942 - Options Used by PXELINUX OptionPxelinuxMagic OptionCode = 208 OptionPxelinuxConfigfile OptionCode = 209 OptionPxelinuxPathprefix OptionCode = 210 OptionPxelinuxReboottime OptionCode = 211 ) /* Notes A DHCP server always returns its own address in the 'server identifier' option. DHCP defines a new 'client identifier' option that is used to pass an explicit client identifier to a DHCP server. */