Documentation
¶
Overview ¶
Package dnsping is the experimental dnsping experiment.
See https://github.com/ooni/spec/blob/master/nettests/ts-035-dnsping.md.
Index ¶
Constants ¶
This section is empty.
Variables ¶
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 v0.37.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 *dnsping.Config.
Types ¶
type Config ¶
type Config struct {
// Delay is the delay between each repetition (in milliseconds).
Delay int64 `json:"delay,omitempty" ooni:"number of milliseconds to wait before sending each ping"`
// Domains is the space-separated list of domains to measure.
Domains string `json:"domains,omitempty" ooni:"space-separated list of domains to measure"`
// Repetitions is the number of repetitions for each ping.
Repetitions int64 `json:"repetitions,omitempty" ooni:"number of times to repeat the measurement"`
}
Config contains the experiment configuration.
type Measurer ¶
type Measurer struct{}
Measurer performs the measurement.
func (*Measurer) ExperimentName ¶
ExperimentName implements ExperimentMeasurer.ExperiExperimentName.
func (*Measurer) ExperimentVersion ¶
ExperimentVersion implements ExperimentMeasurer.ExperimentVersion.
type SinglePing ¶
type SinglePing struct {
Query *model.ArchivalDNSLookupResult `json:"query"`
DelayedResponses []*model.ArchivalDNSLookupResult `json:"delayed_responses"`
}
SinglePing contains the results of a single ping.
type Target ¶ added in v0.37.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 v0.37.0
Category implements model.ExperimentTarget.
func (*Target) Country ¶ added in v0.37.0
Country implements model.ExperimentTarget.
func (*Target) Input ¶ added in v0.37.0
Input implements model.ExperimentTarget.
func (*Target) Options ¶ added in v0.37.0
Options implements model.ExperimentTarget.
func (*Target) String ¶ added in v0.37.0
String implements model.ExperimentTarget.
type TestKeys ¶
type TestKeys struct {
Pings []*SinglePing `json:"pings"`
// contains filtered or unexported fields
}
TestKeys contains the experiment results.