Delete nets/nets.go

nets/nets.go was replaced by netif/netif.go
2026-08-10 01:43:40 +00:00 · 2024-01-10 09:11:09 -03:00
parent cdc76f3ea7
commit 1690c2c2d8
1 changed files with 0 additions and 221 deletions
@@ -1,221 +0,0 @@
 package nets
 import (
 	"errors"
 	"net"
 	"net/netip"
 	"time"
 )
 //go:linkname UseStack net.useNetdev
 func UseStack(stack Stack)
 // GethostByName() errors
 var (
 	ErrHostUnknown = errors.New("host unknown")
 	ErrMalAddr     = errors.New("malformed address")
 )
 // Socket errors
 var (
 	ErrFamilyNotSupported   = errors.New("address family not supported")
 	ErrProtocolNotSupported = errors.New("socket protocol/type not supported")
 	ErrStartingDHCPClient   = errors.New("error starting DHPC client")
 	ErrNoMoreSockets        = errors.New("no more sockets")
 	ErrClosingSocket        = errors.New("error closing socket")
 )
 var (
 	ErrConnected         = errors.New("already connected")
 	ErrConnectFailed     = errors.New("connect failed")
 	ErrConnectTimeout    = errors.New("connect timed out")
 	ErrMissingSSID       = errors.New("missing WiFi SSID")
 	ErrAuthFailure       = errors.New("wifi authentication failure")
 	ErrAuthTypeNoGood    = errors.New("wifi authorization type not supported")
 	ErrConnectModeNoGood = errors.New("connect mode not supported")
 	ErrNotSupported      = errors.New("not supported")
 )
 const (
 	_AF_INET       = 0x2
 	_SOCK_STREAM   = 0x1
 	_SOCK_DGRAM    = 0x2
 	_SOL_SOCKET    = 0x1
 	_SO_KEEPALIVE  = 0x9
 	_SOL_TCP       = 0x6
 	_TCP_KEEPINTVL = 0x5
 	_IPPROTO_TCP   = 0x6
 	_IPPROTO_UDP   = 0x11
 	// Made up, not a real IP protocol number.  This is used to create a
 	// TLS socket on the device, assuming the device supports mbed TLS.
 	_IPPROTO_TLS = 0xFE
 	_F_SETFL     = 0x4
 )
 // Interface is the minimum interface that need be implemented by any network
 // device driver and is based on [net.Interface].
 type Interface interface {
 	// HardwareAddr6 returns the device's 6-byte [MAC address].
 	//
 	// [MAC address]: https://en.wikipedia.org/wiki/MAC_address
 	HardwareAddr6() ([6]byte, error)
 	// NetFlags returns the net.Flag values for the interface. It includes state of connection.
 	NetFlags() net.Flags
 	// MTU returns the maximum transmission unit size.
 	MTU() int
 	// Notify to register callback for network events. May not be supported for certain devices.
 	NetNotify(cb func(Event)) error
 }
 // InterfaceEthPoller is implemented by devices that send/receive ethernet packets.
 type InterfaceEthPoller interface {
 	Interface
 	// SendEth sends an Ethernet packet
 	SendEth(pkt []byte) error
 	// RecvEthHandle sets recieve Ethernet packet callback function
 	RecvEthHandle(func(pkt []byte) error)
 	// PollOne tries to receive one Ethernet packet and returns true if one was
 	PollOne() (bool, error)
 }
 // InterfaceWifi is implemented by a interface device that has the capacity
 // to connect to wifi networks.
 type InterfaceWifi interface {
 	Interface
 	// Connect device to network
 	NetConnect(params WifiParams) error
 	// Disconnect device from network
 	NetDisconnect()
 }
 // InterfaceEthPollWifi is implemented by devices that connect to wifi networks
 // and send/receive ethernet packets (OSI level 2).
 type InterfaceEthPollWifi interface {
 	InterfaceWifi
 	InterfaceEthPoller
 }
 type Stack interface {
 	// GetHostByName returns the IP address of either a hostname or IPv4
 	// address in standard dot notation
 	// GetHostByName(name string) (netip.Addr, error)
 	// Addr returns IP address assigned to the interface, either by
 	// DHCP or statically
 	Addr() (netip.Addr, error)
 	// Berkely Sockets-like interface, Go-ified.  See man page for socket(2), etc.
 	Socket(domain int, stype int, protocol int) (int, error)
 	Bind(sockfd int, ip netip.AddrPort) error
 	Connect(sockfd int, host string, ip netip.AddrPort) error
 	Listen(sockfd int, backlog int) error
 	Accept(sockfd int) (int, netip.AddrPort, error)
 	Send(sockfd int, buf []byte, flags int, deadline time.Time) (int, error)
 	Recv(sockfd int, buf []byte, flags int, deadline time.Time) (int, error)
 	Close(sockfd int) error
 	SetSockOpt(sockfd int, level int, opt int, value interface{}) error
 }
 // Should have UseResolver package level function that replaces the Go Resolver?
 type Resolver interface {
 	// GetHostByName returns the IP address of either a hostname or IPv4
 	// address in standard dot notation
 	GetHostByName(name string) (netip.Addr, error)
 }
 // StackWifi is returned by `Probe` function for devices that communicate
 // on the OSI level 4 (transport) layer.
 type StackWifi interface {
 	InterfaceWifi
 	Stack
 }
 type WifiParams struct {
 	// Connect mode
 	ConnectMode ConnectMode
 	// SSID of Wifi AP
 	SSID string
 	// Passphrase of Wifi AP
 	Passphrase string
 	// Wifi authorization type
 	Auth AuthType
 	// Wifi country code as two-char string.  E.g. "XX" for world-wide,
 	// "US" for USA, etc.
 	CountryCode string
 }
 type Event int
 // Network events
 const (
 	// The device's network connection is now UP
 	EventNetUp Event = iota
 	// The device's network connection is now DOWN
 	EventNetDown
 )
 type ConnectMode int
 // Connect modes
 const (
 	ConnectModeSTA = iota // Connect as Wifi station (default)
 	ConnectModeAP         // Connect as Wifi Access Point
 )
 type AuthType int
 // Wifi authorization types.  Used when setting up an access point, or
 // connecting to an access point
 const (
 	AuthTypeWPA2      = iota // WPA2 authorization (default)
 	AuthTypeOpen             // No authorization required (open)
 	AuthTypeWPA              // WPA authorization
 	AuthTypeWPA2Mixed        // WPA2/WPA mixed authorization
 )
 type WifiAutoconnectParams struct {
 	WifiParams
 	// Retries is how many attempts to connect before returning with a
 	// "Connect failed" error.  Zero means infinite retries.
 	Retries int // Probably should be implemented as a function
 	// Timeout duration for each connection attempt.  The default zero
 	// value means 10sec.
 	ConnectTimeout time.Duration
 	// Watchdog ticker duration.  On tick, the watchdog will check for
 	// downed connection or hardware fault and try to recover the
 	// connection.  Set to zero to disable watchodog.
 	WatchdogTimeout time.Duration
 }
 func StartWifiAutoconnect(dev InterfaceWifi, cfg WifiAutoconnectParams) error {
 	if dev == nil {
 		return ErrConnectModeNoGood
 	}
 	go func() {
 		// Wifi autoconnect algorithm in one place,
 		// no need to implement for every single netdever.
 	RECONNECT:
 		for i := 0; i < cfg.Retries; i++ {
 			err := dev.NetConnect(cfg.WifiParams)
 			if err != nil {
 				time.Sleep(cfg.ConnectTimeout)
 				goto RECONNECT
 			}
 			for cfg.WatchdogTimeout != 0 {
 				time.Sleep(cfg.WatchdogTimeout)
 				if dev.NetFlags()&net.FlagRunning == 0 {
 					i = 0
 					goto RECONNECT
 				}
 			}
 		}
 	}()
 	return nil
 }