windowskext

Documentation

Overview

Package windowskext provides network interception capabilities on windows via the Portmaster Kernel Extension.

Index

• Variables
• func GetPayload(packetID uint32, packetSize uint32) ([]byte, error)
• func Handler(packets chan packet.Packet)
• func Init(dllPath, driverPath string) error
• func SetVerdict(packetID uint32, verdict network.Verdict) error
• func Start() error
• func Stop() error
• type Packet
  • func (pkt *Packet) Accept() error
  • func (pkt *Packet) Block() error
  • func (pkt *Packet) Drop() error
  • func (pkt *Packet) GetPayload() ([]byte, error)
  • func (pkt *Packet) PermanentAccept() error
  • func (pkt *Packet) PermanentBlock() error
  • func (pkt *Packet) PermanentDrop() error
  • func (pkt *Packet) RerouteToNameserver() error
  • func (pkt *Packet) RerouteToTunnel() error
• type VerdictRequest
  • func RecvVerdictRequest() (*VerdictRequest, error)
• type WinKext

Variables

var (
	ErrKextNotReady = errors.New("the windows kernel extension (driver) is not ready to accept commands")
)

Package errors

Functions

func GetPayload

func GetPayload(packetID uint32, packetSize uint32) ([]byte, error)

GetPayload returns the payload of a packet.

func Handler

func Handler(packets chan packet.Packet)

Handler transforms received packets to the Packet interface.

func Init

func Init(dllPath, driverPath string) error

Init initializes the DLL and the Kext (Kernel Driver).

func SetVerdict

func SetVerdict(packetID uint32, verdict network.Verdict) error

SetVerdict sets the verdict for a packet and/or connection.

func Start

func Start() error

Start intercepting.

func Stop

func Stop() error

Stop intercepting.

Types

type Packet

type Packet struct {
	packet.Base
	// contains filtered or unexported fields
}

Packet represents an IP packet.

func (*Packet) Accept

func (pkt *Packet) Accept() error

Accept accepts the packet.

func (*Packet) Block

func (pkt *Packet) Block() error

Block blocks the packet.

func (*Packet) Drop

func (pkt *Packet) Drop() error

Drop drops the packet.

func (*Packet) GetPayload

func (pkt *Packet) GetPayload() ([]byte, error)

GetPayload returns the full raw packet.

func (*Packet) PermanentAccept

func (pkt *Packet) PermanentAccept() error

PermanentAccept permanently accepts connection (and the current packet).

func (*Packet) PermanentBlock

func (pkt *Packet) PermanentBlock() error

PermanentBlock permanently blocks connection (and the current packet).

func (*Packet) PermanentDrop

func (pkt *Packet) PermanentDrop() error

PermanentDrop permanently drops connection (and the current packet).

func (*Packet) RerouteToNameserver

func (pkt *Packet) RerouteToNameserver() error

RerouteToNameserver permanently reroutes the connection to the local nameserver (and the current packet).

func (*Packet) RerouteToTunnel

func (pkt *Packet) RerouteToTunnel() error

RerouteToTunnel permanently reroutes the connection to the local tunnel entrypoint (and the current packet).

type VerdictRequest

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

VerdictRequest is the request structure from the Kext.

func RecvVerdictRequest

func RecvVerdictRequest() (*VerdictRequest, error)

RecvVerdictRequest waits for the next verdict request from the kext. If a timeout is reached, both *VerdictRequest and error will be nil.

type WinKext

type WinKext struct {
	sync.RWMutex
	// contains filtered or unexported fields
}

WinKext holds the DLL handle.