Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

conn

package module

Go to main page

Versions in this module

v0

v0.1.3

May 3, 2026

v0.1.2

Apr 28, 2026

v0.1.1

Apr 28, 2026

v0.1.0

Apr 27, 2026

Changes in this version

+ const IdealBatchSize

+ const StdNetSupportsStickySockets

+ var ErrBatchTooLarge = errors.New("batch size exceeds batching connection capacity")

+ var ErrBindAlreadyOpen = errors.New("bind is already open")

+ var ErrNoNetwork = errors.New("bind network is nil")

+ var ErrReadBufferTooShort = errors.New("receive buffers list shorter than bind batch size")

+ var ErrSinglePacketReadUnsupported = errors.New("single-packet reads are unsupported on batching connections")

+ var ErrWrongEndpointType = errors.New("endpoint type does not correspond with bind type")

+ func MinControlMessageSize() int

+ func TryUpgradeToBatchingConn(pconn gonnect.PacketConn, _ string, _ int) gonnect.PacketConn — darwin/amd64, js/wasm, windows/amd64

+ func TryUpgradeToBatchingConn(pconn gonnect.PacketConn, network string, batchSize int) gonnect.PacketConn — linux/amd64

+ type BatchingConn interface

+ BatchSize func() int

+ ReadBatch func(msgs []ipv6.Message, flags int) (n int, err error)

+ WriteBatchTo func(bufs [][]byte, addr netip.AddrPort) error

+ type Bind interface

+ BatchSize func() int

+ Close func() error

+ Open func(port uint16) (fns []ReceiveFunc, actualPort uint16, err error)

+ ParseEndpoint func(s string) (Endpoint, error)

+ Send func(bufs [][]byte, ep Endpoint) error

+ SetMark func(mark uint32) error

+ func NewDefaultBind(network gonnect.Network) Bind

+ func NewStdNetBind(network gonnect.Network) Bind

+ func NewWinRingBind(network gonnect.Network) Bind

+ type BindSocketToInterface interface

+ BindSocketToInterface4 func(interfaceIndex uint32, blackhole bool) error

+ BindSocketToInterface6 func(interfaceIndex uint32, blackhole bool) error

+ type Endpoint interface

+ ClearSrc func()

+ DstIP func() netip.Addr

+ DstToBytes func() []byte

+ DstToString func() string

+ SrcIP func() netip.Addr

+ SrcToString func() string

+ type ErrUDPGSODisabled struct

+ RetryErr error

+ func (e ErrUDPGSODisabled) Error() string

+ func (e ErrUDPGSODisabled) Unwrap() error

+ type PeekLookAtSocketFd interface

+ PeekLookAtSocketFd4 func() (fd int, err error)

+ PeekLookAtSocketFd6 func() (fd int, err error)

+ type ReceiveFunc func(packets [][]byte, sizes []int, eps []Endpoint) (n int, err error)

+ func (fn ReceiveFunc) PrettyName() string

+ type StdNetBind struct

+ func (*StdNetBind) ParseEndpoint(s string) (Endpoint, error)

+ func (s *StdNetBind) BatchSize() int

+ func (s *StdNetBind) BindSocketToInterface4(interfaceIndex uint32, blackhole bool) error

+ func (s *StdNetBind) BindSocketToInterface6(interfaceIndex uint32, blackhole bool) error

+ func (s *StdNetBind) Close() error

+ func (s *StdNetBind) Open(uport uint16) ([]ReceiveFunc, uint16, error)

+ func (s *StdNetBind) Send(bufs [][]byte, endpoint Endpoint) error

+ func (s *StdNetBind) SetMark(mark uint32) error

+ type StdNetEndpoint struct

+ func (e *StdNetEndpoint) ClearSrc()

+ func (e *StdNetEndpoint) DstIP() netip.Addr

+ func (e *StdNetEndpoint) DstToBytes() []byte

+ func (e *StdNetEndpoint) DstToString() string

+ func (e *StdNetEndpoint) SrcIP() netip.Addr

+ func (e *StdNetEndpoint) SrcIfidx() int32

+ func (e *StdNetEndpoint) SrcToString() string

+ type WinRingBind struct — windows/amd64

+ func (*WinRingBind) ParseEndpoint(s string) (Endpoint, error)

+ func (bind *WinRingBind) BatchSize() int

+ func (bind *WinRingBind) BindSocketToInterface4(interfaceIndex uint32, blackhole bool) error

+ func (bind *WinRingBind) BindSocketToInterface6(interfaceIndex uint32, blackhole bool) error

+ func (bind *WinRingBind) Close() error

+ func (bind *WinRingBind) Open(port uint16) (recvFns []ReceiveFunc, selectedPort uint16, err error)

+ func (bind *WinRingBind) Send(bufs [][]byte, endpoint Endpoint) error

+ func (bind *WinRingBind) SetMark(mark uint32) error

+ type WinRingEndpoint struct — windows/amd64

+ func (*WinRingEndpoint) ClearSrc()

+ func (e *WinRingEndpoint) DstIP() netip.Addr

+ func (e *WinRingEndpoint) DstToBytes() []byte

+ func (e *WinRingEndpoint) DstToString() string

+ func (e *WinRingEndpoint) SrcIP() netip.Addr

+ func (e *WinRingEndpoint) SrcToString() string