gvisor.dev/gvisor@v0.0.0-20240520182842-f9d4d51c7e0f/pkg/tcpip/transport/raw/protocol.go (about)

     1  // Copyright 2019 The gVisor Authors.
     2  //
     3  // Licensed under the Apache License, Version 2.0 (the "License");
     4  // you may not use this file except in compliance with the License.
     5  // You may obtain a copy of the License at
     6  //
     7  //     http://www.apache.org/licenses/LICENSE-2.0
     8  //
     9  // Unless required by applicable law or agreed to in writing, software
    10  // distributed under the License is distributed on an "AS IS" BASIS,
    11  // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    12  // See the License for the specific language governing permissions and
    13  // limitations under the License.
    14  
    15  package raw
    16  
    17  import (
    18  	"gvisor.dev/gvisor/pkg/tcpip"
    19  	"gvisor.dev/gvisor/pkg/tcpip/stack"
    20  	"gvisor.dev/gvisor/pkg/tcpip/transport/internal/noop"
    21  	"gvisor.dev/gvisor/pkg/tcpip/transport/packet"
    22  	"gvisor.dev/gvisor/pkg/waiter"
    23  )
    24  
    25  // EndpointFactory implements stack.RawFactory.
    26  type EndpointFactory struct{}
    27  
    28  // NewUnassociatedEndpoint implements stack.RawFactory.NewUnassociatedEndpoint.
    29  func (EndpointFactory) NewUnassociatedEndpoint(stack *stack.Stack, netProto tcpip.NetworkProtocolNumber, transProto tcpip.TransportProtocolNumber, waiterQueue *waiter.Queue) (tcpip.Endpoint, tcpip.Error) {
    30  	return newEndpoint(stack, netProto, transProto, waiterQueue, false /* associated */)
    31  }
    32  
    33  // NewPacketEndpoint implements stack.RawFactory.NewPacketEndpoint.
    34  func (EndpointFactory) NewPacketEndpoint(stack *stack.Stack, cooked bool, netProto tcpip.NetworkProtocolNumber, waiterQueue *waiter.Queue) (tcpip.Endpoint, tcpip.Error) {
    35  	return packet.NewEndpoint(stack, cooked, netProto, waiterQueue), nil
    36  }
    37  
    38  // CreateOnlyFactory implements stack.RawFactory. It allows creation of raw
    39  // endpoints that do not support reading, writing, binding, etc.
    40  type CreateOnlyFactory struct{}
    41  
    42  // NewUnassociatedEndpoint implements stack.RawFactory.NewUnassociatedEndpoint.
    43  func (CreateOnlyFactory) NewUnassociatedEndpoint(stk *stack.Stack, _ tcpip.NetworkProtocolNumber, _ tcpip.TransportProtocolNumber, _ *waiter.Queue) (tcpip.Endpoint, tcpip.Error) {
    44  	return noop.New(stk), nil
    45  }
    46  
    47  // NewPacketEndpoint implements stack.RawFactory.NewPacketEndpoint.
    48  func (CreateOnlyFactory) NewPacketEndpoint(*stack.Stack, bool, tcpip.NetworkProtocolNumber, *waiter.Queue) (tcpip.Endpoint, tcpip.Error) {
    49  	// This isn't needed by anything, so it isn't implemented.
    50  	return nil, &tcpip.ErrNotPermitted{}
    51  }