Help us shape the future of Go! Take the 2026 Go Developer Survey

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
- API
  
  Reference documentation for the pkg.go.dev API
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

netchaos

package module

Go to main page

Versions in this module

v0

v0.3.1

Oct 8, 2026

v0.3.0

Sep 16, 2026

Changes in this version

+ type DialerOption func(*dialerConfig)

+ func WithDialTimeout(d time.Duration) DialerOption

type FaultEvent

+ CorruptedBit uint8

+ CorruptedByte int

+ Size int

type Network

+ func (n *Network) SetCorruption(rate float64)

+ func (n *Network) SetDuplication(rate float64)

v0.2.0

Sep 1, 2026

Changes in this version

+ type FaultEvent struct

+ Corrupted bool

+ Delay time.Duration

+ Dropped bool

+ Duplicated bool

+ Effective time.Duration

+ Ordinal uint64

+ Partitioned bool

+ Seq uint64

+ Serialization time.Duration

+ Side Side

type Network

+ func (n *Network) DialerFor(name string) func(network, addr string) (net.Conn, error)

+ func (n *Network) Reset(peerA, peerB string)

+ func (n *Network) SetLatency(min, max time.Duration)

+ func (n *Network) SetPacketLoss(rate float64)

+ func (n *Network) Trace() []FaultEvent

type Option

+ func WithBandwidth(bytesPerSecond int) Option

+ func WithCorruption(rate float64) Option

+ func WithDuplication(rate float64) Option

+ func WithListenerBacklog(backlog int) Option

+ func WithPipeBound(bound int) Option

+ type Side int

+ const SideAcceptor

+ const SideDialer

+ func (s Side) String() string

v0.1.0

Aug 26, 2026

Changes in this version

+ var ErrAddressInUse = errors.New("netchaos: address already in use")

+ var ErrBacklogFull = errors.New("netchaos: accept backlog full")

+ var ErrConnectionRefused = errors.New("netchaos: connection refused")

+ var ErrUnsupportedNetwork = errors.New("netchaos: unsupported network")

+ func WithPeerName(ctx context.Context, name string) context.Context

+ type Network struct

+ func NewNetwork(opts ...Option) *Network

+ func (n *Network) Dial(network, addr string) (net.Conn, error)

+ func (n *Network) DialContext(ctx context.Context, network, dialAddr string) (net.Conn, error)

+ func (n *Network) Heal(peerA, peerB string)

+ func (n *Network) Listen(network, laddr string) (net.Listener, error)

+ func (n *Network) Partition(peerA, peerB string)

+ type Option func(*networkConfig)

+ func WithLatency(min, max time.Duration) Option

+ func WithPacketLoss(rate float64) Option

+ func WithPartition(peerA, peerB string) Option

+ func WithSeed(seed int64) Option