echcheck

package
v3.31.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 3, 2026 License: GPL-3.0 Imports: 21 Imported by: 0

Documentation

Overview

Package echcheck contains the ECH blocking network experiment.

https://github.com/ooni/spec/pull/263

Index

Constants

This section is empty.

Variables

View Source
var (
	// ErrInputRequired indicates that no richer-input target was provided.
	ErrInputRequired = targetloading.ErrInputRequired

	// ErrInvalidInputType indicates that the richer-input target has the wrong type.
	ErrInvalidInputType = targetloading.ErrInvalidInputType
)

Functions

func NewExperimentMeasurer

func NewExperimentMeasurer() model.ExperimentMeasurer

NewExperimentMeasurer creates a new ExperimentMeasurer.

func NewLoader added in v3.31.0

func NewLoader(loader *targetloading.Loader, gopts any) model.ExperimentTargetLoader

NewLoader constructs a new model.ExperimentTargetLoader instance.

This function PANICS if options is not an instance of *echcheck.Config.

Types

type Config

type Config struct {
	// ResolverURL is the default DoH resolver
	ResolverURL string `json:"resolver_url,omitempty" ooni:"URL for DoH resolver"`
}

Config contains the experiment config.

type Measurer

type Measurer struct{}

Measurer performs the measurement.

func (*Measurer) ExperimentName

func (m *Measurer) ExperimentName() string

ExperimentName implements ExperimentMeasurer.ExperiExperimentName.

func (*Measurer) ExperimentVersion

func (m *Measurer) ExperimentVersion() string

ExperimentVersion implements ExperimentMeasurer.ExperimentVersion.

func (*Measurer) Run

func (m *Measurer) Run(
	ctx context.Context,
	args *model.ExperimentArgs,
) error

Run implements ExperimentMeasurer.Run.

type Target added in v3.31.0

type Target struct {
	// Config contains the configuration.
	Config *Config

	// URL is the input URL.
	URL string
}

Target is a richer-input target that this experiment should measure.

func (*Target) Category added in v3.31.0

func (t *Target) Category() string

Category implements model.ExperimentTarget.

func (*Target) Country added in v3.31.0

func (t *Target) Country() string

Country implements model.ExperimentTarget.

func (*Target) Input added in v3.31.0

func (t *Target) Input() string

Input implements model.ExperimentTarget.

func (*Target) Options added in v3.31.0

func (t *Target) Options() []string

Options implements model.ExperimentTarget.

func (*Target) String added in v3.31.0

func (t *Target) String() string

String implements model.ExperimentTarget.

type TestKeys

type TestKeys struct {
	NetworkEvents []*model.ArchivalNetworkEvent             `json:"network_events"`
	Queries       []*model.ArchivalDNSLookupResult          `json:"queries"`
	TCPConnects   []*model.ArchivalTCPConnectResult         `json:"tcp_connects"`
	TLSHandshakes []*model.ArchivalTLSOrQUICHandshakeResult `json:"tls_handshakes"`
}

TestKeys contains echcheck test keys.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL