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

sniffer

package

Go to main page

Versions in this module

v0

v0.47.0

Aug 30, 2026

v0.46.0

Aug 29, 2026

v0.45.0

Aug 21, 2026

v0.44.0

Aug 20, 2026

v0.43.0

Aug 20, 2026

v0.42.0

Aug 20, 2026

v0.41.0

Aug 20, 2026

v0.40.0

Aug 14, 2026

v0.39.0

Aug 13, 2026

v0.38.0

Aug 12, 2026

Changes in this version

+ const DefaultSlot

+ const RejectSlot

+ func Metadata(classifier Classifier) any

+ type Action struct

+ Intercept bool

+ Slot int

+ type Call struct

+ Dst string

+ Host string

+ IfIndex int

+ IfName string

+ ListenConfig *gonnect.ListenConfig

+ MulticastOptions gonnect.MulticastOptions

+ Network string

+ Operation Operation

+ Proto string

+ Service string

+ Src string

+ type CompositeMetadata struct

+ Children []any

+ type Control func(*Call) Action

+ type HTTPInfo struct

+ Hostname string

+ Method string

+ URL string

+ Version string

+ type MetadataProvider interface

+ Metadata func() any

+ type Operation string

+ const OpDial

+ const OpDialTCP

+ const OpDialUDP

+ const OpInterfaceAddrs

+ const OpInterfaceMcast

+ const OpInterfaces

+ const OpInterfacesByIndex

+ const OpInterfacesByName

+ const OpListen

+ const OpListenMulticastUDP

+ const OpListenPacket

+ const OpListenPacketConfig

+ const OpListenTCP

+ const OpListenUDP

+ const OpListenUDPConfig

+ const OpLookupAddr

+ const OpLookupCNAME

+ const OpLookupHost

+ const OpLookupIP

+ const OpLookupIPAddr

+ const OpLookupMX

+ const OpLookupNS

+ const OpLookupNetIP

+ const OpLookupPort

+ const OpLookupSRV

+ const OpLookupTXT

+ const OpPacketDial

+ type SniffControl func(*SniffedCall) Action

+ type SniffResult struct

+ Err error

+ Index int

+ Metadata any

+ type SniffedCall struct

+ Result SniffResult

+ type Sniffer struct

+ func NewSniffer(config SnifferConfig) (*Sniffer, error)

+ func (s *Sniffer) Classifiers() []Factory

+ func (s *Sniffer) Close() error

+ func (s *Sniffer) Dial(ctx context.Context, network, address string) (net.Conn, error)

+ func (s *Sniffer) DialTCP(ctx context.Context, network, laddr, raddr string) (gonnect.TCPConn, error)

+ func (s *Sniffer) DialUDP(ctx context.Context, network, laddr, raddr string) (gonnect.UDPConn, error)

+ func (s *Sniffer) Down() error

+ func (s *Sniffer) InterfaceAddrs() ([]net.Addr, error)

+ func (s *Sniffer) InterfaceMulticastAddrs() ([]net.Addr, error)

+ func (s *Sniffer) Interfaces() ([]gonnect.NetworkInterface, error)

+ func (s *Sniffer) InterfacesByIndex(index int) ([]gonnect.NetworkInterface, error)

+ func (s *Sniffer) InterfacesByName(name string) ([]gonnect.NetworkInterface, error)

+ func (s *Sniffer) IsNative() bool

+ func (s *Sniffer) IsUp() (bool, error)

+ func (s *Sniffer) Listen(ctx context.Context, network, address string) (net.Listener, error)

+ func (s *Sniffer) ListenMulticastUDP(ctx context.Context, network, address string, opts gonnect.MulticastOptions) (gonnect.MulticastPacketConn, error)

+ func (s *Sniffer) ListenPacket(ctx context.Context, network, address string) (gonnect.PacketConn, error)

+ func (s *Sniffer) ListenPacketConfig(ctx context.Context, lc *gonnect.ListenConfig, network, address string) (gonnect.PacketConn, error)

+ func (s *Sniffer) ListenTCP(ctx context.Context, network, laddr string) (gonnect.TCPListener, error)

+ func (s *Sniffer) ListenUDP(ctx context.Context, network, laddr string) (gonnect.UDPConn, error)

+ func (s *Sniffer) ListenUDPConfig(ctx context.Context, lc *gonnect.ListenConfig, network, laddr string) (gonnect.UDPConn, error)

+ func (s *Sniffer) LookupAddr(ctx context.Context, addr string) ([]string, error)

+ func (s *Sniffer) LookupCNAME(ctx context.Context, host string) (string, error)

+ func (s *Sniffer) LookupHost(ctx context.Context, host string) ([]string, error)

+ func (s *Sniffer) LookupIP(ctx context.Context, network, address string) ([]net.IP, error)

+ func (s *Sniffer) LookupIPAddr(ctx context.Context, host string) ([]net.IPAddr, error)

+ func (s *Sniffer) LookupMX(ctx context.Context, name string) ([]*net.MX, error)

+ func (s *Sniffer) LookupNS(ctx context.Context, name string) ([]*net.NS, error)

+ func (s *Sniffer) LookupNetIP(ctx context.Context, network, host string) ([]netip.Addr, error)

+ func (s *Sniffer) LookupPort(ctx context.Context, network, service string) (int, error)

+ func (s *Sniffer) LookupSRV(ctx context.Context, service, proto, name string) (string, []*net.SRV, error)

+ func (s *Sniffer) LookupTXT(ctx context.Context, name string) ([]string, error)

+ func (s *Sniffer) Outputs() []gonnect.Network

+ func (s *Sniffer) PacketDial(ctx context.Context, network, address string) (gonnect.PacketConn, error)

+ func (s *Sniffer) SubscribeCloser(c io.Closer) (func(), error)

+ func (s *Sniffer) SubscribeUpDown(u gonnect.UpDown) (func(), error)

+ func (s *Sniffer) Up() error

+ type SnifferConfig struct

+ Classifiers []Factory

+ Control Control

+ Outputs []gonnect.Network

+ Pool bufpool.Pool

+ SniffBufferSize int

+ SniffControl SniffControl

+ Spawner gonnect.Spawner

v0.37.0

Aug 9, 2026

Changes in this version

+ const DefaultDNSOverTCPMessageMaxBytes

+ const DefaultHTTPHeaderMaxBytes

+ const DefaultHTTPRequestLineMaxBytes

+ const DefaultTLSClientHelloMaxBytes

+ const NoMatch

+ func MinFactorySniffBufferSize(factories ...Factory) int

+ func MinSniffBufferSize(classifiers ...Classifier) int

+ func Sniff(buffer []byte, conn putback.Conn, classifiers ...Classifier) (index int, err error)

+ func SniffFactories(buffer []byte, conn putback.Conn, factories ...Factory) (int, error)

+ func SniffFactoriesWithPool(bufferSize int, pool bufpool.Pool, conn putback.Conn, factories ...Factory) (int, error)

+ func SniffWithPool(bufferSize int, pool bufpool.Pool, conn putback.Conn, ...) (int, error)

+ type Classifier interface

+ Feed func(p []byte) State

+ func AMQP() Classifier

+ func And(children ...Classifier) Classifier

+ func Cassandra() Classifier

+ func DNSOverTCP() Classifier

+ func DNSOverTCPWithConfig(config DNSOverTCPConfig) Classifier

+ func HTTP() Classifier

+ func HTTP2() Classifier

+ func HTTPWithConfig(config HTTPConfig) Classifier

+ func LDAP() Classifier

+ func Limit(limit int, child Classifier) Classifier

+ func MQTT() Classifier

+ func Memcached() Classifier

+ func MemcachedASCII() Classifier

+ func MemcachedBinary() Classifier

+ func MongoDB() Classifier

+ func Not(child Classifier) Classifier

+ func Or(children ...Classifier) Classifier

+ func PostgreSQL() Classifier

+ func Prefix(prefix []byte) Classifier

+ func ProxyProtocol() Classifier

+ func ProxyProtocolV1() Classifier

+ func ProxyProtocolV2() Classifier

+ func RDP() Classifier

+ func RTSP() Classifier

+ func Redis() Classifier

+ func SIP() Classifier

+ func SMB() Classifier

+ func SOCKS() Classifier

+ func SOCKS4() Classifier

+ func SOCKS5() Classifier

+ func SSH() Classifier

+ func STUN() Classifier

+ func TLS() Classifier

+ func TLSWithConfig(config TLSConfig) Classifier

+ func WithMinSniffBufferSize(minSize int, classifier Classifier) Classifier

+ type ClassifierFunc func(p []byte) State

+ func (f ClassifierFunc) Feed(p []byte) State

+ func (f ClassifierFunc) MinSniffBufferSize() int

+ type DNSOverTCPConfig struct

+ MaxMessageBytes int

+ type Factory interface

+ NewClassifier func() Classifier

+ func AMQPFactory() Factory

+ func AndFactory(children ...Factory) Factory

+ func CassandraFactory() Factory

+ func DNSOverTCPFactory() Factory

+ func DNSOverTCPFactoryWithConfig(config DNSOverTCPConfig) Factory

+ func FactoryWithMinSniffBufferSize(minSize int, factory Factory) Factory

+ func HTTP2Factory() Factory

+ func HTTPFactory() Factory

+ func HTTPFactoryWithConfig(config HTTPConfig) Factory

+ func LDAPFactory() Factory

+ func LimitFactory(limit int, child Factory) Factory

+ func MQTTFactory() Factory

+ func MemcachedASCIIFactory() Factory

+ func MemcachedBinaryFactory() Factory

+ func MemcachedFactory() Factory

+ func MongoDBFactory() Factory

+ func NotFactory(child Factory) Factory

+ func OrFactory(children ...Factory) Factory

+ func PostgreSQLFactory() Factory

+ func PrefixFactory(prefix []byte) Factory

+ func ProxyProtocolFactory() Factory

+ func ProxyProtocolV1Factory() Factory

+ func ProxyProtocolV2Factory() Factory

+ func RDPFactory() Factory

+ func RTSPFactory() Factory

+ func RedisFactory() Factory

+ func SIPFactory() Factory

+ func SMBFactory() Factory

+ func SOCKS4Factory() Factory

+ func SOCKS5Factory() Factory

+ func SOCKSFactory() Factory

+ func SSHFactory() Factory

+ func STUNFactory() Factory

+ func TLSFactory() Factory

+ func TLSFactoryWithConfig(config TLSConfig) Factory

+ type FactoryFunc func() Classifier

+ func (f FactoryFunc) MinSniffBufferSize() int

+ func (f FactoryFunc) NewClassifier() Classifier

+ type HTTPConfig struct

+ Hostname string

+ HostnamePatterns []string

+ Hostnames []string

+ MaxHeaderBytes int

+ MaxRequestLineBytes int

+ Method string

+ Methods []string

+ URL string

+ URLPatterns []string

+ URLs []string

+ Version string

+ Versions []string

+ type MinSniffBufferSizer interface

+ MinSniffBufferSize func() int

+ type State uint8

+ const Match

+ const Mismatch

+ const NeedMore

+ func (s State) String() string

+ type TLSClientHelloInfo struct

+ ALPNProtocols []string

+ SNIEncrypted bool

+ SNIHostname string

+ Versions []uint16

+ func SniffTLSClientHello(buffer []byte, conn putback.Conn) (info TLSClientHelloInfo, ok bool, err error)

+ type TLSConfig struct

+ ALPN string

+ ALPNPatterns []string

+ ALPNs []string

+ Hostname string

+ HostnamePatterns []string

+ Hostnames []string

+ MaxClientHelloBytes int

+ SNIAvailable TLSFlag

+ SNIEncrypted TLSFlag

+ Version uint16

+ Versions []uint16

+ type TLSFlag uint8

+ const TLSFlagAny

+ const TLSFlagForbidden

+ const TLSFlagRequired