// Copyright 2020 The gVisor Authors. // // 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 testutil defines types and functions used to test Network Layer // functionality such as IP fragmentation. package testutil import ( "fmt" "math/rand" "gvisor.dev/gvisor/pkg/tcpip" "gvisor.dev/gvisor/pkg/tcpip/buffer" "gvisor.dev/gvisor/pkg/tcpip/header" "gvisor.dev/gvisor/pkg/tcpip/stack" ) // MockLinkEndpoint is an endpoint used for testing, it stores packets written // to it and can mock errors. type MockLinkEndpoint struct { // WrittenPackets is where packets written to the endpoint are stored. WrittenPackets []*stack.PacketBuffer mtu uint32 err *tcpip.Error allowPackets int } // NewMockLinkEndpoint creates a new MockLinkEndpoint. // // err is the error that will be returned once allowPackets packets are written // to the endpoint. func NewMockLinkEndpoint(mtu uint32, err *tcpip.Error, allowPackets int) *MockLinkEndpoint { return &MockLinkEndpoint{ mtu: mtu, err: err, allowPackets: allowPackets, } } // MTU implements LinkEndpoint.MTU. func (ep *MockLinkEndpoint) MTU() uint32 { return ep.mtu } // Capabilities implements LinkEndpoint.Capabilities. func (*MockLinkEndpoint) Capabilities() stack.LinkEndpointCapabilities { return 0 } // MaxHeaderLength implements LinkEndpoint.MaxHeaderLength. func (*MockLinkEndpoint) MaxHeaderLength() uint16 { return 0 } // LinkAddress implements LinkEndpoint.LinkAddress. func (*MockLinkEndpoint) LinkAddress() tcpip.LinkAddress { return "" } // WritePacket implements LinkEndpoint.WritePacket. func (ep *MockLinkEndpoint) WritePacket(_ *stack.Route, _ *stack.GSO, _ tcpip.NetworkProtocolNumber, pkt *stack.PacketBuffer) *tcpip.Error { if ep.allowPackets == 0 { return ep.err } ep.allowPackets-- ep.WrittenPackets = append(ep.WrittenPackets, pkt) return nil } // WritePackets implements LinkEndpoint.WritePackets. func (ep *MockLinkEndpoint) WritePackets(r *stack.Route, gso *stack.GSO, pkts stack.PacketBufferList, protocol tcpip.NetworkProtocolNumber) (int, *tcpip.Error) { var n int for pkt := pkts.Front(); pkt != nil; pkt = pkt.Next() { if err := ep.WritePacket(r, gso, protocol, pkt); err != nil { return n, err } n++ } return n, nil } // WriteRawPacket implements LinkEndpoint.WriteRawPacket. func (ep *MockLinkEndpoint) WriteRawPacket(vv buffer.VectorisedView) *tcpip.Error { if ep.allowPackets == 0 { return ep.err } ep.allowPackets-- pkt := stack.NewPacketBuffer(stack.PacketBufferOptions{ Data: vv, }) ep.WrittenPackets = append(ep.WrittenPackets, pkt) return nil } // Attach implements LinkEndpoint.Attach. func (*MockLinkEndpoint) Attach(stack.NetworkDispatcher) {} // IsAttached implements LinkEndpoint.IsAttached. func (*MockLinkEndpoint) IsAttached() bool { return false } // Wait implements LinkEndpoint.Wait. func (*MockLinkEndpoint) Wait() {} // ARPHardwareType implements LinkEndpoint.ARPHardwareType. func (*MockLinkEndpoint) ARPHardwareType() header.ARPHardwareType { return header.ARPHardwareNone } // AddHeader implements LinkEndpoint.AddHeader. func (*MockLinkEndpoint) AddHeader(_, _ tcpip.LinkAddress, _ tcpip.NetworkProtocolNumber, _ *stack.PacketBuffer) { } // MakeRandPkt generates a randomized packet. transportHeaderLength indicates // how many random bytes will be copied in the Transport Header. // extraHeaderReserveLength indicates how much extra space will be reserved for // the other headers. The payload is made from Views of the sizes listed in // viewSizes. func MakeRandPkt(transportHeaderLength int, extraHeaderReserveLength int, viewSizes []int, proto tcpip.NetworkProtocolNumber) *stack.PacketBuffer { var views buffer.VectorisedView for _, s := range viewSizes { newView := buffer.NewView(s) if _, err := rand.Read(newView); err != nil { panic(fmt.Sprintf("rand.Read: %s", err)) } views.AppendView(newView) } pkt := stack.NewPacketBuffer(stack.PacketBufferOptions{ ReserveHeaderBytes: transportHeaderLength + extraHeaderReserveLength, Data: views, }) pkt.NetworkProtocolNumber = proto if _, err := rand.Read(pkt.TransportHeader().Push(transportHeaderLength)); err != nil { panic(fmt.Sprintf("rand.Read: %s", err)) } return pkt }