sing-box-extended-mirror/experimental/libbox/platform.go

package libbox

import C "github.com/sagernet/sing-box/constant"

type PlatformInterface interface {
	LocalDNSTransport() LocalDNSTransport
	UsePlatformAutoDetectInterfaceControl() bool
	AutoDetectInterfaceControl(fd int32) error
	OpenTun(options TunOptions) (int32, error)
	UseProcFS() bool
	FindConnectionOwner(ipProtocol int32, sourceAddress string, sourcePort int32, destinationAddress string, destinationPort int32) (*ConnectionOwner, error)
	StartDefaultInterfaceMonitor(listener InterfaceUpdateListener) error
	CloseDefaultInterfaceMonitor(listener InterfaceUpdateListener) error
	GetInterfaces() (NetworkInterfaceIterator, error)
	UnderNetworkExtension() bool
	IncludeAllNetworks() bool
	ReadWIFIState() *WIFIState
	ClearDNSCache()
	SendNotification(notification *Notification) error
	CancelNotification(identifier string, typeID int32) error
	StartNeighborMonitor(listener NeighborUpdateListener) error
	CloseNeighborMonitor(listener NeighborUpdateListener) error
	RegisterMyInterface(name string)
	UsePlatformShell() bool
	CheckPlatformShell() error
	OpenShellSession(user *PlatformUser, command string, environ StringIterator, term string, rows int32, cols int32) (ShellSession, error)
	LookupUser(username string) (*PlatformUser, error)
	LookupSFTPServer() (string, error)
	ReadSystemSSHHostKey() (string, error)
	TailscaleHostname() string
	UsePlatformBridge() bool
	CreateBridge(options *BridgeOptions) (BridgeSession, error)
}

type BridgeOptions struct {
	BridgeName string
	MTU        int32
	Inet4Port  string
	Inet6Port  string
	Interface  string
	RuleIndex  int32
	RouteTable int32
}

type BridgeSession interface {
	FileDescriptor() int32
	Name() string
	Inet6Active() bool
	SetEgress(interfaceName string) error
	Close() error
}

type PlatformUser struct {
	Username string
	Uid      int32
	Gid      int32
	HomeDir  string
	Shell    string

	groups []int32
}

func (u *PlatformUser) SetGroups(groups Int32Iterator) {
	u.groups = iteratorToArray[int32](groups)
}

func (u *PlatformUser) Groups() Int32Iterator {
	return newIterator(u.groups)
}

type NeighborUpdateListener interface {
	UpdateNeighborTable(entries NeighborEntryIterator)
}

type ConnectionOwner struct {
	UserId              int32
	UserName            string
	ProcessPath         string
	androidPackageNames []string
}

func (c *ConnectionOwner) SetAndroidPackageNames(names StringIterator) {
	c.androidPackageNames = iteratorToArray[string](names)
}

func (c *ConnectionOwner) AndroidPackageNames() StringIterator {
	return newIterator(c.androidPackageNames)
}

type InterfaceUpdateListener interface {
	UpdateDefaultInterface(interfaceName string, interfaceIndex int32, isExpensive bool, isConstrained bool)
	UpdateNetworkPath(networkPath string)
}

const (
	InterfaceTypeWIFI     = int32(C.InterfaceTypeWIFI)
	InterfaceTypeCellular = int32(C.InterfaceTypeCellular)
	InterfaceTypeEthernet = int32(C.InterfaceTypeEthernet)
	InterfaceTypeOther    = int32(C.InterfaceTypeOther)
)

type NetworkInterface struct {
	Index     int32
	MTU       int32
	Name      string
	Addresses StringIterator
	Flags     int32

	Type      int32
	DNSServer StringIterator
	Gateway   StringIterator
	Metered   bool
}

type WIFIState struct {
	SSID  string
	BSSID string
}

func NewWIFIState(wifiSSID string, wifiBSSID string) *WIFIState {
	return &WIFIState{wifiSSID, wifiBSSID}
}

type NetworkInterfaceIterator interface {
	Next() *NetworkInterface
	HasNext() bool
}

type Notification struct {
	Identifier string
	TypeName   string
	TypeID     int32
	Title      string
	Subtitle   string
	Body       string
	OpenURL    string
}

type OnDemandRule interface {
	Target() int32
	DNSSearchDomainMatch() StringIterator
	DNSServerAddressMatch() StringIterator
	InterfaceTypeMatch() int32
	SSIDMatch() StringIterator
	ProbeURL() string
}

type OnDemandRuleIterator interface {
	Next() OnDemandRule
	HasNext() bool
}