tun

type AutoRedirect interface {
	Start() error
	Close() error
	UpdateRouteAddressSet() error
}

type AutoRedirectHandler interface {
	JudgeFlow(network uint8, source netip.AddrPort, destination netip.AddrPort, firstPacket []byte) FlowVerdict
	N.TCPConnectionHandlerEx
}

type AutoRedirectOptions struct {
	TunOptions               *Options
	Context                  context.Context
	Handler                  AutoRedirectHandler
	Logger                   logger.Logger
	NetworkMonitor           NetworkUpdateMonitor
	InterfaceFinder          control.InterfaceFinder
	TableName                string
	DisableNFTables          bool
	CustomRedirectPort       func() int
	CustomRedirectListenerFD func() (int, error)
	RouteAddressSet          func() (include []netip.Prefix, exclude []netip.Prefix, err error)
	AndroidVPNService        bool
}

type DarwinTUN interface {
	Tun
	BatchRead(frontHeadroom int, rearHeadroom int) ([]*buf.Buffer, error)
	BatchWrite(buffers []*buf.Buffer) error
}

type DefaultInterfaceMonitor interface {
	Start() error
	Close() error
	DefaultInterface() *control.Interface
	OverrideAndroidVPN() bool
	AndroidVPNEnabled() bool
	RegisterCallback(callback DefaultInterfaceUpdateCallback) *list.Element[DefaultInterfaceUpdateCallback]
	UnregisterCallback(element *list.Element[DefaultInterfaceUpdateCallback])
	RegisterMyInterface(interfaceName string)
	MyInterfaces() []string
}

type DefaultInterfaceMonitorOptions struct {
	InterfaceFinder       control.InterfaceFinder
	OverrideAndroidVPN    bool
	UnderNetworkExtension bool
}

type DefaultInterfaceUpdateCallback = func(defaultInterface *control.Interface, flags int)

type FlowAction uint8

type FlowCloseReason uint8

type FlowHandle interface {
	CloseFlow()
}

type FlowTracker interface {
	AttachFlow(handle FlowHandle)
	CountForward(n int)
	CountReverse(n int)
	FlowEstablished()
	CloseFlow(reason FlowCloseReason)
}

type FlowVerdict struct {
	Action      FlowAction
	Port        Port
	Destination netip.AddrPort
	UDPTimeout  time.Duration
	NewTracker  func() FlowTracker
}

type ForwardDispatcher struct {
	// contains filtered or unexported fields
}

type ForwardFrameMeta struct {
	// contains filtered or unexported fields
}

type ForwardStage struct {
	// contains filtered or unexported fields
}

type ForwardWriteback interface {
	ReturnHeadroom() int
	WriteReturnPackets(packets [][]byte) error
}

type GSOOptions struct {
	// GSOType represents the type of segmentation offload.
	GSOType GSOType
	// HdrLen is the sum of the layer 3 and 4 header lengths. This field may be
	// zero when GSOType == GSONone.
	HdrLen uint16
	// CsumStart is the head byte index of the packet data to be checksummed,
	// i.e. the start of the TCP or UDP header.
	CsumStart uint16
	// CsumOffset is the offset from CsumStart where the 2-byte checksum value
	// should be placed.
	CsumOffset uint16
	// GSOSize is the size of each segment exclusive of HdrLen. The tail segment
	// may be smaller than this value.
	GSOSize uint16
	// NeedsCsum may be set where GSOType == GSONone. When set, the checksum
	// at CsumStart + CsumOffset must be a partial checksum, i.e. the
	// pseudo-header sum.
	NeedsCsum bool
}

type GSOType int

type Go struct {
	// contains filtered or unexported fields
}

type GoConn struct {
	// contains filtered or unexported fields
}

type GoListener struct {
	// contains filtered or unexported fields
}

type GoPacketConn struct {
	// contains filtered or unexported fields
}

type GoUDPConn struct {
	// contains filtered or unexported fields
}

type Handler interface {
	JudgeFlow(network uint8, source netip.AddrPort, destination netip.AddrPort, firstPacket []byte) FlowVerdict
	NewDNSPacket(payload []byte, source M.Socksaddr, destination M.Socksaddr, writer N.PacketWriter)
	N.TCPConnectionHandlerEx
	N.UDPConnectionHandlerEx
}

type ICMPError uint8

type LinuxTUN interface {
	Tun
	N.FrontHeadroom
	BatchSize() int
	BatchRead(buffers [][]byte, offset int, readN []int) (n int, err error)
	BatchWrite(buffers [][]byte, offset int) (n int, err error)
	TXChecksumOffload() bool
}

type MemoryPressure uint8

type MemoryTun struct {
	// contains filtered or unexported fields
}

type MemoryTunOptions struct {
	MTU       int
	Headroom  int
	RearSpace int
	BatchSize int
	Outbound  func(packets []*buf.Buffer)
	Route     func(packet []byte) *OutboundQueue
}

type NATFiltering uint8

type NATMapping uint8

type NativeTun struct {
	// contains filtered or unexported fields
}

type NetworkUpdateCallback = func()

type NetworkUpdateMonitor interface {
	Start() error
	Close() error
	RegisterCallback(callback NetworkUpdateCallback) *list.Element[NetworkUpdateCallback]
	UnregisterCallback(element *list.Element[NetworkUpdateCallback])
}

type Options struct {
	Name                                  string
	NetNs                                 string
	Inet4Address                          []netip.Prefix
	Inet6Address                          []netip.Prefix
	MTU                                   uint32
	GSO                                   bool
	MultiQueue                            bool
	AutoRoute                             bool
	InterfaceScope                        bool
	Inet4Gateway                          netip.Addr
	Inet6Gateway                          netip.Addr
	DNSMode                               string
	DNSAddress                            []netip.Addr
	IPRoute2TableIndex                    int
	IPRoute2RuleIndex                     int
	IPRoute2AutoRedirectFallbackRuleIndex int
	AutoRedirectMarkMode                  bool
	AutoRedirectInputMark                 uint32
	AutoRedirectOutputMark                uint32
	AutoRedirectResetMark                 uint32
	AutoRedirectTProxyMark                uint32
	AutoRedirectNFQueue                   uint16
	ExcludeMPTCP                          bool
	Inet4LoopbackAddress                  []netip.Addr
	Inet6LoopbackAddress                  []netip.Addr
	StrictRoute                           bool
	Inet4RouteAddress                     []netip.Prefix
	Inet6RouteAddress                     []netip.Prefix
	Inet4RouteExcludeAddress              []netip.Prefix
	Inet6RouteExcludeAddress              []netip.Prefix
	IncludeInterface                      []string
	ExcludeInterface                      []string
	BridgeInterface                       []string
	IncludeUID                            []ranges.Range[uint32]
	ExcludeUID                            []ranges.Range[uint32]
	IncludeAndroidUser                    []int
	IncludePackage                        []string
	ExcludePackage                        []string
	IncludeMACAddress                     []net.HardwareAddr
	ExcludeMACAddress                     []net.HardwareAddr
	InterfaceFinder                       control.InterfaceFinder
	InterfaceMonitor                      DefaultInterfaceMonitor
	FileDescriptor                        int
	Logger                                logger.Logger

	// For library usages.
	EXP_DisableDNSHijack      bool
	EXP_ExternalConfiguration bool

	// Safe at every MTU: the darwin pending packet limit is derived from the utun control socket
	// receive buffer.
	EXP_MultiPendingPackets bool

	// Do not enable. In netif mode (every utun handed out by Network Extension) utun_pkt_input
	// returns ENOSPC without freeing the mbuf once 512 packets are queued
	// (net.utun.max_pending_input), leaking one mbuf per rejected write until reboot; sendmsg_x
	// pushes the write rate past the netif drain rate (about 500k to 700k packets per second on an
	// M4 Pro) and reproduces the device-wide network loss, writev stays below it by its own cost.
	EXP_SendMsgX bool
	// contains filtered or unexported fields
}

type OutboundQueue struct {
	// contains filtered or unexported fields
}

type PackageManager interface {
	Start() error
	Close() error
	IDByPackage(packageName string) (uint32, bool)
	IDBySharedPackage(sharedPackage string) (uint32, bool)
	PackageByID(id uint32) (string, bool)
	PackagesByID(id uint32) ([]string, bool)
	SharedPackageByID(id uint32) (string, bool)
}

type PackageManagerCallback interface {
	OnPackagesUpdated(packages int, sharedUsers int)
}

type PackageManagerOptions struct {
	Callback PackageManagerCallback

	// Logger is the logger to log errors
	// optional
	Logger logger.Logger
}

type PacketNAT struct {
	Origin         M.Socksaddr
	Destination    M.Socksaddr
	FakeIP         bool
	Unidirectional bool
}

type Port interface {
	PortAddresses() (v4 netip.Addr, v6 netip.Addr)
	PortMTU() uint32
	AttachReturn(returnPath Return) error
	DetachReturn(returnPath Return) error
	WritePackets(packets [][]byte) error
}

type PortWithSelectorRange interface {
	Port
	PortSelectorRange() (start uint16, count uint16)
}

type ReadRetry struct {
	// contains filtered or unexported fields
}

type RedirectServer struct {
	// contains filtered or unexported fields
}

type Return interface {
	ReturnHeadroom() int
	ReturnPackets(packets [][]byte) [][]byte
}

type Session struct {
	SourceAddress      netip.Addr
	DestinationAddress netip.Addr
	SourcePort         uint16
	DestinationPort    uint16
}

type SpliceOptions struct {
	ReadCounters  []N.CountFunc
	WriteCounters []N.CountFunc
	OnClose       N.CloseHandlerFunc
}

type SplicePacketOptions struct {
	SpliceOptions
	Timeout       time.Duration
	NAT           PacketNAT
	Cached        []*N.PacketBuffer
	Offload       N.PacketOffload
	FrontHeadroom int
	RearHeadroom  int
}

type SpliceSocket interface {
	syscall.Conn
	io.Closer
	Attach(closer io.Closer) (io.Closer, bool)
	Detach()
}

type Stack interface {
	Start() error
	ResetNetwork()
	Close() error
}

type StackOptions struct {
	Context                context.Context
	Tun                    Tun
	TunOptions             Options
	UDPTimeout             time.Duration
	ICMPTimeout            time.Duration
	UDPMapping             NATMapping
	UDPFiltering           NATFiltering
	UDPNATMax              uint32
	Handler                Handler
	Logger                 logger.Logger
	ForwarderBindInterface bool
	IncludeAllNetworks     bool
	InterfaceFinder        control.InterfaceFinder
	MemoryPressure         func() MemoryPressure
	TCPCongestionControl   string
}

type System struct {
	// contains filtered or unexported fields
}

type TCPNat struct {
	// contains filtered or unexported fields
}

type TCPSession struct {
	sync.Mutex
	Source      netip.AddrPort
	Destination netip.AddrPort
	LastActive  time.Time
}

type Tun interface {
	io.ReadWriter
	Name() (string, error)
	Start() error
	Close() error
	UpdateRouteOptions(tunOptions Options) error
}

type UDPEgressConn struct {
	// contains filtered or unexported fields
}

type UDPEgressPool struct {
	// contains filtered or unexported fields
}

type UDPEgressPoolOptions struct {
	Logger           logger.Logger
	Network          string
	Control          control.Func
	InterfaceFinder  control.InterfaceFinder
	InterfaceMonitor DefaultInterfaceMonitor
	IsExempt         func() bool
}

type UDPNat struct {
	// contains filtered or unexported fields
}

type UDPNatConn struct {
	// contains filtered or unexported fields
}

type UDPNatOptions struct {
	Handler   N.UDPConnectionHandlerEx
	Prepare   UDPNatPrepareFunc
	Timeout   time.Duration
	Shared    bool
	Mapping   NATMapping
	Filtering NATFiltering
	MaxSize   uint32

	InterfaceFinder control.InterfaceFinder
}

type UDPNatPrepareFunc func(source M.Socksaddr, destination M.Socksaddr, userData any) (bool, context.Context, N.PacketWriter, N.CloseHandlerFunc)

type WinTun interface {
	Tun
	ReadPacket() ([]byte, func(), error)
}